Croma expone cada fuente de datos como una herramienta mediante el Model
Context Protocol (MCP), servido sobre
Streamable HTTP en:
Cualquier cliente MCP puede conectarse. Los clientes interactivos (Claude,
ChatGPT, Cursor) usan el flujo de OAuth, pero para tu propio código te
autenticas con la misma llave de API que la API REST: envíala como token
bearer y las herramientas se ejecutan con el alcance de tu organización,
compartiendo los mismos límites de tasa y uso.
Úsalo desde el AI SDK
El AI SDK puede cargar las herramientas de Croma
directamente y entregárselas a un modelo para llamadas a herramientas. Envía tu
llave en el encabezado Authorization del transporte:
Trata la llave como un secreto: cárgala desde una variable de entorno o un
gestor de secretos, nunca la subas al repositorio y cierra el cliente
(mcp.close()) cuando termines para liberar la conexión.
Nombres de las herramientas
Las herramientas se nombran según su fuente, con guiones bajos en lugar de
guiones, por ejemplo policia_criminal_records, rues_entity_by_nit y
rama_judicial_cases_by_radicado. Llama a mcp.tools() para listar el conjunto
completo con sus esquemas de entrada, o revisa la referencia de la
API para los campos que acepta cada una.
Las consultas asíncronas siempre esperan en línea sobre MCP:
la llamada a la herramienta devuelve el resultado terminado, sin 202, polling
ni callbacks.
Cualquier cliente MCP
El AI SDK es una opción. Como el endpoint habla MCP estándar sobre Streamable
HTTP, el
SDK oficial de MCP para TypeScript,
LangChain y otros frameworks compatibles con MCP se conectan de la misma forma:
apúntalos a https://api.croma.run/mcp y define el encabezado
Authorization: Bearer.