← Todas as conexões

Conectar no Aplicações próprias

Sua aplicação falando MCP direto com o NewAlgorithm — TypeScript, Python ou HTTP puro.

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

    TypeScript — SDK oficial

    Instale com npm install @modelcontextprotocol/sdk e conecte:

    TypeScript
    import { Client } from "@modelcontextprotocol/sdk/client/index.js"
    import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
    
    const transport = new StreamableHTTPClientTransport(new URL("https://totvs.mcp.newalgorithm.io/mcp"), {
      requestInit: {
        headers: { Authorization: `Bearer ${process.env.NA_API_KEY}` },
      },
    })
    
    const client = new Client({ name: "minha-aplicacao", version: "1.0.0" })
    await client.connect(transport)
    
    const resultado = await client.callTool({
      name: "na_search",
      arguments: { query: "rateio de centro de custo", specialist: "auto", limit: 3 },
    })
  3. 3

    Python — SDK oficial

    Instale com pip install mcp e use o cliente Streamable HTTP:

    Python
    import os
    from mcp import ClientSession
    from mcp.client.streamable_http import streamablehttp_client
    
    headers = {"Authorization": f"Bearer {os.environ['NA_API_KEY']}"}
    
    async with streamablehttp_client("https://totvs.mcp.newalgorithm.io/mcp", headers=headers) as (ler, escrever, _):
        async with ClientSession(ler, escrever) as sessao:
            await sessao.initialize()
            resultado = await sessao.call_tool(
                "na_search",
                {"query": "rateio de centro de custo", "specialist": "auto", "limit": 3},
            )
  4. 4

    HTTP puro — para conferir a credencial

    Útil para testar a chave antes de escrever qualquer código. O cabeçalho Accept com os dois tipos é exigido pelo transporte Streamable HTTP:

    curl -X POST https://totvs.mcp.newalgorithm.io/mcp \
      -H "Authorization: Bearer na_live_xxxxxxxxxxxxxxxxx" \
      -H "Content-Type: application/json" \
      -H "Accept: application/json, text/event-stream" \
      -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

    Esperado: na_prepare, na_search, na_route, na_specialists, na_version

  5. 5

    Os parâmetros das ferramentas

    É o contrato completo — nenhuma outra ferramenta é exposta.

    Assinaturas
    na_search(query: str, specialist: str = "auto", limit: int = 3)
    na_route(query: str)
    na_specialists()
    na_version()

Uma chave por aplicação, não uma chave para todas: assim dá para revogar uma integração sem derrubar as outras. Toda chamada sai do seu servidor — chave em cliente é chave vazada.

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