Camella · MCP

MCP remoto para leituras do warehouse

HTTP Streamable em /api/mcp neste mesmo host — não é um segundo produto. Auth: Authorization: Bearer cam_live_… (qualquer chave de sessão iniciada; as mesmas de /api/v1). Sem sessão de cookie do site. Sem chave embutida.

Instalação em um clique

Criar uma conta é grátis. Criar uma chave API é grátis. Planos pagos desbloqueiam limites maiores e demonstrações financeiras.

O Cursor tem um deeplink oficial de instalação. Claude Code e Codex não têm protocolo de instalação — copie o comando oficial add e exporte CAMELLA_API_KEY. Só leitura: sem escritas na v1.

Instalar no Cursor Instalar no Claude Code Instalar no Codex

Depois de instalar: get_company EC 1790016919001 (Corporación Favorita).

Endpoint e autenticação

Crie uma conta grátis, gere uma chave cam_live_ na consola (qualquer sessão iniciada), exporte-a como CAMELLA_API_KEY e envie-a em cada pedido MCP. Nunca coloque uma chave cam_live_ real numa URL ou deeplink de instalação.

export CAMELLA_API_KEY='cam_live_YOUR_KEY'
# https://www.camella.app/api/mcp
Authorization: Bearer $CAMELLA_API_KEY

Ferramentas (só leitura)

Estas três ferramentas chamam os handlers existentes de /api/v1 (busca, entidade e financeiros). Não há ferramentas de escrita, de contactos nem geo/search_area.

Ferramenta	Argumentos	Equivale a
`search_companies`	`q`, `country?`, `limit?`	GET /api/v1/search
`get_company`	`country`, `identifier`	GET /api/v1/entities/…
`get_financials`	`country`, `identifier`	GET /api/v1/entities/…/financials

get_financials usa o mesmo gate de plano da rota REST: 403 se o plano não puder ver números. Demo: Corporación Favorita EC 1790016919001.

Cursor

Deeplink oficial de instalação do Cursor. O config é base64 de { url, headers } e interpola CAMELLA_API_KEY do ambiente — nunca uma chave real na URL. /docs/mcp/cursor faz 307 para o wrapper HTTPS para o clique no browser abrir o Cursor.

Instalar no Cursor/pt/docs/mcp/cursor

{
  "url": "https://www.camella.app/api/mcp",
  "headers": {
    "Authorization": "Bearer ${env:CAMELLA_API_KEY}"
  }
}

cursor.com/en/install-mcp?name=camella&config=… · cursor://anysphere.cursor-deeplink/mcp/install?name=camella&config=…

Claude Code

Sem deeplink oficial de instalação. CLI oficial: claude mcp add --transport http. O header lê CAMELLA_API_KEY do shell — não cole um segredo cam_live_ no comando.

Passos Claude

claude mcp add --transport http camella https://www.camella.app/api/mcp --header "Authorization: Bearer ${CAMELLA_API_KEY}"

Forma add-json equivalente (mesma interpolação Bearer):

claude mcp add-json camella '{"type":"http","url":"https://www.camella.app/api/mcp","headers":{"Authorization":"Bearer ${CAMELLA_API_KEY}"}}'

Codex

Sem deeplink oficial de instalação. A CLI oficial grava ~/.codex/config.toml. --bearer-token-env-var aponta para CAMELLA_API_KEY — o Codex envia Authorization: Bearer dessa variável. O mesmo modelo Bearer que /api/v1.

Passos Codex

codex mcp add camella --url https://www.camella.app/api/mcp --bearer-token-env-var CAMELLA_API_KEY

[mcp_servers.camella]
url = "https://www.camella.app/api/mcp"
bearer_token_env_var = "CAMELLA_API_KEY"

/mcp não é este servidor

/pt/mcp continua sendo a rota do agente no produto (visitantes sem login são redirecionados). Esta página de instalação é /pt/docs/mcp. O endpoint HTTP MCP é só /api/mcp.

Documentação da API · SDK · Documentação de agentes · Criar uma chave API