Pular para o conteúdo principal
A Croma expõe cada fonte de dados como uma ferramenta por meio do Model Context Protocol (MCP), servido sobre Streamable HTTP em:
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.

Use a partir do AI SDK

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:
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.

Comece pelo template de chat

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.

Nomes das ferramentas

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.

Qualquer cliente MCP

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.