
Conectar no GitLab Duo
GitLab Duo Agent Platform — MCP no chat agêntico e nas extensões de IDE.
Qual MCP você vai conectar? Os comandos abaixo mudam conforme a escolha.
- 1
Confirme que o MCP está habilitado
O suporte a MCP no Duo é recente e vem desligado por padrão. No grupo ou projeto: Settings → General → GitLab Duo, e habilite o uso de servidores MCP. Em instâncias self-managed, o administrador precisa liberar antes.
- 2
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 - 3
Declare o servidor NewAlgorithm
O Duo lê a configuração de MCP do repositório. Crie o arquivo abaixo na raiz do projeto:
.gitlab/duo/mcp.json{ "mcpServers": { "NewAlgorithm-TOTVS": { "url": "https://totvs.mcp.newalgorithm.io/mcp", "headers": { "Authorization": "Bearer $NA_API_KEY" } } } }Esperado: Referencie a chave por variável ($NA_API_KEY), nunca em texto puro — este arquivo é versionado junto com o código.
- 4
Cadastre a chave como variável de CI/CD
Em Settings → CI/CD → Variables, crie NA_API_KEY marcada como Masked e Protected. É ela que preenche o header sem expor o segredo no repositório.
- 5
Na IDE, use a extensão GitLab Workflow
Quem trabalha pelo VS Code ou pelo plugin JetBrains configura o mesmo servidor nas preferências da extensão (GitLab Duo → MCP servers). Aí a chave fica na máquina, fora do repositório.
- 6
Confirme no Duo Agentic Chat
Abra o chat agêntico e peça a lista de ferramentas disponíveis. As cinco na_* devem aparecer.
Esperado: na_prepare, na_search, na_route, na_specialists, na_version
O caminho exato dos menus muda entre versões do GitLab e entre SaaS e self-managed, e o recurso depende do tier contratado. Se a sua versão ainda não expõe MCP no Duo, o endpoint continua acessível pela aba Outro cliente.
Detalhes de autenticação e ferramentas na Documentação.