
Conectar no VS Code
VS Code com GitHub Copilot em modo agente — MCP nativo pelo mcp.json.
Qual MCP você vai conectar? Os comandos abaixo mudam conforme a escolha.
- 1
Confirme a versão do VS Code
O suporte nativo a MCP chegou no VS Code 1.102. Em Ajuda → Sobre, confira que a versão é 1.102 ou superior e atualize se for mais antiga.
- 2
Ative o modo agente do Copilot
Abra o Chat (Ctrl + Alt + I) e troque o seletor de modo para Agent. É o modo que enxerga as ferramentas de MCP.
- 3
Gere sua chave de API
Entre em app.newalgorithm.io com sua conta, abra Chaves e apps e gere uma chave. Ela aparece uma única vez: copie e guarde em local seguro.
Formato da chavena_live_xxxxxxxxxxxxxxxxx - 4
Adicione o servidor
Na paleta de comandos (Ctrl + Shift + P), execute o comando abaixo e escolha HTTP; o VS Code pergunta a URL e cria o arquivo de configuração.
MCP: Add Server - 5
Ou escreva a configuração direto
Para valer em todos os projetos, use MCP: Open User Configuration. Para valer só neste repositório, crie .vscode/mcp.json:
.vscode/mcp.json{ "servers": { "NewAlgorithm-TOTVS": { "type": "http", "url": "https://totvs.mcp.newalgorithm.io/mcp", "headers": { "Authorization": "Bearer na_live_xxxxxxxxxxxxxxxxx" } } } } - 6
Inicie e confirme
Use o botão Start que aparece acima do bloco do servidor no mcp.json, ou rode MCP: List Servers para ver o estado da conexão.
Esperado: NewAlgorithm-TOTVS — Running
- 7
Verifique as ferramentas
No Chat em modo Agent, abra o seletor de ferramentas (ícone de ferramenta). As cinco na_* devem estar listadas e marcadas.
O .vscode/mcp.json fica dentro do repositório: se for versionar o arquivo, troque a chave por um input do próprio VS Code ("inputs" com "type": "promptString" e "password": true) em vez de deixar o Bearer em texto puro.
Detalhes de autenticação e ferramentas na Documentação.