Skip to main content
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.