VS Code + Copilot — Setup MCP Vault

GitHub Copilot no VS Code suporta MCP em agent mode (Copilot Chat). Requer VS Code 1.99+ e Copilot com agent mode habilitado.

Passo 1 — Habilita agent mode

Settings (Ctrl+,) → pesquisa chat.agent.enabled → liga. Reinicia VS Code.

Passo 2 — Config MCP

Dois escopos possíveis:

Escopo user (global)

Ctrl+Shift+P → MCP: Open User Configuration → adiciona:

{
  "servers": {
    "vault": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:\\Users\\<SEU_USER>\\kodama-vault"
      ]
    }
  }
}

Linux/macOS: troca o path por /home/<user>/kodama-vault ou ~/kodama-vault.

Escopo workspace (só no projeto)

Cria .vscode/mcp.json na raiz do projeto com o mesmo JSON acima. Não commita se o path é pessoal.

Passo 3 — Inicia server

Ctrl+Shift+P → MCP: List Servers → seleciona vault → Start.

Status deve virar Running. Se falhar, checa Output panel → dropdown MCP: vault.

Passo 4 — Usa no Copilot Chat

1. Abre Copilot Chat (Ctrl+Alt+I)
2. Seleciona modo Agent no dropdown (não Ask/Edit)
3. Clica no ícone 🔧 (tools) → confirma que tools do vault estão listadas
4. Pergunta: "lista o conteúdo de brain/ no vault"

O agent chama list_directory automático.

Tools disponíveis

read_file, write_file, edit_file, list_directory, directory_tree, search_files, move_file, create_directory, get_file_info.

Troubleshooting

• Server não inicia: confirma node -v ≥ 20 e npx no PATH
• Tools não aparecem: clica ícone 🔧, marca tools do vault manualmente
• Path com espaço (Windows): usa aspas duplas escapadas no JSON
• Agent mode indisponível: update VS Code + Copilot extension

Ver também

• setup/index — overview
• setup/claude-code — mesma config pro Claude Code CLI