← Todas as conexões

Conectar no Amazon Q Developer

Amazon Q Developer — CLI e extensão de IDE, configurados pelo mcp.json.

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

    Escolha o alcance da configuração

    O Amazon Q lê dois arquivos: um global, que vale em qualquer pasta, e um por workspace. Prefira o global para a chave não encostar no repositório.

    Onde fica o arquivo
    Global:     ~/.aws/amazonq/mcp.json
    Workspace:  .amazonq/mcp.json
  3. 3

    Declare o servidor NewAlgorithm

    Nas versões que já suportam transporte HTTP nativo, o servidor remoto é declarado direto pela URL:

    ~/.aws/amazonq/mcp.json
    {
      "mcpServers": {
        "NewAlgorithm-TOTVS": {
          "type": "http",
          "url": "https://totvs.mcp.newalgorithm.io/mcp",
          "headers": {
            "Authorization": "Bearer na_live_xxxxxxxxxxxxxxxxx"
          }
        }
      }
    }
  4. 4

    Se a sua versão só aceitar stdio

    Use a ponte mcp-remote — do ponto de vista do agente o resultado é idêntico. Requer Node.js instalado.

    ~/.aws/amazonq/mcp.json (alternativa)
    {
      "mcpServers": {
        "NewAlgorithm-TOTVS": {
          "command": "npx",
          "args": [
            "-y", "mcp-remote", "https://totvs.mcp.newalgorithm.io/mcp",
            "--header", "Authorization: Bearer na_live_xxxxxxxxxxxxxxxxx"
          ]
        }
      }
    }
  5. 5

    Confirme pelo CLI

    q mcp list

    Esperado: NewAlgorithm-TOTVS

  6. 6

    E dentro do chat

    Na sessão do q chat, o comando abaixo lista as ferramentas carregadas de cada servidor.

    /tools

    Esperado: na_prepare, na_search, na_route, na_specialists, na_version

A extensão do Amazon Q para VS Code e JetBrains lê o mesmo mcp.json do CLI — configurar uma vez vale para as duas. Reinicie o q chat depois de editar o arquivo: os servidores são carregados na inicialização.

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