← Todas as conexões

Conectar no n8n

n8n — o NewAlgorithm como ferramenta de um AI Agent dentro do seu fluxo.

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

    Crie a credencial de autenticação

    Em Credentials → New, escolha Header Auth. No nome do cabeçalho use Authorization e, no valor, Bearer seguido da sua chave. A credencial fica criptografada no n8n.

    Header Auth
    Name:  Authorization
    Value: Bearer na_live_xxxxxxxxxxxxxxxxx
  3. 3

    Monte o fluxo com um AI Agent

    Adicione o nó AI Agent e conecte um modelo de linguagem a ele. É o agente que decide quando consultar o NewAlgorithm.

  4. 4

    Acrescente o MCP Client Tool

    Na entrada de ferramentas do AI Agent, adicione o nó MCP Client Tool e configure o endpoint, o transporte e a credencial criada no primeiro passo.

    MCP Client Tool
    Endpoint:          https://totvs.mcp.newalgorithm.io/mcp
    Server Transport:  HTTP Streamable
    Authentication:    Header Auth (credencial criada acima)
    Tools to Include:  All
  5. 5

    Oriente o agente no system prompt

    Sem instrução, o agente pode responder de memória. Diga explicitamente para consultar o NewAlgorithm antes de afirmar qualquer coisa sobre SAP.

    Consulte o NewAlgorithm (na_search) antes de responder sobre SAP. Deixe o Manager Agent escolher o Specialist e cite a evidência retornada.
  6. 6

    Execute e confirme

    Rode o fluxo com uma pergunta real. Abra a saída do nó MCP Client Tool: ela mostra a chamada feita e a evidência devolvida pelo NewAlgorithm.

    Esperado: na_prepare, na_search, na_route, na_specialists, na_version

Em n8n self-hosted, garanta que a instância tenha saída HTTPS para mcp.newalgorithm.io — em redes corporativas fechadas esse é o motivo mais comum de o nó falhar na conexão.

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