Vercel AI SDK

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

Como conectar

O endpoint é sempre o mesmo. O que muda de sistema para sistema é só onde a configuração entra.

1
Gere sua SEA API Key
Entre em searchitect.pro com sua conta, vá em Minha Conta → SEA API Keys e gere uma chave. Ela aparece uma única vez: copie e guarde em local seguro.
Formato da chave
sea_live_xxxxxxxxxxxxxxxxx
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
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
SEA_API_KEY=sea_live_xxxxxxxxxxxxxxxxx

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 sea = await createMCPClient({
  transport: new StreamableHTTPClientTransport(new URL("https://mcp.searchitect.pro/mcp"), {
    requestInit: {
      headers: { Authorization: `Bearer ${process.env.SEA_API_KEY}` },
    },
  }),
})

try {
  const { text } = await generateText({
    model: anthropic("claude-opus-5"),
    tools: await sea.tools(),
    stopWhen: stepCountIs(5),
    system: "Consulte o SEA antes de responder sobre Sankhya. Use expert=\"auto\".",
    prompt: "Como é feito o rateio de centro de custo no Sankhya?",
  })
  console.log(text)
} finally {
  await sea.close()
}

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 sea.tools()))
Esperado
```
[ 'sea_search', 'sea_route', 'sea_experts', 'sea_version' ]
```

Feche o cliente ao fim da requisição (sea.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.

Precisa da chave? Ela é exibida uma única vez ao ser gerada, e pode ser rotacionada ou revogada a qualquer momento.

Gerar minha API Key

Caso de uso

Embutir o especialista no produto que você vende

A situação

Sua aplicação já tem um assistente, e ele é genérico justamente no assunto em que precisaria ser bom.

O que você pede no Vercel AI SDK

Conecte as ferramentas do SEA ao assistente da aplicação e deixe o modelo decidir quando consultá-las.

O que volta

O assistente do seu produto passa a responder sobre Sankhya com a mesma evidência dos Experts, sem você manter base de conhecimento própria sobre o ERP.

Teste se está funcionando

Primeiro um teste explícito, para confirmar que a ferramenta responde:

Use o SEA - Systems Enterprise Architect para analisar CRUDServiceProvider.loadRecords no Sankhya. Consulte o SEA antes de responder.

Depois o teste real, sem mencionar o SEA nem o Expert esperado. A ideia é verificar se o agente decide consultar o SEA automaticamente: ele deve chamar o servidor por conta própria, receber o roteamento do Core e responder com a evidência do Specialist.

Preciso consultar registros no Sankhya usando CRUDServiceProvider.loadRecords, retornando apenas alguns campos e aplicando critérios. Como devo estruturar essa chamada?

Deu 401 Unauthorized?

Confira, nesta ordem:

A chave foi copiada inteira, sem espaços nas pontas.
A chave não foi revogada nem rotacionada depois de configurada.
Sua conta Searchitect está ativa.
O acesso MCP está habilitado para a conta (mcp_enabled).
A chave não expirou.
O cliente realmente está enviando o header Authorization: Bearer.
No Claude web: o aplicativo não foi desconectado em Minha Conta → SEA API Keys. Se foi, refaça a conexão pelo próprio Claude.

Chaves revogadas e contas bloqueadas param de funcionar imediatamente. Se a chave se perdeu, rotacione-a em SEA API Keys — a antiga é invalidada na hora.

Conectar também

Não é esse o sistema que você usa?

Ver todas as conexões

Como conectar

Gere sua SEA API Key

Instale as dependências

Guarde a chave no ambiente

Conecte e carregue as ferramentas

Confirme

Caso de uso

Teste se está funcionando

Deu 401 Unauthorized?

Conectar também