← Todas as conexões

Conectar no GitHub Copilot CLI

GitHub Copilot CLI — o copilot no terminal, com MCP por comando ou por arquivo.

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

    Instale o Copilot CLI

    Requer Node.js 22 ou superior. Pelo npm, em qualquer sistema:

    npm install -g @github/copilot

    Esperado: No Windows também há winget install GitHub.Copilot; no macOS e Linux, brew install --cask copilot-cli.

  2. 2

    Abra e faça login

    Rode copilot no terminal. Na primeira execução, use /login para entrar com sua conta GitHub.

    copilot
  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 NewAlgorithm

    Direto do terminal, sem entrar na sessão interativa, trocando SUA_CHAVE pela chave gerada:

    copilot mcp add --transport http --header "Authorization: Bearer SUA_CHAVE" NewAlgorithm-TOTVS https://totvs.mcp.newalgorithm.io/mcp

    Esperado: O servidor é gravado na configuração do seu usuário, em ~/.copilot/mcp-config.json, e passa a valer em qualquer pasta.

  5. 5

    Ou escreva a configuração direto

    Mesmo resultado, útil para revisar ou versionar por projeto (.mcp.json ou .github/mcp.json na raiz do repositório):

    ~/.copilot/mcp-config.json
    {
      "mcpServers": {
        "NewAlgorithm-TOTVS": {
          "type": "http",
          "url": "https://totvs.mcp.newalgorithm.io/mcp",
          "headers": {
            "Authorization": "Bearer na_live_xxxxxxxxxxxxxxxxx"
          },
          "tools": ["*"]
        }
      }
    }
  6. 6

    Confirme

    Pelo terminal, listando todas as origens de configuração:

    copilot mcp list

    Esperado: NewAlgorithm-TOTVS http https://totvs.mcp.newalgorithm.io/mcp

  7. 7

    Ou dentro da sessão

    Na sessão interativa, /mcp show lista os servidores e o estado de cada um; /mcp add abre o formulário para cadastrar outro sem sair do terminal.

    /mcp show

O mcp-config.json do usuário fica fora do repositório — é o lugar certo para a chave. Se optar pelo .mcp.json do projeto, ele é versionado junto com o código: nunca deixe o Bearer em texto puro ali.

Detalhes de autenticação e ferramentas na Documentação.