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: agrega Croma a Claude en un clic e inicia sesión con tu cuenta de Croma. 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.

Empieza con la plantilla de chat

Croma Chat Template es un chat open source en Next.js construido sobre este endpoint con el AI SDK y AI Elements: respuestas en streaming, llamadas a herramientas sobre todas las fuentes de Croma, un selector de fuentes por mensaje y límite de uso opcional. Prueba el despliegue en vivo en chat.usecroma.com, o usa el despliegue de un clic en Vercel del repositorio: pide tu CROMA_API_KEY y una llave de modelo y queda listo para usar.

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.