Cómo conectar Heap a Gemini — via MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Heap, pega tus credenciales, genera una MCP API key — listo. Sin Docker, sin git clone, sin servidor local.

Heap + Gemini

Envía eventos, identifica usuarios y actualiza propiedades en Heap (analítica de producto) desde cualquier agente de IA. 5 herramientas, autenticación basada en app_id.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

HEAP_APP_ID

Paso 1 — Obtener credenciales

Setup:

1. Sign in to https://app.heap.io → top-right → Account → Projects → select project → Project ID (called app_id).
2. Set HEAP_APP_ID to the numeric app/project ID.

Authentication: NONE — Heap's server-side API uses the app_id in the request body to route events to your project. There's no secret on the ingestion endpoint (anyone with your app_id can fake events — same trust model as Google Analytics client-side JS).

…(continued in the in-app connector instructions)

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee servidores MCP desde ~/.gemini/settings.json (o %APPDATA%\gemini\settings.json en Windows). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Obtén tu MCP API key desde AnythingMCP → MCP Servers → tu servidor → API keys.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp en la Gemini CLI — Heap debería aparecer como disponible.
4. Vertex AI Studio: pasa https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID al array tools de tu petición con el mismo header X-API-Key.

Herramientas disponibles

FAQ

¿Gemini 1.5 Pro o 2.x soportan MCP? Sí — Gemini CLI ≥ 0.4 y la API de tools de Vertex AI aceptan conectores MCP httpUrl con header personalizzati.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse