← Todas as conexões

Conectar no GitLab Duo

GitLab Duo Agent Platform — MCP no chat agêntico e nas extensões de IDE.

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 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. 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 chave
    na_live_xxxxxxxxxxxxxxxxx
  3. 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. 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. 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. 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.