Camella · MCP

MCP remoto para lecturas del warehouse

HTTP Streamable en /api/mcp en este mismo host — no es un segundo producto. Auth: Authorization: Bearer cam_live_… (cualquier clave con sesión; las mismas de /api/v1). Sin sesión de cookie del sitio. Sin clave embebida.

Instalación en un clic

Crear una cuenta es gratis. Crear una API key es gratis. Los planes de pago desbloquean límites más altos y cifras financieras.

Cursor tiene un deeplink oficial de instalación. Claude Code y Codex no tienen protocolo de instalación — copia el comando oficial add y exporta CAMELLA_API_KEY. Solo lectura: sin escrituras en v1.

Instalar en Cursor Instalar en Claude Code Instalar en Codex

Después de instalar: get_company EC 1790016919001 (Corporación Favorita).

Endpoint y autenticación

Regístrate gratis, crea una clave cam_live_ en la consola (cualquier cuenta con sesión), expórtala como CAMELLA_API_KEY y envíala en cada petición MCP. Nunca pongas una clave cam_live_ real en una URL o deeplink de instalación.

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

Herramientas (solo lectura)

Estas tres herramientas llaman a los handlers existentes de /api/v1 (búsqueda, entidad y financieros). No hay herramientas de escritura, de contactos ni geo/search_area.

Herramienta	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 la misma puerta de plan que la ruta REST: 403 si el plan no puede ver cifras. Demo: Corporación Favorita EC 1790016919001.

Cursor

Deeplink oficial de instalación de Cursor. El config es base64 de { url, headers } e interpola CAMELLA_API_KEY del entorno — nunca una clave real en la URL. /docs/mcp/cursor hace 307 al wrapper HTTPS para que el clic en el navegador abra Cursor.

Instalar en Cursor/es/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

Sin deeplink oficial de instalación. CLI oficial: claude mcp add --transport http. El header lee CAMELLA_API_KEY del shell — no pegues un secreto cam_live_ en el comando.

Pasos Claude

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

Forma add-json equivalente (misma interpolación Bearer):

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

Codex

Sin deeplink oficial de instalación. La CLI oficial escribe ~/.codex/config.toml. --bearer-token-env-var nombra CAMELLA_API_KEY — Codex envía Authorization: Bearer desde esa variable. El mismo modelo Bearer que /api/v1.

Pasos 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 no es este servidor

/es/mcp sigue siendo la ruta del agente en el producto (los visitantes sin sesión van al login). Esta página de instalación es /es/docs/mcp. El endpoint HTTP MCP es solo /api/mcp.

Documentación de la API · SDK · Documentación de agentes · Crear una clave API