A Croma expõe cada fonte de dados como uma ferramenta por meio do Model
Context Protocol (MCP), servido sobre
Streamable HTTP em:
Qualquer cliente MCP pode se conectar. Os clientes interativos (Claude,
ChatGPT, Cursor) usam o fluxo de OAuth, mas para o seu próprio código você se
autentica com a mesma chave de API da API REST: envie-a como token
bearer e as ferramentas são executadas com o escopo da sua organização,
compartilhando os mesmos limites de taxa e uso.
Use a partir do AI SDK
O AI SDK pode carregar as ferramentas da Croma
diretamente e entregá-las a um modelo para chamadas de ferramentas. Envie sua
chave no cabeçalho Authorization do transporte:
Trate a chave como um segredo: carregue-a de uma variável de ambiente ou de um
gerenciador de segredos, nunca a envie ao repositório e feche o cliente
(mcp.close()) quando terminar para liberar a conexão.
Nomes das ferramentas
As ferramentas são nomeadas conforme a sua fonte, com sublinhados em vez de
hifens, por exemplo policia_criminal_records, rues_entity_by_nit e
rama_judicial_cases_by_radicado. Chame mcp.tools() para listar o conjunto
completo com seus esquemas de entrada, ou consulte a referência da
API para os campos que cada uma aceita.
As consultas assíncronas sempre aguardam de forma síncrona sobre MCP:
a chamada da ferramenta retorna o resultado pronto, sem 202, polling
nem callbacks.
Qualquer cliente MCP
O AI SDK é uma opção. Como o endpoint fala MCP padrão sobre Streamable
HTTP, o
SDK oficial de MCP para TypeScript,
o LangChain e outros frameworks compatíveis com MCP se conectam da mesma forma:
aponte-os para https://api.croma.run/mcp e defina o cabeçalho
Authorization: Bearer.