Pular para o conteúdo
Soluções MCP

Cliente MCP · Microsoft

Como configurar MCP no VS Code

Visual Studio Code com GitHub Copilot em modo agente. Usa .vscode/mcp.json, com a chave "servers" e entradas que pedem a credencial na hora. O bloco abaixo sai no formato deste cliente, sem pedir token.

Conferido em . Formato lido em code.visualstudio.com — Use MCP servers in VS Code

Passo 1Escolha os servidores

Quem mantém

1 selecionado: Filesystem. Ver o catálogo com os sinais de confiança

Passo 2Informe o seu sistema

Sistema
Onde instalar

Passo 3Copie a configuração para o VS Code

Nenhum token passou por este site. O que está destacado você preenche na sua máquina; o gerador não tem campo para credencial.

mcp.json.vscode/mcp.json
{
  "servers": {
    "filesystem": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "<PASTA_PERMITIDA>"
      ]
    }
  }
}

Preencha na sua máquina

  • PASTA_PERMITIDACaminho absoluto da pasta que o assistente poderá ler e alterar (Filesystem)Ex.: /Users/voce/Documentos/projeto ou C:\Users\voce\Documentos\projeto. Só essa pasta fica acessível.Substitua <PASTA_PERMITIDA> pelo valor, direto no arquivo, na sua máquina.

Onde colar

  1. Crie o arquivo .vscode/mcp.json na raiz do projeto e cole o bloco. No modo usuário, rode MCP: Open User Configuration na paleta de comandos.
  2. Ao salvar, o editor mostra a ação Start acima de cada servidor. Clique para iniciar.
  3. Quando o VS Code pedir, digite cada credencial na caixa que aparece no topo da janela.

Antes de começar

Como conferir

  • No chat do Copilot em modo agente, abra o seletor de ferramentas: as ferramentas do servidor aparecem agrupadas pelo nome dele.

Onde fica a configuração

ModoSistemaCaminho
Workspace (.vscode/mcp.json)macOS, Windows, Linux.vscode/mcp.json
Usuário (todos os workspaces)macOS, Windows, Linuxmcp.json do perfil (MCP: Open User Configuration)
Workspace (.vscode/mcp.json)
Vale só neste projeto e pode ser versionado.
Usuário (todos os workspaces)
Abra com o comando MCP: Open User Configuration e cole o mesmo conteúdo.

Passo a passo

  1. Crie o arquivo .vscode/mcp.json na raiz do projeto e cole o bloco. No modo usuário, rode MCP: Open User Configuration na paleta de comandos.
  2. Ao salvar, o editor mostra a ação Start acima de cada servidor. Clique para iniciar.
  3. Quando o VS Code pedir, digite cada credencial na caixa que aparece no topo da janela.

Como conferir

  • No chat do Copilot em modo agente, abra o seletor de ferramentas: as ferramentas do servidor aparecem agrupadas pelo nome dele.

Tokens e chaves neste cliente

O VS Code tem "inputs": na primeira vez que o servidor inicia, ele pede o valor em uma caixa de senha e guarda de forma segura. O gerador cria um input para cada credencial, e o arquivo nunca contém o segredo.

Particularidades

  • A chave raiz é "servers", e não "mcpServers". Colar a configuração de outro cliente sem trocar a chave não funciona.
  • Todo servidor declara "type": "stdio" para processos locais, "http" para remotos.
  • A documentação recomenda nomes em camelCase, sem espaços; o gerador converte (brave-search vira braveSearch).
  • O VS Code também lê um .mcp.json na raiz, no formato portátil com "mcpServers".

Quando não funciona

Quer trocar uma credencial já digitada
Remova o valor salvo do input pelo comando de MCP que lista servidores e inicie o servidor de novo.
Servidor falha ao iniciar
Abra a saída do servidor pela ação que aparece acima da entrada no mcp.json; o erro do processo fica ali.

Outros clientes

Perguntas frequentes

Onde fica a configuração de MCP do VS Code?

Em .vscode/mcp.json.

Como informo tokens e chaves no VS Code?

O VS Code tem "inputs": na primeira vez que o servidor inicia, ele pede o valor em uma caixa de senha e guarda de forma segura. O gerador cria um input para cada credencial, e o arquivo nunca contém o segredo.

Como sei que o servidor conectou no VS Code?

No chat do Copilot em modo agente, abra o seletor de ferramentas: as ferramentas do servidor aparecem agrupadas pelo nome dele.

De onde vem este formato?

Da documentação oficial (code.visualstudio.com — Use MCP servers in VS Code), lida em 03/10/2026. O JSON que o gerador produz para este cliente é fixado por teste automatizado.

Continue por aqui