Conecta Claude, ChatGPT, Cursor o cualquier cliente MCP a las fuentes de datos de gobierno de Croma: URL del servidor, autenticación y cada herramienta.
Croma expone cada fuente de datos como una herramienta mediante el Model
Context Protocol (MCP), servido sobre
Streamable HTTP en:
https://api.croma.run/mcp
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.
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:
import { experimental_createMCPClient as createMCPClient, generateText } from "ai";import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";import { anthropic } from "@ai-sdk/anthropic";const mcp = await createMCPClient({ transport: new StreamableHTTPClientTransport( new URL("https://api.croma.run/mcp"), { requestInit: { headers: { Authorization: `Bearer ${process.env.CROMA_API_KEY}` }, }, }, ),});// Cada fuente de datos, expuesta como una herramienta que el modelo puede llamar.const tools = await mcp.tools();const { text } = await generateText({ model: anthropic("claude-opus-4-8"), tools, // Deja que el modelo llame herramientas y luego responda. Consulta la // documentación del AI SDK para la opción de varios pasos en tu versión // (`stopWhen` / `maxSteps`). prompt: "Consulta los antecedentes de la Policía Nacional para la cédula 1234567890.",});await mcp.close();console.log(text);
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.
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.
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.Las herramientas de monitores administran los monitores de la
organización conectada: create_monitor vigila un endpoint de dataset con una
frecuencia y envía por correo lo nuevo; list_monitors, get_monitor,
update_monitor (renombrar, cambiar la consulta, pausar, reanudar), run_monitor,
list_monitor_matches y delete_monitor hacen el resto. Monitores desde
Claude tiene instrucciones que funcionan y lo que el agente
hace con ellas.La herramienta submit_feedback envía un comentario a Croma cuando una herramienta falla,
devuelve un resultado claramente incorrecto o ninguna cubre la fuente que necesitas. Ver
Comentarios.Una fuente que solo responde a una persona con sesión iniciada, como
SUNARP, suma tres herramientas de conexión:
sunarp_connect responde con un enlace seguro donde el usuario ingresa los
datos de su propia cuenta en la consola de Croma, así las credenciales nunca
pasan por la conversación (la cuenta se verifica con la fuente, se cifra al
llegar y nunca se devuelve), sunarp_list_connections muestra
el estado y el cupo diario de cada una y sunarp_delete_connection elimina
una. La DIAN tiene las mismas tres como
dian_muisca_connect, dian_muisca_list_connections y
dian_muisca_delete_connection, y la facturación electrónica DIAN como
dian_facturacion_connect, dian_facturacion_list_connections y
dian_facturacion_delete_connection. Desde entonces las consultas corren solas con las conexiones de la
organización. Las herramientas de monitores y de conexiones son las únicas que
escriben.
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.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Croma API","description":"Build with government data.","colors":{"primary":"#18181b","light":"#fafafa","dark":"#18181b"},"logo":{"light":"https://mintcdn.com/croma/ioi13hN3s-Dcty8-/logo/light.svg?fit=max\u0026auto=format\u0026n=ioi13hN3s-Dcty8-\u0026q=85\u0026s=a4da0b4b29d11b13c5fd3219ead7027b","dark":"https://mintcdn.com/croma/ioi13hN3s-Dcty8-/logo/dark.svg?fit=max\u0026auto=format\u0026n=ioi13hN3s-Dcty8-\u0026q=85\u0026s=c1ebf3bbbe06d4d77db1bb3dd2802508","href":"https://usecroma.com"},"favicon":"https://mintcdn.com/croma/iCQnCBcqUh0vQX4t/favicon.svg?fit=max\u0026auto=format\u0026n=iCQnCBcqUh0vQX4t\u0026q=85\u0026s=00063a47226ac20619a926422d9a254c","appearance":{"default":"system"},"navbar":{"links":[{"href":"https://cal.com/tomas-calle-croma/api-integration?source=docs","label":"Talk to an engineer"}],"primary":{"type":"button","label":"Get API key","href":"https://platform.usecroma.com/sign-up"}},"footer":{"socials":{"website":"https://usecroma.com"}},"fonts":{"heading":{"family":"Ronzino","weight":700,"source":"fonts/Ronzino-Bold.woff","format":"woff"}},"styling":{"eyebrows":"section","codeblocks":"dark","latex":true},"contextual":{"options":["copy"],"display":"header"},"navigation":{"languages":[{"language":"en","default":true,"href":"introduction"},{"language":"es","href":"es/introduction"},{"language":"pt-BR","href":"pt/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"croma","hasAudioNarration":false,"actualSubdomain":"croma","customDomains":["docs.usecroma.com"],"gitSource":{"type":"github","owner":"camilocbarrera","repo":"croma","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aeffb5720a5c82e8b836dea","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"API Reference","count":207},{"language":"default","tag":"Countries","count":197},{"language":"en","tag":"Guides","count":158},{"language":"es","tag":"Guías","count":158},{"language":"pt-BR","tag":"Guias","count":156},{"language":"en","tag":"Countries","count":139},{"language":"es","tag":"Países","count":139},{"language":"pt-BR","tag":"Países","count":139},{"language":"en","tag":"Colombia","count":64},{"language":"es","tag":"Colombia","count":64},{"language":"pt-BR","tag":"Colômbia","count":64},{"language":"default","tag":"Colombia","count":61},{"language":"default","tag":"Courts \u0026 litigation","count":46},{"language":"default","tag":"Chile","count":42},{"language":"default","tag":"Laws \u0026 regulation","count":39},{"language":"en","tag":"Courts \u0026 litigation","count":38},{"language":"es","tag":"Justicia y litigios","count":38},{"language":"pt-BR","tag":"Justiça e litígios","count":38},{"language":"default","tag":"México","count":25},{"language":"en","tag":"Legal API","count":19},{"language":"es","tag":"API Legal","count":19},{"language":"en","tag":"United States","count":18},{"language":"es","tag":"Estados Unidos","count":18},{"language":"pt-BR","tag":"Estados Unidos","count":18},{"language":"default","tag":"Other","count":18},{"language":"default","tag":"El Salvador","count":18},{"language":"default","tag":"Peru","count":18},{"language":"en","tag":"Companies \u0026 tax","count":16},{"language":"en","tag":"Background checks","count":16},{"language":"es","tag":"Empresas e impuestos","count":16},{"language":"es","tag":"Verificación de personas","count":16},{"language":"pt-BR","tag":"Empresas e impostos","count":16},{"language":"pt-BR","tag":"Verificação de pessoas","count":16},{"language":"es","tag":"Primeros pasos","count":14},{"language":"en","tag":"Laws \u0026 regulation","count":13},{"language":"en","tag":"Peru","count":13},{"language":"es","tag":"Leyes y regulación","count":13},{"language":"pt-BR","tag":"Leis e regulação","count":13},{"language":"pt-BR","tag":"Peru","count":13},{"language":"pt-BR","tag":"Chile","count":10}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"nav-logo img,#nav-logo img,.nav-logo img,#navbar img,header a[href] img,img[alt*=\"logo\"i]{height:1rem!important;width:auto!important}#sidebar button[aria-expanded][style*=\"1.75rem\"],#navigation-items button[aria-expanded][style*=\"1.75rem\"]{pointer-events:none!important;font-weight:600!important;color:var(--color-gray-900, #18181b)!important;background:transparent!important}html.dark #sidebar button[aria-expanded][style*=\"1.75rem\"],html.dark #navigation-items button[aria-expanded][style*=\"1.75rem\"]{color:var(--color-gray-100, #f4f4f5)!important}#sidebar button[aria-expanded][style*=\"1.75rem\"] svg,#navigation-items button[aria-expanded][style*=\"1.75rem\"] svg{display:none!important}div:has(>img[src*=\"/flags/\"]){display:none!important}a.nav-tabs-item[href*=\"/legal/\"]{display:none!important}a.dataset-pill{display:inline-block;margin-left:0.25rem;padding:0 0.45rem;border:1px solid var(--color-gray-300, #d4d4d8);border-radius:9999px;font-size:0.675rem;font-weight:600;line-height:1.05rem;letter-spacing:0.03em;text-transform:uppercase;vertical-align:2px;color:var(--color-gray-600, #52525b)!important;background:transparent;text-decoration:none!important;transition:color 0.15s ease, border-color 0.15s ease}a.dataset-pill:hover{color:var(--color-gray-900, #18181b)!important;border-color:var(--color-gray-400, #a1a1aa)}html.dark a.dataset-pill{border-color:var(--color-gray-700, #3f3f46);color:var(--color-gray-400, #a1a1aa)!important}html.dark a.dataset-pill:hover{color:var(--color-gray-100, #f4f4f5)!important;border-color:var(--color-gray-500, #71717a)}"}],"page":{"pagePath":"es/mcp-server","slug":"/es/mcp-server","pageMetadata":{"title":"MCP","description":"Conecta Claude, ChatGPT, Cursor o cualquier cliente MCP a las fuentes de datos de gobierno de Croma: URL del servidor, autenticación y cada herramienta.","href":"/es/mcp-server"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Conecta Claude, ChatGPT, Cursor o cualquier cliente MCP a las fuentes de datos de gobierno de Croma: URL del servidor, autenticación y cada herramienta.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Croma expone cada fuente de datos como una herramienta mediante el `,_jsx(_components.a,{href:`https://modelcontextprotocol.io`,children:`Model\nContext Protocol`}),` (MCP), servido sobre\nStreamable HTTP en:`]}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://api.croma.run/mcp`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`Cualquier cliente MCP puede conectarse. Los clientes interactivos (Claude,\nChatGPT, Cursor) usan el flujo de OAuth:\n`,_jsx(_components.a,{href:`https://claude.ai/new?modal=add-custom-connector\u0026connectorName=Croma%20%7C%20The%20API%20for%20government%20data\u0026connectorUrl=https%3A%2F%2Fapi.croma.run%2Fmcp#settings/customize-connectors`,children:`agrega Croma a Claude en un clic`}),`\ne inicia sesión con tu cuenta de Croma. Para tu propio código te autenticas\ncon la `,_jsx(_components.strong,{children:`misma llave de API que la API REST`}),`: envíala como token bearer y las\nherramientas se ejecutan con el alcance de tu organización, compartiendo los\nmismos `,_jsx(_components.a,{href:`/es/rate-limits`,children:`límites de tasa`}),` y uso.`]}),`\n`,_jsx(Heading,{level:`2`,id:`úsalo-desde-el-ai-sdk`,children:`Úsalo desde el AI SDK`}),`\n`,_jsxs(_components.p,{children:[`El `,_jsx(_components.a,{href:`https://ai-sdk.dev`,children:`AI SDK`}),` puede cargar las herramientas de Croma\ndirectamente y entregárselas a un modelo para llamadas a herramientas. Envía tu\nllave en el encabezado `,_jsx(_components.code,{children:`Authorization`}),` del transporte:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`29`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`29`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:`experimental_createMCPClient`}),_jsx(_components.span,{style:{color:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:` as`}),_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` createMCPClient`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:`generateText`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` \"ai\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:`StreamableHTTPClientTransport`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` \"@modelcontextprotocol/sdk/client/streamableHttp.js\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:`anthropic`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` \"@ai-sdk/anthropic\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#4FC1FF`,\"--shiki-dark\":`#4FC1FF`},children:` mcp`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` = `}),_jsx(_components.span,{style:{color:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:` createMCPClient`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` transport:`}),_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:` StreamableHTTPClientTransport`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:` URL`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"https://api.croma.run/mcp\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`),`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` requestInit:`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:`Authorization:`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:\" `Bearer \"}),_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:`process`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:`env`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#4FC1FF`,\"--shiki-dark\":`#4FC1FF`},children:`CROMA_API_KEY`}),_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` ),`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A9955`,\"--shiki-dark\":`#6A9955`},children:`// Cada fuente de datos, expuesta como una herramienta que el modelo puede llamar.`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#4FC1FF`,\"--shiki-dark\":`#4FC1FF`},children:` tools`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` = `}),_jsx(_components.span,{style:{color:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` mcp`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:`tools`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#4FC1FF`,\"--shiki-dark\":`#4FC1FF`},children:`text`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` } = `}),_jsx(_components.span,{style:{color:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:` generateText`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` model:`}),_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:` anthropic`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"claude-opus-4-8\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`),`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` tools`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A9955`,\"--shiki-dark\":`#6A9955`},children:` // Deja que el modelo llame herramientas y luego responda. Consulta la`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A9955`,\"--shiki-dark\":`#6A9955`},children:` // documentación del AI SDK para la opción de varios pasos en tu versión`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A9955`,\"--shiki-dark\":`#6A9955`},children:\" // (`stopWhen` / `maxSteps`).\"})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` prompt:`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` \"Consulta los antecedentes de la Policía Nacional para la cédula 1234567890.\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` mcp`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:`close`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:`text`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Trata la llave como un secreto: cárgala desde una variable de entorno o un\ngestor de secretos, nunca la subas al repositorio y cierra el cliente\n(`,_jsx(_components.code,{children:`mcp.close()`}),`) cuando termines para liberar la conexión.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`empieza-con-la-plantilla-de-chat`,children:`Empieza con la plantilla de chat`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`https://github.com/croma-ai/croma-chat-template`,children:`Croma Chat Template`}),` es un\nchat open source en Next.js construido sobre este endpoint con el AI SDK y\n`,_jsx(_components.a,{href:`https://ai-sdk.dev/elements`,children:`AI Elements`}),`: respuestas en streaming, llamadas a\nherramientas sobre todas las fuentes de Croma, un selector de fuentes por\nmensaje y límite de uso opcional. Prueba el despliegue en vivo en\n`,_jsx(_components.a,{href:`https://chat.usecroma.com`,children:`chat.usecroma.com`}),`, o usa el despliegue de un clic\nen Vercel del repositorio: pide tu `,_jsx(_components.code,{children:`CROMA_API_KEY`}),` y una llave de modelo y\nqueda listo para usar.`]}),`\n`,_jsx(Heading,{level:`2`,id:`nombres-de-las-herramientas`,children:`Nombres de las herramientas`}),`\n`,_jsxs(_components.p,{children:[`Las herramientas se nombran según su fuente, con guiones bajos en lugar de\nguiones, por ejemplo `,_jsx(_components.code,{children:`policia_criminal_records`}),`, `,_jsx(_components.code,{children:`rues_entity_by_nit`}),` y\n`,_jsx(_components.code,{children:`rama_judicial_cases_by_radicado`}),`. Llama a `,_jsx(_components.code,{children:`mcp.tools()`}),` para listar el conjunto\ncompleto con sus esquemas de entrada, o revisa la `,_jsx(_components.a,{href:`/es/api-reference`,children:`referencia de la\nAPI`}),` para los campos que acepta cada una.`]}),`\n`,_jsxs(_components.p,{children:[`Las `,_jsx(_components.a,{href:`/es/async-jobs`,children:`consultas asíncronas`}),` siempre esperan en línea sobre MCP:\nla llamada a la herramienta devuelve el resultado terminado, sin `,_jsx(_components.code,{children:`202`}),`, polling\nni callbacks.`]}),`\n`,_jsxs(_components.p,{children:[`Las herramientas de monitores administran los `,_jsx(_components.a,{href:`/es/monitors`,children:`monitores`}),` de la\norganización conectada: `,_jsx(_components.code,{children:`create_monitor`}),` vigila un endpoint de dataset con una\nfrecuencia y envía por correo lo nuevo; `,_jsx(_components.code,{children:`list_monitors`}),`, `,_jsx(_components.code,{children:`get_monitor`}),`,\n`,_jsx(_components.code,{children:`update_monitor`}),` (renombrar, cambiar la consulta, pausar, reanudar), `,_jsx(_components.code,{children:`run_monitor`}),`,\n`,_jsx(_components.code,{children:`list_monitor_matches`}),` y `,_jsx(_components.code,{children:`delete_monitor`}),` hacen el resto. `,_jsx(_components.a,{href:`/es/monitors-mcp`,children:`Monitores desde\nClaude`}),` tiene instrucciones que funcionan y lo que el agente\nhace con ellas.`]}),`\n`,_jsxs(_components.p,{children:[`La herramienta `,_jsx(_components.code,{children:`submit_feedback`}),` envía un comentario a Croma cuando una herramienta falla,\ndevuelve un resultado claramente incorrecto o ninguna cubre la fuente que necesitas. Ver\n`,_jsx(_components.a,{href:`/es/feedback`,children:`Comentarios`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Una fuente que solo responde a una persona con sesión iniciada, como\n`,_jsx(_components.a,{href:`/es/guides/peru/sunarp`,children:`SUNARP`}),`, suma tres herramientas de conexión:\n`,_jsx(_components.code,{children:`sunarp_connect`}),` responde con un enlace seguro donde el usuario ingresa los\ndatos de su propia cuenta en la consola de Croma, así las credenciales nunca\npasan por la conversación (la cuenta se verifica con la fuente, se cifra al\nllegar y nunca se devuelve), `,_jsx(_components.code,{children:`sunarp_list_connections`}),` muestra\nel estado y el cupo diario de cada una y `,_jsx(_components.code,{children:`sunarp_delete_connection`}),` elimina\nuna. La `,_jsx(_components.a,{href:`/es/guides/colombia/dian-muisca`,children:`DIAN`}),` tiene las mismas tres como\n`,_jsx(_components.code,{children:`dian_muisca_connect`}),`, `,_jsx(_components.code,{children:`dian_muisca_list_connections`}),` y\n`,_jsx(_components.code,{children:`dian_muisca_delete_connection`}),`, y la `,_jsx(_components.a,{href:`/es/guides/colombia/dian-facturacion`,children:`facturación electrónica DIAN`}),` como\n`,_jsx(_components.code,{children:`dian_facturacion_connect`}),`, `,_jsx(_components.code,{children:`dian_facturacion_list_connections`}),` y\n`,_jsx(_components.code,{children:`dian_facturacion_delete_connection`}),`. Desde entonces las consultas corren solas con las conexiones de la\norganización. Las herramientas de monitores y de conexiones son las únicas que\nescriben.`]}),`\n`,_jsx(Heading,{level:`2`,id:`cualquier-cliente-mcp`,children:`Cualquier cliente MCP`}),`\n`,_jsxs(_components.p,{children:[`El AI SDK es una opción. Como el endpoint habla MCP estándar sobre Streamable\nHTTP, el\n`,_jsx(_components.a,{href:`https://github.com/modelcontextprotocol/typescript-sdk`,children:`SDK oficial de MCP para TypeScript`}),`,\nLangChain y otros frameworks compatibles con MCP se conectan de la misma forma:\napúntalos a `,_jsx(_components.code,{children:`https://api.croma.run/mcp`}),` y define el encabezado\n`,_jsx(_components.code,{children:`Authorization: Bearer`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"MCP","description":"Conecta Claude, ChatGPT, Cursor o cualquier cliente MCP a las fuentes de datos de gobierno de Croma: URL del servidor, autenticación y cada herramienta.","href":"/es/mcp-server"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Úsalo desde el AI SDK","slug":"úsalo-desde-el-ai-sdk","depth":2,"children":[]},{"title":"Empieza con la plantilla de chat","slug":"empieza-con-la-plantilla-de-chat","depth":2,"children":[]},{"title":"Nombres de las herramientas","slug":"nombres-de-las-herramientas","depth":2,"children":[]},{"title":"Cualquier cliente MCP","slug":"cualquier-cliente-mcp","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"croma","siteName":"Croma API","title":"MCP - Croma API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/mcp-server","matchLevel":1},"es":{"href":"/es/mcp-server","matchLevel":0},"pt-BR":{"href":"/pt/mcp-server","matchLevel":1}}},"lastModified":"2026-10-23T22:34:35.906Z","originalFileLocation":"es/mcp-server.mdx","locale":"es"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Conecta Claude, ChatGPT, Cursor o cualquier cliente MCP a las fuentes de datos de gobierno de Croma: URL del servidor, autenticación y cada herramienta.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Croma API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/croma/WB4AmZ7e3PEc7UXM/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/croma/WB4AmZ7e3PEc7UXM/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/croma/WB4AmZ7e3PEc7UXM/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/croma/WB4AmZ7e3PEc7UXM/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/croma/WB4AmZ7e3PEc7UXM/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/croma/WB4AmZ7e3PEc7UXM/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/croma/WB4AmZ7e3PEc7UXM/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/croma/WB4AmZ7e3PEc7UXM/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/croma/WB4AmZ7e3PEc7UXM/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"MCP - Croma API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Conecta Claude, ChatGPT, Cursor o cualquier cliente MCP a las fuentes de datos de gobierno de Croma: URL del servidor, autenticación y cada herramienta.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Croma API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.usecroma.com/es/mcp-server\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://croma.mintlify.site/_mintlify/api/og/v2?division=Primeros+pasos\u0026amp;title=MCP\u0026amp;description=Conecta+Claude%2C+ChatGPT%2C+Cursor+o+cualquier+cliente+MCP+a+las+fuentes+de+datos+de+gobierno+de+Croma%3A+URL+del+servidor%2C+autenticaci%C3%B3n+y+cada+herramienta.\u0026amp;theme=27f398343599ad9c36ebea10\u0026amp;signature=f8bded48a05d3d98135beb81f45c35cdd6802dda964be83dedfd11050e50384a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"MCP - Croma API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Conecta Claude, ChatGPT, Cursor o cualquier cliente MCP a las fuentes de datos de gobierno de Croma: URL del servidor, autenticación y cada herramienta.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://croma.mintlify.site/_mintlify/api/og/v2?division=Primeros+pasos\u0026amp;title=MCP\u0026amp;description=Conecta+Claude%2C+ChatGPT%2C+Cursor+o+cualquier+cliente+MCP+a+las+fuentes+de+datos+de+gobierno+de+Croma%3A+URL+del+servidor%2C+autenticaci%C3%B3n+y+cada+herramienta.\u0026amp;theme=27f398343599ad9c36ebea10\u0026amp;signature=f8bded48a05d3d98135beb81f45c35cdd6802dda964be83dedfd11050e50384a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/croma/WB4AmZ7e3PEc7UXM/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Croma API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#18181b\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.usecroma.com/es/mcp-server\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/es/mcp-server.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.usecroma.com/es/mcp-server\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.usecroma.com/mcp-server\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://docs.usecroma.com/pt/mcp-server\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.usecroma.com/mcp-server\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.usecroma.com/#organization\",\"name\":\"Croma API\",\"url\":\"https://docs.usecroma.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/croma/ioi13hN3s-Dcty8-/logo/light.svg?fit=max\u0026auto=format\u0026n=ioi13hN3s-Dcty8-\u0026q=85\u0026s=a4da0b4b29d11b13c5fd3219ead7027b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.usecroma.com#website\",\"name\":\"Croma API\",\"url\":\"https://docs.usecroma.com\",\"publisher\":{\"@id\":\"https://docs.usecroma.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.usecroma.com/es/mcp-server#webpage\",\"url\":\"https://docs.usecroma.com/es/mcp-server\",\"name\":\"MCP\",\"description\":\"Conecta Claude, ChatGPT, Cursor o cualquier cliente MCP a las fuentes de datos de gobierno de Croma: URL del servidor, autenticación y cada herramienta.\",\"dateModified\":\"2026-10-23T22:34:35.906Z\",\"isPartOf\":{\"@id\":\"https://docs.usecroma.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.usecroma.com/es/mcp-server#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.usecroma.com/es/mcp-server#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Primeros pasos\",\"item\":\"https://docs.usecroma.com/es/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"MCP\",\"item\":\"https://docs.usecroma.com/es/mcp-server\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.usecroma.com/es/mcp-server#article\",\"headline\":\"MCP\",\"name\":\"MCP\",\"description\":\"Conecta Claude, ChatGPT, Cursor o cualquier cliente MCP a las fuentes de datos de gobierno de Croma: URL del servidor, autenticación y cada herramienta.\",\"url\":\"https://docs.usecroma.com/es/mcp-server\",\"mainEntityOfPage\":{\"@id\":\"https://docs.usecroma.com/es/mcp-server#webpage\"},\"dateModified\":\"2026-10-23T22:34:35.906Z\",\"publisher\":{\"@id\":\"https://docs.usecroma.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.usecroma.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Croma API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Croma API","nav":{"global":null,"languages":[{"language":"en","default":true,"pages":[{"title":"en","href":"/mcp-server"}]},{"language":"es","tabs":[{"tab":"Guías","groups":[{"group":"Primeros pasos","pages":[{"title":"Documentación de Croma","href":"/es/introduction"},{"title":"Inicio rápido","href":"/es/quickstart"},{"title":"Autenticación","description":"Dónde crear llaves de API de Croma, cómo funciona el esquema bearer, cómo se asocian las llaves a tu organización y qué hacer si una llave se filtra.","href":"/es/authentication"},{"title":"MCP","href":"/es/mcp-server"},{"title":"Créditos","description":"Cómo funcionan los créditos de Croma: cuánto cuestan una consulta en vivo y una solicitud a datasets, qué no consume nada, cuándo se reinicia el saldo y cómo es un 402.","href":"/es/credits"},{"title":"Límites de tasa","href":"/es/rate-limits"},{"title":"Errores","href":"/es/errors"},{"title":"Versionado y deprecación","href":"/es/versioning"}]},{"group":"Tipos de solicitud","pages":[{"title":"Consultas en vivo","href":"/es/live-lookups"},{"title":"Datasets","href":"/es/datasets"},{"title":"Trabajos asíncronos","href":"/es/async-jobs"},{"title":"Solicitudes en lote","href":"/es/batch"},{"title":"Conexiones","href":"/es/connections"}]},{"group":"Monitores","pages":[{"title":"Monitores","href":"/es/monitors"},{"title":"Monitores desde Claude","href":"/es/monitors-mcp"},{"title":"Fuentes monitoreables","href":"/es/monitors-sources"}]},{"group":"Comentarios","pages":[{"title":"Comentarios","href":"/es/feedback"}]},{"group":"Países","pages":[{"group":"Colombia","pages":[{"group":"Justicia y litigios","expanded":true,"pages":[{"title":"Rama Judicial","href":"/es/guides/colombia/rama-judicial"},{"title":"SAMAI (Consejo de Estado)","href":"/es/guides/colombia/samai"},{"title":"SAMAI Relatoría","href":"/es/guides/colombia/samai-rulings"},{"title":"Consejo de Estado","href":"/es/guides/colombia/consejo-estado"},{"title":"CNDJ","href":"/es/guides/colombia/cndj"},{"title":"Fiscalía (SPOA)","href":"/es/guides/colombia/fiscalia"},{"title":"Superfinanciera","href":"/es/guides/colombia/superfinanciera"},{"title":"Superfinanciera Doctrina","href":"/es/guides/colombia/superfinanciera-doctrine"},{"title":"Banco de la República","href":"/es/guides/colombia/banrep"},{"title":"Banco de la República: investigaciones e informes","href":"/es/guides/colombia/banrep-research"},{"title":"SIC","href":"/es/guides/colombia/sic-normativa"},{"title":"SIC Sanciones","href":"/es/guides/colombia/sic-sanctions"},{"title":"SIC Actos","href":"/es/guides/colombia/sic-actos"},{"title":"SIC Trámites","href":"/es/guides/colombia/sic-tramites"},{"title":"SIC Gaceta de la Propiedad Industrial","href":"/es/guides/colombia/sic-gazette"},{"title":"SIC Propiedad Industrial","href":"/es/guides/colombia/sic-ip"},{"title":"SIMEV","href":"/es/guides/colombia/simev"},{"title":"Imprenta Nacional","href":"/es/guides/colombia/imprenta"},{"title":"Función Pública","href":"/es/guides/colombia/funcion-publica"},{"title":"Trámites del Estado colombiano (SUIT)","href":"/es/guides/colombia/suit"},{"title":"Páginas de trámites de las entidades","href":"/es/guides/colombia/gov-pages"},{"title":"CREG","href":"/es/guides/colombia/creg"},{"title":"Corte Constitucional","href":"/es/guides/colombia/corte-constitucional"},{"title":"Corte Suprema de Justicia","href":"/es/guides/colombia/corte-suprema"},{"title":"ANM","href":"/es/guides/colombia/anm"},{"title":"INVIMA","href":"/es/guides/colombia/invima"},{"title":"MinEducación","href":"/es/guides/colombia/mineducacion"},{"title":"ICFES","href":"/es/guides/colombia/icfes"}]},{"group":"Verificación de personas","expanded":true,"pages":[{"title":"Registraduría","href":"/es/guides/colombia/registraduria"},{"title":"Registro Civil","href":"/es/guides/colombia/registro-civil"},{"title":"Policía Nacional","href":"/es/guides/colombia/policia"},{"title":"Policía Nacional: medidas correctivas","href":"/es/guides/colombia/policia-rnmc"},{"title":"Procuraduría","href":"/es/guides/colombia/procuraduria"},{"title":"Contraloría","href":"/es/guides/colombia/contraloria"},{"title":"Contaduría","href":"/es/guides/colombia/contaduria"},{"title":"ADRES","href":"/es/guides/colombia/adres"},{"title":"DNP (Sisbén IV y RUI)","href":"/es/guides/colombia/dnp"},{"title":"DNP TerriData","href":"/es/guides/colombia/terridata"},{"title":"SICAAC","href":"/es/guides/colombia/sicaac"},{"title":"RUAF","href":"/es/guides/colombia/ruaf"},{"title":"ReTHUS","href":"/es/guides/colombia/rethus"}]},{"group":"Empresas e impuestos","expanded":true,"pages":[{"title":"RUES","href":"/es/guides/colombia/rues"},{"title":"Supersociedades","href":"/es/guides/colombia/supersociedades"},{"title":"Baranda Virtual de Supersociedades","href":"/es/guides/colombia/supersociedades-baranda"},{"title":"Doctrina y jurisprudencia de Supersociedades","href":"/es/guides/colombia/supersociedades-relatoria"},{"title":"DIAN","href":"/es/guides/colombia/dian"},{"title":"Mi cuenta DIAN","href":"/es/guides/colombia/dian-muisca"},{"title":"Facturación electrónica DIAN","href":"/es/guides/colombia/dian-facturacion"},{"title":"DIAN Importadores y Exportadores","href":"/es/guides/colombia/dian-trade"},{"title":"Arancel de la DIAN","href":"/es/guides/colombia/dian-arancel"},{"title":"VUCE","href":"/es/guides/colombia/vuce"},{"title":"Mis cuentas Bancolombia","href":"/es/guides/colombia/bancolombia"}]},{"group":"Contratación pública","expanded":true,"pages":[{"title":"SECOP","href":"/es/guides/colombia/secop"},{"title":"ANCP-CCE","href":"/es/guides/colombia/ancp-cce"}]},{"group":"Vehículos y tránsito","expanded":true,"pages":[{"title":"RUNT","href":"/es/guides/colombia/runt"},{"title":"SIMIT","href":"/es/guides/colombia/simit"},{"title":"TransMilenio","href":"/es/guides/colombia/transmilenio"}]},{"group":"Otros","expanded":true,"pages":[{"title":"Legalize","href":"/es/guides/colombia/legalize"},{"title":"SIATA","href":"/es/guides/colombia/siata"},{"title":"SIATA Geoportal","href":"/es/guides/colombia/siata-geoportal"},{"title":"IGAC","href":"/es/guides/colombia/igac"},{"title":"DANE","href":"/es/guides/colombia/dane"},{"title":"IGAC Transacciones inmobiliarias","href":"/es/guides/colombia/igac-transactions"},{"title":"UPRA Precios de la tierra rural","href":"/es/guides/colombia/upra"}]}]},{"group":"Perú","pages":[{"group":"Identidad e impuestos","expanded":true,"pages":[{"title":"SUNAT","href":"/es/guides/peru/sunat"},{"title":"RREE","href":"/es/guides/peru/rree"},{"title":"SAT Lima","href":"/es/guides/peru/sat-lima"}]},{"group":"Propiedad y registros","expanded":true,"pages":[{"title":"Registros Públicos SUNARP","href":"/es/guides/peru/sunarp"},{"title":"Consulta Vehicular SUNARP","href":"/es/guides/peru/sunarp-vehicular"}]},{"group":"Vehículos y tránsito","expanded":true,"pages":[{"title":"Órdenes de captura SAT Lima","href":"/es/guides/peru/sat-lima-capturas"},{"title":"Papeletas de tránsito Callao","href":"/es/guides/peru/callao-papeletas"},{"title":"Récord de Infracciones SUTRAN","href":"/es/guides/peru/sutran-infracciones"},{"title":"Historial de SOAT APESEG","href":"/es/guides/peru/apeseg-soat"},{"title":"Reporte SOAT, CAT y Seguro Vehicular de la SBS","href":"/es/guides/peru/sbs-soat"}]},{"group":"Contratación pública","expanded":true,"pages":[{"title":"OECE Contrataciones Abiertas","href":"/es/guides/peru/oece"}]},{"group":"Justicia y litigios","expanded":true,"pages":[{"title":"Tribunal Constitucional","href":"/es/guides/peru/tribunal-constitucional"},{"title":"Tribunal del Servicio Civil","href":"/es/guides/peru/servir-tsc"}]}]},{"group":"México","pages":[{"group":"Leyes y regulación","expanded":true,"pages":[{"title":"DOF","href":"/es/guides/mexico/dof"},{"title":"Cámara de Diputados","href":"/es/guides/mexico/diputados"},{"title":"CNBV","href":"/es/guides/mexico/cnbv"},{"title":"CNSF","href":"/es/guides/mexico/cnsf"},{"title":"Banxico","href":"/es/guides/mexico/banxico"}]},{"group":"Justicia y fiscalías","expanded":true,"pages":[{"title":"SCJN","href":"/es/guides/mexico/scjn"},{"title":"Fiscalías (México)","href":"/es/guides/mexico/fiscalias"}]},{"group":"Otros","expanded":true,"pages":[{"title":"SIEM","href":"/es/guides/mexico/siem"}]}]},{"group":"Estados Unidos","pages":[{"group":"Companies","expanded":true,"pages":[{"title":"Sunbiz","href":"/es/guides/united-states/sunbiz"},{"title":"Delaware","href":"/es/guides/united-states/delaware"},{"title":"Registros MSB de FinCEN","href":"/es/guides/united-states/fincen"},{"title":"Marcas de la USPTO","href":"/es/guides/united-states/uspto"},{"title":"Sociedades de Nueva York","href":"/es/guides/united-states/ny-dos"},{"title":"Entidades de Colorado","href":"/es/guides/united-states/colorado-sos"},{"title":"Empresas de Connecticut","href":"/es/guides/united-states/ct-sos"}]},{"group":"Liens","expanded":true,"pages":[{"title":"Gravámenes UCC de Colorado","href":"/es/guides/united-states/colorado-ucc"},{"title":"Gravámenes UCC de Connecticut","href":"/es/guides/united-states/ct-ucc"}]},{"group":"Securities \u0026 funding","expanded":true,"pages":[{"title":"SEC EDGAR","href":"/es/guides/united-states/sec"},{"title":"SEC Form ADV","href":"/es/guides/united-states/iapd"},{"title":"SEC Form 13F","href":"/es/guides/united-states/sec-13f"},{"title":"SEC Crowdfunding y Regulation A","href":"/es/guides/united-states/sec-offerings"}]},{"group":"Sanctions \u0026 screening","expanded":true,"pages":[{"title":"Sanciones OFAC","href":"/es/guides/united-states/ofac"},{"title":"Consolidated Screening List","href":"/es/guides/united-states/csl"},{"title":"Exclusiones de SAM.gov","href":"/es/guides/united-states/sam"}]},{"group":"Public procurement","expanded":true,"pages":[{"title":"Oportunidades de contratación de SAM.gov","href":"/es/guides/united-states/sam-opportunities"}]},{"group":"Employment \u0026 visas","expanded":true,"pages":[{"title":"DOL H-1B y PERM: certificaciones laborales","href":"/es/guides/united-states/dol-oflc"}]}]},{"group":"Brasil","pages":[{"group":"Justicia y litigios","expanded":true,"pages":[{"title":"DJEN","href":"/es/guides/brazil/djen"}]},{"group":"Verificación de personas","expanded":true,"pages":[{"title":"Sanciones CGU","href":"/es/guides/brazil/cgu"},{"title":"MTE (registro de trabajo esclavo)","href":"/es/guides/brazil/mte"},{"title":"IBAMA (embargos)","href":"/es/guides/brazil/ibama"}]},{"group":"Empresas e impuestos","expanded":true,"pages":[{"title":"PGFN","href":"/es/guides/brazil/pgfn"},{"title":"TST","href":"/es/guides/brazil/tst"},{"title":"Caixa (FGTS)","href":"/es/guides/brazil/caixa"}]},{"group":"Leyes y regulación","expanded":true,"pages":[{"title":"Planalto (legislación federal)","href":"/es/guides/brazil/planalto"}]},{"group":"Estadísticas","expanded":true,"pages":[{"title":"IBGE","href":"/es/guides/brazil/ibge"}]}]},{"group":"Bolivia","pages":[{"group":"Justicia y litigios","expanded":true,"pages":[{"title":"Tribunal Constitucional Plurinacional","href":"/es/guides/bolivia/tcp"},{"title":"Tribunal Supremo de Justicia","href":"/es/guides/bolivia/tsj"}]}]},{"group":"Japón","pages":[{"group":"Companies","expanded":true,"pages":[{"title":"National Tax Agency (法人番号)","href":"/es/guides/japan/nta"}]},{"group":"Justicia y litigios","expanded":true,"pages":[{"title":"Courts of Japan (裁判例)","href":"/es/guides/japan/courts"}]}]},{"group":"Chile","pages":[{"group":"Justicia y litigios","expanded":true,"pages":[{"title":"Poder Judicial","href":"/es/guides/chile/pjud"},{"title":"Tribunal Constitucional","href":"/es/guides/chile/tribunal-constitucional"},{"title":"Tribunales Tributarios y Aduaneros","href":"/es/guides/chile/tta"}]},{"group":"Leyes y regulación","expanded":true,"pages":[{"title":"SII","href":"/es/guides/chile/sii"},{"title":"Contraloría General de la República","href":"/es/guides/chile/contraloria"},{"title":"CMF","href":"/es/guides/chile/cmf"},{"title":"Ley Chile","href":"/es/guides/chile/leychile"},{"title":"Dirección del Trabajo","href":"/es/guides/chile/direccion-del-trabajo"},{"title":"Superintendencia de Seguridad Social","href":"/es/guides/chile/suseso"}]},{"group":"Propiedad y registros","expanded":true,"pages":[{"title":"SII Mapas","href":"/es/guides/chile/sii-mapas"}]}]},{"group":"Venezuela","pages":[{"group":"Identidad e impuestos","expanded":true,"pages":[{"title":"SENIAT: Registro de Información Fiscal (RIF)","href":"/es/guides/venezuela/seniat"}]}]},{"group":"El Salvador","pages":[{"group":"Empresas e impuestos","expanded":true,"pages":[{"title":"CNR","href":"/es/guides/el-salvador/cnr"},{"title":"Facturación electrónica","href":"/es/guides/el-salvador/facturacion-electronica"}]},{"group":"Justicia y litigios","expanded":true,"pages":[{"title":"Corte Suprema de Justicia","href":"/es/guides/el-salvador/csj"}]},{"group":"Leyes y regulación","expanded":true,"pages":[{"title":"Asamblea Legislativa","href":"/es/guides/el-salvador/asamblea"}]},{"group":"Contratación pública","expanded":true,"pages":[{"title":"COMPRASAL","href":"/es/guides/el-salvador/compras-publicas"}]},{"group":"Otros","expanded":true,"pages":[{"title":"Ministerio de Turismo","href":"/es/guides/el-salvador/turismo"}]}]},{"group":"Global","pages":[{"title":"Web Search","href":"/es/guides/global/web-search"},{"title":"Extract","href":"/es/guides/global/extract"},{"title":"Generate","href":"/es/guides/global/generate"},{"title":"Research","href":"/es/guides/global/research"},{"title":"GLEIF (LEI)","href":"/es/guides/global/gleif"},{"title":"Indicadores del Banco Mundial","href":"/es/guides/global/world-bank"}]}]}]},{"tab":"Referencia de API","pages":[{"title":"Referencia de API","href":"/es/api-reference/overview"}]},{"tab":"API Legal","hidden":true,"searchable":true,"pages":[{"title":"API Legal","href":"/es/legal/introduction"}]}]},{"language":"pt-BR","pages":[{"title":"pt-BR","href":"/pt/mcp-server"}]}]},"basePath":"","title":"MCP - Croma API","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":[],"chunks":[]}