Adicionar servidores MCP ao VS Code (GitHub Copilot)

VS Code lê .vscode/mcp.json no workspace, um mcp.json no perfil de usuário ou os novos arquivos portáteis .mcp.json.

macOS

User profile mcp.json (open via 'MCP: Open User Configuration'); portable: ~/.copilot/mcp-config.json

Windows

User profile mcp.json (open via 'MCP: Open User Configuration'); portable: ~/.copilot/mcp-config.json

Linux

User profile mcp.json (open via 'MCP: Open User Configuration'); portable: ~/.copilot/mcp-config.json

Arquivo do projeto

.vscode/mcp.json (key 'servers') or portable .mcp.json (key 'mcpServers')

Chave de nível superior

servers

Formato

json

OAuth para servidores remotos

●Sim

Exemplo de configuração

Este exemplo adiciona o servidor hospedado do GitHub e o Playwright como servidor local, no formato esperado por este cliente.

{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

code --add-mcp '{"name":"github","type":"http","url":"https://api.githubcopilot.com/mcp/"}'
code --add-mcp '{"name":"playwright","command":"npx","args":["@playwright/mcp@latest"]}'

Observações e particularidades

• .vscode/mcp.json usa a chave servers; os arquivos portáteis .mcp.json e ~/.copilot/mcp-config.json usam mcpServers.
• Um array inputs no nível superior solicita os segredos, mantendo as chaves fora do arquivo.
• O fluxo guiado Add server agora marca .vscode/mcp.json e o arquivo do perfil de usuário como obsoletos e recomenda os arquivos portáteis. Ambos ainda funcionam.
• VS Code também detecta servidores já configurados para Claude Desktop, Copilot CLI, Cursor e Windsurf.
• code --add-mcp adiciona um servidor a partir de uma string JSON.

Criar uma configuração do VS Code (GitHub Copilot) →

Outros clientes