
Conectar no GitHub Copilot (agente)
GitHub Copilot cloud agent — MCP configurado nas Settings do repositório. Suporte a servidores remotos a confirmar.
Qual MCP você vai conectar? Os comandos abaixo mudam conforme a escolha.
- 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 chavena_live_xxxxxxxxxxxxxxxxx - 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 secretCOPILOT_MCP_NA_API_KEYEsperado: No valor, cole a chave de API. Ela fica no cofre do repositório e nunca aparece no JSON.
- 3
Abra a configuração de MCP
Ainda em Settings, na barra lateral em “Code, planning, and automation”: Copilot → MCP servers.
- 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
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
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.