Conecte Claude, ChatGPT, Cursor ou qualquer cliente MCP às fontes de dados governamentais da Croma: URL do servidor, autenticação e cada ferramenta.
A Croma expõe cada fonte de dados como uma ferramenta por meio do Model
Context Protocol (MCP), servido sobre
Streamable HTTP em:
https://api.croma.run/mcp
Qualquer cliente MCP pode se conectar. Os clientes interativos (Claude,
ChatGPT, Cursor) usam o fluxo de OAuth:
adicione a Croma ao Claude em um clique
e faça login com sua conta Croma. 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.
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:
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);
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.
Croma Chat Template é um
chat open source em Next.js construído sobre este endpoint com o AI SDK e o
AI Elements: respostas em streaming, chamadas de
ferramentas sobre todas as fontes da Croma, um seletor de fontes por mensagem e
limite de uso opcional. Experimente a implantação ao vivo em
chat.usecroma.com, ou use a implantação de um
clique na Vercel do repositório: ela pede sua CROMA_API_KEY e uma chave de
modelo e fica pronta para usar.
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.As ferramentas de monitores administram os monitores da
organização conectada: create_monitor acompanha um endpoint de dataset com uma
frequência e envia por e-mail o que é novo; list_monitors, get_monitor,
update_monitor (renomear, mudar a consulta, pausar, retomar), run_monitor,
list_monitor_matches e delete_monitor fazem o resto. Monitores pelo
Claude tem pedidos que funcionam e o que o agente faz com
eles.A ferramenta submit_feedback envia um feedback à Croma quando uma ferramenta falha,
devolve um resultado claramente incorreto ou nenhuma cobre a fonte de que você precisa. Veja
Feedback.Uma fonte que só responde a uma pessoa com sessão iniciada, como a
SUNARP, soma três ferramentas de conexão:
sunarp_connect responde com um link seguro onde o usuário informa os dados da
sua própria conta no console da Croma, assim as credenciais nunca passam pela
conversa (a conta é verificada com a fonte, criptografada ao chegar e nunca
devolvida), sunarp_list_connections mostra o
estado e a cota diária de cada uma e sunarp_delete_connection exclui uma. A
DIAN tem as mesmas três como
dian_muisca_connect, dian_muisca_list_connections e
dian_muisca_delete_connection, e o faturamento eletrônico DIAN como
dian_facturacion_connect, dian_facturacion_list_connections e
dian_facturacion_delete_connection. A partir daí as consultas rodam sozinhas com as conexões da organização. As
ferramentas de monitores e de conexões são as únicas que escrevem.
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.
{"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":"pt/mcp-server","slug":"/pt/mcp-server","pageMetadata":{"title":"MCP","description":"Conecte Claude, ChatGPT, Cursor ou qualquer cliente MCP às fontes de dados governamentais da Croma: URL do servidor, autenticação e cada ferramenta.","href":"/pt/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: \"Conecte Claude, ChatGPT, Cursor ou qualquer cliente MCP às fontes de dados governamentais da Croma: URL do servidor, autenticação e cada ferramenta.\"\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:[`A Croma expõe cada fonte de dados como uma ferramenta por meio do `,_jsx(_components.a,{href:`https://modelcontextprotocol.io`,children:`Model\nContext Protocol`}),` (MCP), servido sobre\nStreamable HTTP em:`]}),`\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:[`Qualquer cliente MCP pode se conectar. Os clientes interativos (Claude,\nChatGPT, Cursor) usam o fluxo 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:`adicione a Croma ao Claude em um clique`}),`\ne faça login com sua conta Croma. Para o seu próprio código você se autentica\ncom a `,_jsx(_components.strong,{children:`mesma chave de API da API REST`}),`: envie-a como token bearer e as\nferramentas são executadas com o escopo da sua organização, compartilhando os\nmesmos `,_jsx(_components.a,{href:`/pt/rate-limits`,children:`limites de taxa`}),` e uso.`]}),`\n`,_jsx(Heading,{level:`2`,id:`use-a-partir-do-ai-sdk`,children:`Use a partir do AI SDK`}),`\n`,_jsxs(_components.p,{children:[`O `,_jsx(_components.a,{href:`https://ai-sdk.dev`,children:`AI SDK`}),` pode carregar as ferramentas da Croma\ndiretamente e entregá-las a um modelo para chamadas de ferramentas. Envie sua\nchave no cabeçalho `,_jsx(_components.code,{children:`Authorization`}),` do 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:[`Trate a chave como um segredo: carregue-a de uma variável de ambiente ou de um\ngerenciador de segredos, nunca a envie ao repositório e feche o cliente\n(`,_jsx(_components.code,{children:`mcp.close()`}),`) quando terminar para liberar a conexão.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`comece-pelo-template-de-chat`,children:`Comece pelo template de chat`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`https://github.com/croma-ai/croma-chat-template`,children:`Croma Chat Template`}),` é um\nchat open source em Next.js construído sobre este endpoint com o AI SDK e o\n`,_jsx(_components.a,{href:`https://ai-sdk.dev/elements`,children:`AI Elements`}),`: respostas em streaming, chamadas de\nferramentas sobre todas as fontes da Croma, um seletor de fontes por mensagem e\nlimite de uso opcional. Experimente a implantação ao vivo em\n`,_jsx(_components.a,{href:`https://chat.usecroma.com`,children:`chat.usecroma.com`}),`, ou use a implantação de um\nclique na Vercel do repositório: ela pede sua `,_jsx(_components.code,{children:`CROMA_API_KEY`}),` e uma chave de\nmodelo e fica pronta para usar.`]}),`\n`,_jsx(Heading,{level:`2`,id:`nomes-das-ferramentas`,children:`Nomes das ferramentas`}),`\n`,_jsxs(_components.p,{children:[`As ferramentas são nomeadas conforme a sua fonte, com sublinhados em vez de\nhifens, por exemplo `,_jsx(_components.code,{children:`policia_criminal_records`}),`, `,_jsx(_components.code,{children:`rues_entity_by_nit`}),` e\n`,_jsx(_components.code,{children:`rama_judicial_cases_by_radicado`}),`. Chame `,_jsx(_components.code,{children:`mcp.tools()`}),` para listar o conjunto\ncompleto com seus esquemas de entrada, ou consulte a `,_jsx(_components.a,{href:`/pt/api-reference`,children:`referência da\nAPI`}),` para os campos que cada uma aceita.`]}),`\n`,_jsxs(_components.p,{children:[`As `,_jsx(_components.a,{href:`/pt/async-jobs`,children:`consultas assíncronas`}),` sempre aguardam de forma síncrona sobre MCP:\na chamada da ferramenta retorna o resultado pronto, sem `,_jsx(_components.code,{children:`202`}),`, polling\nnem callbacks.`]}),`\n`,_jsxs(_components.p,{children:[`As ferramentas de monitores administram os `,_jsx(_components.a,{href:`/pt/monitors`,children:`monitores`}),` da\norganização conectada: `,_jsx(_components.code,{children:`create_monitor`}),` acompanha um endpoint de dataset com uma\nfrequência e envia por e-mail o que é novo; `,_jsx(_components.code,{children:`list_monitors`}),`, `,_jsx(_components.code,{children:`get_monitor`}),`,\n`,_jsx(_components.code,{children:`update_monitor`}),` (renomear, mudar a consulta, pausar, retomar), `,_jsx(_components.code,{children:`run_monitor`}),`,\n`,_jsx(_components.code,{children:`list_monitor_matches`}),` e `,_jsx(_components.code,{children:`delete_monitor`}),` fazem o resto. `,_jsx(_components.a,{href:`/pt/monitors-mcp`,children:`Monitores pelo\nClaude`}),` tem pedidos que funcionam e o que o agente faz com\neles.`]}),`\n`,_jsxs(_components.p,{children:[`A ferramenta `,_jsx(_components.code,{children:`submit_feedback`}),` envia um feedback à Croma quando uma ferramenta falha,\ndevolve um resultado claramente incorreto ou nenhuma cobre a fonte de que você precisa. Veja\n`,_jsx(_components.a,{href:`/pt/feedback`,children:`Feedback`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Uma fonte que só responde a uma pessoa com sessão iniciada, como a\n`,_jsx(_components.a,{href:`/pt/guides/peru/sunarp`,children:`SUNARP`}),`, soma três ferramentas de conexão:\n`,_jsx(_components.code,{children:`sunarp_connect`}),` responde com um link seguro onde o usuário informa os dados da\nsua própria conta no console da Croma, assim as credenciais nunca passam pela\nconversa (a conta é verificada com a fonte, criptografada ao chegar e nunca\ndevolvida), `,_jsx(_components.code,{children:`sunarp_list_connections`}),` mostra o\nestado e a cota diária de cada uma e `,_jsx(_components.code,{children:`sunarp_delete_connection`}),` exclui uma. A\n`,_jsx(_components.a,{href:`/pt/guides/colombia/dian-muisca`,children:`DIAN`}),` tem as mesmas três como\n`,_jsx(_components.code,{children:`dian_muisca_connect`}),`, `,_jsx(_components.code,{children:`dian_muisca_list_connections`}),` e\n`,_jsx(_components.code,{children:`dian_muisca_delete_connection`}),`, e o `,_jsx(_components.a,{href:`/pt/guides/colombia/dian-facturacion`,children:`faturamento eletrônico DIAN`}),` como\n`,_jsx(_components.code,{children:`dian_facturacion_connect`}),`, `,_jsx(_components.code,{children:`dian_facturacion_list_connections`}),` e\n`,_jsx(_components.code,{children:`dian_facturacion_delete_connection`}),`. A partir daí as consultas rodam sozinhas com as conexões da organização. As\nferramentas de monitores e de conexões são as únicas que escrevem.`]}),`\n`,_jsx(Heading,{level:`2`,id:`qualquer-cliente-mcp`,children:`Qualquer cliente MCP`}),`\n`,_jsxs(_components.p,{children:[`O AI SDK é uma opção. Como o endpoint fala MCP padrão sobre Streamable\nHTTP, o\n`,_jsx(_components.a,{href:`https://github.com/modelcontextprotocol/typescript-sdk`,children:`SDK oficial de MCP para TypeScript`}),`,\no LangChain e outros frameworks compatíveis com MCP se conectam da mesma forma:\naponte-os para `,_jsx(_components.code,{children:`https://api.croma.run/mcp`}),` e defina o cabeçalho\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":"Conecte Claude, ChatGPT, Cursor ou qualquer cliente MCP às fontes de dados governamentais da Croma: URL do servidor, autenticação e cada ferramenta.","href":"/pt/mcp-server"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Use a partir do AI SDK","slug":"use-a-partir-do-ai-sdk","depth":2,"children":[]},{"title":"Comece pelo template de chat","slug":"comece-pelo-template-de-chat","depth":2,"children":[]},{"title":"Nomes das ferramentas","slug":"nomes-das-ferramentas","depth":2,"children":[]},{"title":"Qualquer cliente MCP","slug":"qualquer-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":1},"pt-BR":{"href":"/pt/mcp-server","matchLevel":0}}},"lastModified":"2026-10-23T22:34:31.809Z","originalFileLocation":"pt/mcp-server.mdx","locale":"pt-BR"},"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=\"Conecte Claude, ChatGPT, Cursor ou qualquer cliente MCP às fontes de dados governamentais da Croma: URL do servidor, autenticação e cada ferramenta.\">\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=\"Conecte Claude, ChatGPT, Cursor ou qualquer cliente MCP às fontes de dados governamentais da Croma: URL do servidor, autenticação e cada ferramenta.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Croma API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.usecroma.com/pt/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=Primeiros+passos\u0026amp;title=MCP\u0026amp;description=Conecte+Claude%2C+ChatGPT%2C+Cursor+ou+qualquer+cliente+MCP+%C3%A0s+fontes+de+dados+governamentais+da+Croma%3A+URL+do+servidor%2C+autentica%C3%A7%C3%A3o+e+cada+ferramenta.\u0026amp;theme=27f398343599ad9c36ebea10\u0026amp;signature=ad831b85cc3a2367ba47e65975b9a874a1cf165073c6e374d8955991e5454b4e\">\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=\"Conecte Claude, ChatGPT, Cursor ou qualquer cliente MCP às fontes de dados governamentais da Croma: URL do servidor, autenticação e cada ferramenta.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://croma.mintlify.site/_mintlify/api/og/v2?division=Primeiros+passos\u0026amp;title=MCP\u0026amp;description=Conecte+Claude%2C+ChatGPT%2C+Cursor+ou+qualquer+cliente+MCP+%C3%A0s+fontes+de+dados+governamentais+da+Croma%3A+URL+do+servidor%2C+autentica%C3%A7%C3%A3o+e+cada+ferramenta.\u0026amp;theme=27f398343599ad9c36ebea10\u0026amp;signature=ad831b85cc3a2367ba47e65975b9a874a1cf165073c6e374d8955991e5454b4e\">\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/pt/mcp-server\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/pt/mcp-server.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://docs.usecroma.com/pt/mcp-server\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.usecroma.com/mcp-server\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.usecroma.com/es/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/pt/mcp-server#webpage\",\"url\":\"https://docs.usecroma.com/pt/mcp-server\",\"name\":\"MCP\",\"description\":\"Conecte Claude, ChatGPT, Cursor ou qualquer cliente MCP às fontes de dados governamentais da Croma: URL do servidor, autenticação e cada ferramenta.\",\"dateModified\":\"2026-10-23T22:34:31.809Z\",\"isPartOf\":{\"@id\":\"https://docs.usecroma.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.usecroma.com/pt/mcp-server#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.usecroma.com/pt/mcp-server#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Primeiros passos\",\"item\":\"https://docs.usecroma.com/pt/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"MCP\",\"item\":\"https://docs.usecroma.com/pt/mcp-server\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.usecroma.com/pt/mcp-server#article\",\"headline\":\"MCP\",\"name\":\"MCP\",\"description\":\"Conecte Claude, ChatGPT, Cursor ou qualquer cliente MCP às fontes de dados governamentais da Croma: URL do servidor, autenticação e cada ferramenta.\",\"url\":\"https://docs.usecroma.com/pt/mcp-server\",\"mainEntityOfPage\":{\"@id\":\"https://docs.usecroma.com/pt/mcp-server#webpage\"},\"dateModified\":\"2026-10-23T22:34:31.809Z\",\"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","pages":[{"title":"es","href":"/es/mcp-server"}]},{"language":"pt-BR","tabs":[{"tab":"Guias","groups":[{"group":"Primeiros passos","pages":[{"title":"Documentação da Croma","href":"/pt/introduction"},{"title":"Início rápido","href":"/pt/quickstart"},{"title":"Autenticação","description":"Onde criar chaves de API da Croma, como funciona o esquema bearer, como as chaves se associam à sua organização e o que fazer no momento em que uma chave vazar.","href":"/pt/authentication"},{"title":"MCP","href":"/pt/mcp-server"},{"title":"Créditos","description":"Como funcionam os créditos da Croma: quanto custam uma consulta ao vivo e uma solicitação a datasets, o que não consome nada, quando o saldo reinicia e como é um 402.","href":"/pt/credits"},{"title":"Limites de taxa","href":"/pt/rate-limits"},{"title":"Erros","href":"/pt/errors"},{"title":"Versionamento e descontinuação","href":"/pt/versioning"}]},{"group":"Tipos de solicitação","pages":[{"title":"Consultas ao vivo","href":"/pt/live-lookups"},{"title":"Datasets","href":"/pt/datasets"},{"title":"Trabalhos assíncronos","href":"/pt/async-jobs"},{"title":"Solicitações em lote","href":"/pt/batch"},{"title":"Conexões","href":"/pt/connections"}]},{"group":"Monitores","pages":[{"title":"Monitores","href":"/pt/monitors"},{"title":"Monitores pelo Claude","href":"/pt/monitors-mcp"},{"title":"Fontes monitoráveis","href":"/pt/monitors-sources"}]},{"group":"Feedback","pages":[{"title":"Feedback","href":"/pt/feedback"}]},{"group":"Países","pages":[{"group":"Colômbia","pages":[{"group":"Justiça e litígios","expanded":true,"pages":[{"title":"Rama Judicial","href":"/pt/guides/colombia/rama-judicial"},{"title":"SAMAI (Consejo de Estado)","href":"/pt/guides/colombia/samai"},{"title":"SAMAI Relatoría","href":"/pt/guides/colombia/samai-rulings"},{"title":"Consejo de Estado","href":"/pt/guides/colombia/consejo-estado"},{"title":"CNDJ","href":"/pt/guides/colombia/cndj"},{"title":"Fiscalía (SPOA)","href":"/pt/guides/colombia/fiscalia"},{"title":"Superfinanciera","href":"/pt/guides/colombia/superfinanciera"},{"title":"Superfinanciera Doctrina","href":"/pt/guides/colombia/superfinanciera-doctrine"},{"title":"Banco de la República","href":"/pt/guides/colombia/banrep"},{"title":"Banco de la República: pesquisas e relatórios","href":"/pt/guides/colombia/banrep-research"},{"title":"SIC","href":"/pt/guides/colombia/sic-normativa"},{"title":"SIC Sanções","href":"/pt/guides/colombia/sic-sanctions"},{"title":"SIC Atos","href":"/pt/guides/colombia/sic-actos"},{"title":"SIC Trâmites","href":"/pt/guides/colombia/sic-tramites"},{"title":"SIC Gazeta da Propriedade Industrial","href":"/pt/guides/colombia/sic-gazette"},{"title":"SIC Propriedade Industrial","href":"/pt/guides/colombia/sic-ip"},{"title":"SIMEV","href":"/pt/guides/colombia/simev"},{"title":"Imprenta Nacional","href":"/pt/guides/colombia/imprenta"},{"title":"Función Pública","href":"/pt/guides/colombia/funcion-publica"},{"title":"Procedimentos do Estado colombiano (SUIT)","href":"/pt/guides/colombia/suit"},{"title":"Páginas de procedimentos das entidades","href":"/pt/guides/colombia/gov-pages"},{"title":"CREG","href":"/pt/guides/colombia/creg"},{"title":"Corte Constitucional","href":"/pt/guides/colombia/corte-constitucional"},{"title":"Corte Suprema de Justicia","href":"/pt/guides/colombia/corte-suprema"},{"title":"ANM","href":"/pt/guides/colombia/anm"},{"title":"INVIMA","href":"/pt/guides/colombia/invima"},{"title":"MinEducación","href":"/pt/guides/colombia/mineducacion"},{"title":"ICFES","href":"/pt/guides/colombia/icfes"}]},{"group":"Verificação de pessoas","expanded":true,"pages":[{"title":"Registraduría","href":"/pt/guides/colombia/registraduria"},{"title":"Registro Civil","href":"/pt/guides/colombia/registro-civil"},{"title":"Policía Nacional","href":"/pt/guides/colombia/policia"},{"title":"Policía Nacional: medidas corretivas","href":"/pt/guides/colombia/policia-rnmc"},{"title":"Procuraduría","href":"/pt/guides/colombia/procuraduria"},{"title":"Contraloría","href":"/pt/guides/colombia/contraloria"},{"title":"Contaduría","href":"/pt/guides/colombia/contaduria"},{"title":"ADRES","href":"/pt/guides/colombia/adres"},{"title":"DNP (Sisbén IV e RUI)","href":"/pt/guides/colombia/dnp"},{"title":"DNP TerriData","href":"/pt/guides/colombia/terridata"},{"title":"SICAAC","href":"/pt/guides/colombia/sicaac"},{"title":"RUAF","href":"/pt/guides/colombia/ruaf"},{"title":"ReTHUS","href":"/pt/guides/colombia/rethus"}]},{"group":"Empresas e impostos","expanded":true,"pages":[{"title":"RUES","href":"/pt/guides/colombia/rues"},{"title":"Supersociedades","href":"/pt/guides/colombia/supersociedades"},{"title":"Baranda Virtual da Supersociedades","href":"/pt/guides/colombia/supersociedades-baranda"},{"title":"Doutrina e jurisprudência da Supersociedades","href":"/pt/guides/colombia/supersociedades-relatoria"},{"title":"DIAN","href":"/pt/guides/colombia/dian"},{"title":"Minha conta DIAN","href":"/pt/guides/colombia/dian-muisca"},{"title":"Faturamento eletrônico DIAN","href":"/pt/guides/colombia/dian-facturacion"},{"title":"DIAN Importadores e Exportadores","href":"/pt/guides/colombia/dian-trade"},{"title":"Tarifa da DIAN","href":"/pt/guides/colombia/dian-arancel"},{"title":"VUCE","href":"/pt/guides/colombia/vuce"},{"title":"Minhas contas Bancolombia","href":"/pt/guides/colombia/bancolombia"}]},{"group":"Contratação pública","expanded":true,"pages":[{"title":"SECOP","href":"/pt/guides/colombia/secop"},{"title":"ANCP-CCE","href":"/pt/guides/colombia/ancp-cce"}]},{"group":"Veículos e trânsito","expanded":true,"pages":[{"title":"RUNT","href":"/pt/guides/colombia/runt"},{"title":"SIMIT","href":"/pt/guides/colombia/simit"},{"title":"TransMilenio","href":"/pt/guides/colombia/transmilenio"}]},{"group":"Outros","expanded":true,"pages":[{"title":"Legalize","href":"/pt/guides/colombia/legalize"},{"title":"SIATA","href":"/pt/guides/colombia/siata"},{"title":"SIATA Geoportal","href":"/pt/guides/colombia/siata-geoportal"},{"title":"IGAC","href":"/pt/guides/colombia/igac"},{"title":"DANE","href":"/pt/guides/colombia/dane"},{"title":"IGAC Transações imobiliárias","href":"/pt/guides/colombia/igac-transactions"},{"title":"UPRA Preços da terra rural","href":"/pt/guides/colombia/upra"}]}]},{"group":"Peru","pages":[{"group":"Identidade e impostos","expanded":true,"pages":[{"title":"SUNAT","href":"/pt/guides/peru/sunat"},{"title":"RREE","href":"/pt/guides/peru/rree"},{"title":"SAT Lima","href":"/pt/guides/peru/sat-lima"}]},{"group":"Propriedade e registros","expanded":true,"pages":[{"title":"Registros Públicos SUNARP","href":"/pt/guides/peru/sunarp"},{"title":"Consulta Veicular SUNARP","href":"/pt/guides/peru/sunarp-vehicular"}]},{"group":"Veículos e trânsito","expanded":true,"pages":[{"title":"Órdenes de captura SAT Lima","href":"/pt/guides/peru/sat-lima-capturas"},{"title":"Papeletas de tránsito Callao","href":"/pt/guides/peru/callao-papeletas"},{"title":"Récord de Infracciones SUTRAN","href":"/pt/guides/peru/sutran-infracciones"},{"title":"Historial de SOAT APESEG","href":"/pt/guides/peru/apeseg-soat"},{"title":"Relatório SOAT, CAT e Seguro Vehicular da SBS","href":"/pt/guides/peru/sbs-soat"}]},{"group":"Contratação pública","expanded":true,"pages":[{"title":"OECE Contrataciones Abiertas","href":"/pt/guides/peru/oece"}]},{"group":"Justiça e litígios","expanded":true,"pages":[{"title":"Tribunal Constitucional","href":"/pt/guides/peru/tribunal-constitucional"},{"title":"Tribunal del Servicio Civil","href":"/pt/guides/peru/servir-tsc"}]}]},{"group":"México","pages":[{"group":"Leis e regulação","expanded":true,"pages":[{"title":"DOF","href":"/pt/guides/mexico/dof"},{"title":"Cámara de Diputados","href":"/pt/guides/mexico/diputados"},{"title":"CNBV","href":"/pt/guides/mexico/cnbv"},{"title":"CNSF","href":"/pt/guides/mexico/cnsf"},{"title":"Banxico","href":"/pt/guides/mexico/banxico"}]},{"group":"Justiça e procuradorias","expanded":true,"pages":[{"title":"SCJN","href":"/pt/guides/mexico/scjn"},{"title":"Fiscalías (México)","href":"/pt/guides/mexico/fiscalias"}]},{"group":"Outros","expanded":true,"pages":[{"title":"SIEM","href":"/pt/guides/mexico/siem"}]}]},{"group":"Estados Unidos","pages":[{"group":"Companies","expanded":true,"pages":[{"title":"Sunbiz","href":"/pt/guides/united-states/sunbiz"},{"title":"Delaware","href":"/pt/guides/united-states/delaware"},{"title":"Registros MSB da FinCEN","href":"/pt/guides/united-states/fincen"},{"title":"Marcas da USPTO","href":"/pt/guides/united-states/uspto"},{"title":"Sociedades de Nova York","href":"/pt/guides/united-states/ny-dos"},{"title":"Entidades do Colorado","href":"/pt/guides/united-states/colorado-sos"},{"title":"Empresas de Connecticut","href":"/pt/guides/united-states/ct-sos"}]},{"group":"Liens","expanded":true,"pages":[{"title":"Gravames UCC do Colorado","href":"/pt/guides/united-states/colorado-ucc"},{"title":"Gravames UCC de Connecticut","href":"/pt/guides/united-states/ct-ucc"}]},{"group":"Securities \u0026 funding","expanded":true,"pages":[{"title":"SEC EDGAR","href":"/pt/guides/united-states/sec"},{"title":"SEC Form ADV","href":"/pt/guides/united-states/iapd"},{"title":"SEC Form 13F","href":"/pt/guides/united-states/sec-13f"},{"title":"SEC Crowdfunding e Regulation A","href":"/pt/guides/united-states/sec-offerings"}]},{"group":"Sanctions \u0026 screening","expanded":true,"pages":[{"title":"Sanções OFAC","href":"/pt/guides/united-states/ofac"},{"title":"Consolidated Screening List","href":"/pt/guides/united-states/csl"},{"title":"Exclusões do SAM.gov","href":"/pt/guides/united-states/sam"}]},{"group":"Public procurement","expanded":true,"pages":[{"title":"Oportunidades de contratação do SAM.gov","href":"/pt/guides/united-states/sam-opportunities"}]},{"group":"Employment \u0026 visas","expanded":true,"pages":[{"title":"DOL H-1B e PERM: certificações trabalhistas","href":"/pt/guides/united-states/dol-oflc"}]}]},{"group":"Brasil","pages":[{"group":"Justiça e litígios","expanded":true,"pages":[{"title":"DJEN","href":"/pt/guides/brazil/djen"}]},{"group":"Verificação de pessoas","expanded":true,"pages":[{"title":"Sanções CGU","href":"/pt/guides/brazil/cgu"},{"title":"MTE (Lista Suja)","href":"/pt/guides/brazil/mte"},{"title":"IBAMA (embargos)","href":"/pt/guides/brazil/ibama"}]},{"group":"Empresas e impostos","expanded":true,"pages":[{"title":"PGFN","href":"/pt/guides/brazil/pgfn"},{"title":"TST","href":"/pt/guides/brazil/tst"},{"title":"Caixa (FGTS)","href":"/pt/guides/brazil/caixa"}]},{"group":"Leis e regulação","expanded":true,"pages":[{"title":"Planalto (legislação federal)","href":"/pt/guides/brazil/planalto"}]},{"group":"Estatísticas","expanded":true,"pages":[{"title":"IBGE","href":"/pt/guides/brazil/ibge"}]}]},{"group":"Bolívia","pages":[{"group":"Justiça e litígios","expanded":true,"pages":[{"title":"Tribunal Constitucional Plurinacional","href":"/pt/guides/bolivia/tcp"},{"title":"Tribunal Supremo de Justicia","href":"/pt/guides/bolivia/tsj"}]}]},{"group":"Japão","pages":[{"group":"Companies","expanded":true,"pages":[{"title":"National Tax Agency (法人番号)","href":"/pt/guides/japan/nta"}]},{"group":"Justiça e litígios","expanded":true,"pages":[{"title":"Courts of Japan (裁判例)","href":"/pt/guides/japan/courts"}]}]},{"group":"Chile","pages":[{"group":"Justiça e litígios","expanded":true,"pages":[{"title":"Poder Judicial","href":"/pt/guides/chile/pjud"},{"title":"Tribunal Constitucional","href":"/pt/guides/chile/tribunal-constitucional"},{"title":"Tribunales Tributarios y Aduaneros","href":"/pt/guides/chile/tta"}]},{"group":"Leis e regulação","expanded":true,"pages":[{"title":"SII","href":"/pt/guides/chile/sii"},{"title":"Contraloría General de la República","href":"/pt/guides/chile/contraloria"},{"title":"CMF","href":"/pt/guides/chile/cmf"},{"title":"Ley Chile","href":"/pt/guides/chile/leychile"},{"title":"Dirección del Trabajo","href":"/pt/guides/chile/direccion-del-trabajo"},{"title":"Superintendencia de Seguridad Social","href":"/pt/guides/chile/suseso"}]},{"group":"Propriedade e registros","expanded":true,"pages":[{"title":"SII Mapas","href":"/pt/guides/chile/sii-mapas"}]}]},{"group":"Venezuela","pages":[{"group":"Identidade e impostos","expanded":true,"pages":[{"title":"SENIAT: cadastro de contribuintes (RIF)","href":"/pt/guides/venezuela/seniat"}]}]},{"group":"El Salvador","pages":[{"group":"Empresas e impostos","expanded":true,"pages":[{"title":"CNR","href":"/pt/guides/el-salvador/cnr"},{"title":"Faturamento eletrônico","href":"/pt/guides/el-salvador/facturacion-electronica"}]},{"group":"Justiça e litígios","expanded":true,"pages":[{"title":"Corte Suprema de Justicia","href":"/pt/guides/el-salvador/csj"}]},{"group":"Leis e regulação","expanded":true,"pages":[{"title":"Asamblea Legislativa","href":"/pt/guides/el-salvador/asamblea"}]},{"group":"Contratação pública","expanded":true,"pages":[{"title":"COMPRASAL","href":"/pt/guides/el-salvador/compras-publicas"}]},{"group":"Outros","expanded":true,"pages":[{"title":"Ministerio de Turismo","href":"/pt/guides/el-salvador/turismo"}]}]},{"group":"Global","pages":[{"title":"Web Search","href":"/pt/guides/global/web-search"},{"title":"Extract","href":"/pt/guides/global/extract"},{"title":"Generate","href":"/pt/guides/global/generate"},{"title":"Research","href":"/pt/guides/global/research"},{"title":"GLEIF (LEI)","href":"/pt/guides/global/gleif"},{"title":"Indicadores do Banco Mundial","href":"/pt/guides/global/world-bank"}]}]}]},{"tab":"Referência da API","pages":[{"title":"Referência da API","href":"/pt/api-reference/overview"}]}]}]},"basePath":"","title":"MCP - Croma API","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":[],"chunks":[]}