
Conectar no Amazon Q Developer
Amazon Q Developer — CLI e extensão de IDE, configurados pelo mcp.json.
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
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 arquivoGlobal: ~/.aws/amazonq/mcp.json Workspace: .amazonq/mcp.json - 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
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
Confirme pelo CLI
q mcp listEsperado: NewAlgorithm-TOTVS
- 6
E dentro do chat
Na sessão do q chat, o comando abaixo lista as ferramentas carregadas de cada servidor.
/toolsEsperado: 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.