← Todas as conexões

Conectar no VS Code

VS Code com GitHub Copilot em modo agente — MCP nativo pelo mcp.json.

Antes de começar, crie a sua conta gratuita.Criar conta

Qual MCP você vai conectar? Os comandos abaixo mudam conforme a escolha.

  1. 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. 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. 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 chave
    na_live_xxxxxxxxxxxxxxxxx
  4. 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. 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. 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. 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.