Documentação
Referência dos MCPs
Tudo o que um cliente MCP precisa: endereços, autenticação, ferramentas e limites. Para o passo a passo de cada IA, veja Conexões.
Endereços
Um endereço por MCP. Transporte: Streamable HTTP.
Autenticação
Login com a sua conta (OAuth)
Nos clientes que suportam OAuth (Claude, ChatGPT e outros), basta adicionar o endereço do MCP: o cliente abre a página do NewAlgorithm, você entra e autoriza. O acesso é revogável a qualquer momento no painel, em Chaves e apps.
Chave de API
Nos demais (Cursor, VS Code, Windsurf, Gemini CLI, Codex, n8n…), crie uma chave no painel e envie no cabeçalho Authorization: Bearer <sua chave>. A chave é pessoal: não a coloque em repositório nem em arquivo compartilhado.
- Servidor de autorização
- https://newalgorithm.io
- Metadados
- https://newalgorithm.io/.well-known/oauth-authorization-server
- PKCE
- S256
- Registro dinâmico de cliente
- Sim (Dynamic Client Registration)
Ferramentas
As mesmas em todos os MCPs. Todas são somente leitura.
na_searchConsultar os SpecialistsFerramenta principal. Recebe a pergunta técnica ou funcional (pode incluir a mensagem de erro ou o stack trace inteiro) e devolve a evidência do Specialist escolhido pelo Manager Agent, com o nível de confiança e, quando a pergunta cruza áreas, o apoio de um segundo Specialist.
Quando usar: Sempre que a pergunta for sobre a tecnologia do MCP: processos, configuração, regras fiscais, desenvolvimento, APIs, banco de dados, telas e relatórios.
na_preparePreparar o contexto do projetoPara tarefas sobre o seu próprio projeto (repositório ou documentos que a sua IA acessa): confirma a conexão e devolve os passos para a sua IA montar, na sua máquina, o mapa de contexto do projeto. O NewAlgorithm não recebe o projeto.
Quando usar: Uma vez por conversa, quando a tarefa envolve o material do projeto.
na_specialistsListar os SpecialistsO catálogo de Specialists do MCP, com a área de cada um e a política de evidência comum a todos.
Quando usar: Quando você quer saber o que o MCP cobre.
na_routeVer o encaminhamentoDiagnóstico: mostra para qual Specialist o Manager Agent encaminharia uma pergunta, sem pesquisar.
Quando usar: Só para diagnóstico; não é necessária antes da na_search.
na_versionVersão e estadoVersão do serviço e estado da conexão.
Quando usar: Para conferir se a conexão está funcionando.
Limites
- O MCP entrega conhecimento e evidência; quem escreve a resposta é a sua IA. Confira a solução no seu próprio ambiente, principalmente regra fiscal, configuração e versão.
- As ferramentas são somente leitura: o MCP não acessa os seus sistemas, não executa nada neles e não altera dados.
- O MCP devolve trechos de evidência para a pergunta feita; não exporta documentos inteiros nem a base de conhecimento.
- Quando nenhum Specialist cobre o assunto, o Manager Agent pede esclarecimento ou declara a falta de cobertura, em vez de inventar.
- O uso é gratuito e sem limite de consultas por conta, dentro da política de uso justo. Dúvidas: contato@newalgorithm.io.