
Conectar no Aplicações próprias
Sua aplicação falando MCP direto com o NewAlgorithm — TypeScript, Python ou HTTP puro.
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
TypeScript — SDK oficial
Instale com npm install @modelcontextprotocol/sdk e conecte:
TypeScriptimport { 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
Python — SDK oficial
Instale com pip install mcp e use o cliente Streamable HTTP:
Pythonimport 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
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
Os parâmetros das ferramentas
É o contrato completo — nenhuma outra ferramenta é exposta.
Assinaturasna_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.