← Todas as conexões

Conectar no GitHub Copilot (agente)

GitHub Copilot cloud agent — MCP configurado nas Settings do repositório. Suporte a servidores remotos a confirmar.

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

    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
  2. 2

    Guarde a chave como secret do repositório

    No repositório: Settings → Secrets and variables → Agents → aba Secrets → New repository secret. O nome precisa começar com COPILOT_MCP_ — só secrets com esse prefixo chegam à configuração de MCP.

    Nome do secret
    COPILOT_MCP_NA_API_KEY

    Esperado: No valor, cole a chave de API. Ela fica no cofre do repositório e nunca aparece no JSON.

  3. 3

    Abra a configuração de MCP

    Ainda em Settings, na barra lateral em “Code, planning, and automation”: Copilot → MCP servers.

  4. 4

    Declare o servidor NewAlgorithm

    Para servidores remotos, o Copilot exige type, url e tools; headers é onde entra a autenticação, com o secret referenciado por $NOME.

    Configuração MCP do repositório
    {
      "mcpServers": {
        "NewAlgorithm-TOTVS": {
          "type": "http",
          "url": "https://totvs.mcp.newalgorithm.io/mcp",
          "tools": ["na_prepare", "na_search", "na_route", "na_specialists", "na_version"],
          "headers": {
            "Authorization": "Bearer $COPILOT_MCP_NA_API_KEY"
          }
        }
      }
    }
  5. 5

    Salve

    O GitHub valida a sintaxe antes de gravar. Se a configuração não for salva, é o JSON que está inválido — confira vírgulas e aspas.

  6. 6

    Confirme na primeira tarefa

    Atribua uma issue ao Copilot ou peça uma mudança pelo Agents. Na sessão do agente, o log de inicialização lista os servidores MCP carregados e as ferramentas na_* liberadas.

    Esperado: NewAlgorithm-TOTVS na_prepare, na_search, na_route, na_specialists, na_version

Vale para o repositório onde foi configurado — em organizações, dá para definir a mesma configuração no nível da organização e herdar em todos os repositórios. O campo tools é obrigatório em servidores remotos: se preferir liberar tudo de uma vez, use ["*"] no lugar da lista.

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