Come collegare Heap a Gemini — via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Heap, inserisci le credenziali, genera una MCP API key — fatto. Niente Docker, niente git clone, niente server locale.

Heap + Gemini

Invia eventi, identifica utenti e aggiorna proprietà in Heap (analisi di prodotto) da qualsiasi agente AI. 5 strumenti, autenticazione basata su app_id.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

HEAP_APP_ID

Step 1 — Ottieni le credenziali

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)

Step 2 — Installa l'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

Step 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (o %APPDATA%\gemini\settings.json su Windows). Aggiungi:

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

1. Ottieni la tua MCP API key da AnythingMCP → MCP Servers → il tuo server → API keys.
2. Salva il file e riavvia gemini.
3. Esegui /mcp nella Gemini CLI — Heap dovrebbe essere elencato come disponibile.
4. Vertex AI Studio: passa https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID nell'array tools della richiesta con lo stesso header X-API-Key.

Tool disponibili

FAQ

Gemini 1.5 Pro o 2.x supportano MCP? Sì — Gemini CLI ≥ 0.4 e la Vertex AI tools API accettano connettori MCP httpUrl con header personalizzati.

Prossimi passi

• Pagina del connettore
• Collega a Claude
• Collega a ChatGPT
• Collega a Cursor
• Collega a Meta Muse