Como configurar MCP no VS Code

O VS Code passou a suportar MCP de forma integrada, o que muda a experiência: em vez de editar um arquivo de configuração às cegas, você tem a descoberta e o gerenciamento de servidores dentro do próprio editor.

Escopo: usuário ou workspace

A configuração pode viver em dois níveis, e a escolha tem as mesmas implicações de segurança dos outros clientes:

• Nível de usuário: vale para todos os projetos abertos na sua máquina. Use para ferramentas de uso geral.
• Nível de workspace: vale apenas para o projeto atual e pode ser versionada. Use para servidores específicos daquele código.

A vantagem do nível de workspace é que a configuração viaja com o repositório: quem entrar no projeto depois tem o mesmo ambiente. A desvantagem é o risco de vazar credencial no versionamento — nunca coloque token em configuração de workspace.

Formato da configuração

A estrutura é a mesma do restante do ecossistema, com o bloco `servers`:

{
  "servers": {
    "arquivos-do-projeto": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/caminho/do/projeto"
      ]
    }
  }
}

Segredos: use entrada de variável

Um recurso útil do VS Code é pedir o valor de um segredo no momento do uso, em vez de guardá-lo em texto no arquivo. Isso reduz muito o risco de vazamento acidental:

{
  "servers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}"
      }
    }
  },
  "inputs": [
    {
      "id": "github_token",
      "type": "promptString",
      "description": "Token de acesso pessoal do GitHub",
      "password": true
    }
  ]
}

Com esse formato, o editor pede o token quando necessário e não o mantém escrito no arquivo. É uma diferença relevante para quem versiona configuração de workspace.

Usando as ferramentas

Depois de configurar, os servidores ficam disponíveis para o Copilot Chat no modo agente. Você pode alternar quais ferramentas estão ativas durante a conversa — e vale fazer isso: manter só as ferramentas relevantes reduz ruído e consumo de contexto.

Como em outros clientes, o modelo decide quando usar uma ferramenta com base na pergunta e na descrição da ferramenta. Se uma ferramenta útil não estiver sendo usada, o problema costuma estar no modo de solicitação (chat simples não usa ferramentas) ou na clareza do pedido.

Problemas comuns

Boas práticas

• Segredos sempre via entrada de variável, nunca em texto no arquivo.
• Configuração de workspace só é versionada se não contiver nenhum segredo.
• Escopo de diretório mínimo nos servidores de arquivos.
• Ative apenas as ferramentas relevantes para a tarefa em andamento.
• Prefira o nível de usuário para ferramentas de uso geral e o nível de workspace para o específico do projeto.