Connector guide2-minute read5 MCP toolsEnglish · Deutsch · Italiano

Come collegare Heap a Claude — via MCP

Send events, identify users and update properties in Heap (product analytics) from any AI agent. 5 tools, app_id-based auth.

HCBy HelpCode teamUpdated 2 min read Open source on GitHub

No credit card · 7-day trial · Self-host alternative available

MCP connector

Heap

Send events, identify users and update properties in Heap (product analytics) from any AI agent. 5 tools, app_id-based auth.

Tools

5

Region

INTL

Category

analytics

Authentication

Required env vars

HEAP_APP_ID
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Source-available BSL-1.1
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

No install? Use cloud.anythingmcp.com directly.

Sign in, install the Heap in one click, paste the credentials, mint an MCP API key — done. No Docker, no git clone, no local server to run.

Open Cloud

💡 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 + Claude

Send events, identify users and update properties in Heap (product analytics) from any AI agent. 5 tools, app_id-based auth.

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

heap.io/docs/server-side-apis).

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

git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && docker compose up -d

Step 3 — Aggiungi il connettore in Claude

Percorso consigliato — funziona su claude.ai web senza toccare alcun file di configurazione.

  1. Apri claude.ai/customize/connectors.
  2. Clicca "Add custom connector".
  3. Compila:
    • Name: Heap
    • URL: https://cloud.anythingmcp.com/mcp
    • Authentication: Bearer token → incolla la tua MCP API key (da AnythingMCP → Profile → MCP API Keys → New Key)
  4. Clicca Connect per autorizzare.

Tutti i tool sotto compaiono nella tua chat — inizia a scrivere prompt.

Tool disponibili

ToolWhat it does
heap_track_eventTrack a single behavioral event for a user
heap_bulk_trackBulk-track many events in one call (up to 1000 events, 1MB total)
heap_add_user_propertiesSet or update user-level properties (Heap merges with existing)
heap_add_account_propertiesSet or update properties on an account (B2B model — accounts group users)
heap_add_user_to_accountAssociate a user (identity) with an account (account_id)

FAQ

Funziona con Claude Code come con Claude Desktop? Sì — punta entrambi a https://cloud.anythingmcp.com/mcp.

Prossimi passi

Ready to ship

Your Heap agent is one click away.

Install the connector, paste the key, prompt Claude. Free for 7 days, no credit card.