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.

MCPEndereço
TOTVSTOTVShttps://totvs.mcp.newalgorithm.io/mcp
SAPSAPhttps://sap.mcp.newalgorithm.io/mcp
OmieOmiehttps://omie.mcp.newalgorithm.io/mcp
SankhyaSankhyahttps://sankhya.mcp.newalgorithm.io/mcp

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 Specialists

Ferramenta 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 projeto

Para 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 Specialists

O 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 encaminhamento

Diagnó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 estado

Versã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.