← Todas as conexões

Conectar no Vercel AI SDK

Vercel AI SDK — as ferramentas do NewAlgorithm carregadas direto no seu agente TypeScript.

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

    Instale as dependências

    O cliente MCP do AI SDK usa o transporte oficial do protocolo:

    npm install ai @ai-sdk/anthropic @modelcontextprotocol/sdk
  3. 3

    Guarde a chave no ambiente

    Em .env.local (e nas variáveis de ambiente do projeto na Vercel). Sem prefixo NEXT_PUBLIC_ — a chave nunca pode ir para o bundle do navegador.

    .env.local
    NA_API_KEY=na_live_xxxxxxxxxxxxxxxxx
  4. 4

    Conecte e carregue as ferramentas

    O cliente devolve as ferramentas já no formato que generateText e streamText esperam:

    app/api/chat/route.ts
    import { anthropic } from "@ai-sdk/anthropic"
    import { experimental_createMCPClient as createMCPClient, generateText, stepCountIs } from "ai"
    import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
    
    const na = await createMCPClient({
      transport: new StreamableHTTPClientTransport(new URL("https://totvs.mcp.newalgorithm.io/mcp"), {
        requestInit: {
          headers: { Authorization: `Bearer ${process.env.NA_API_KEY}` },
        },
      }),
    })
    
    try {
      const { text } = await generateText({
        model: anthropic("claude-opus-5"),
        tools: await na.tools(),
        stopWhen: stepCountIs(5),
        system: "Consulte o NewAlgorithm antes de responder sobre SAP. Deixe o Manager Agent escolher o Specialist.",
        prompt: "Como é feito o rateio de centro de custo no SAP S/4HANA?",
      })
      console.log(text)
    } finally {
      await na.close()
    }
  5. 5

    Confirme

    Antes de plugar no agente, imprima a lista de ferramentas — é o teste mais rápido de que a chave e o endpoint estão certos.

    console.log(Object.keys(await na.tools()))

    Esperado: [ 'na_search', 'na_route', 'na_specialists', 'na_version' ]

Feche o cliente ao fim da requisição (na.close()) para não vazar conexões em ambiente serverless. Em versões 4.x do AI SDK, troque stopWhen: stepCountIs(5) por maxSteps: 5.

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