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

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.

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.