Connector guide2-minute read5 MCP toolsEnglish · Deutsch · Italiano

如何将 Heap 连接到 ChatGPT — 通过 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

💡 无需安装? 直接使用 cloud.anythingmcp.com 登录、点击 Connectors → Heap、粘贴凭证、生成 MCP API key — 完成。无 Docker、无 git clone、无本地服务器。

Heap + ChatGPT

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

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

HEAP_APP_ID

步骤 1 — 获取凭证

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)

步骤 2 — 安装 adapter

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

步骤 3 — 在 ChatGPT 中添加连接器

ChatGPT 通过 Connectors 功能 (Plus / Pro / Team / Enterprise 套餐) 支持 MCP 服务器。免费套餐不支持自定义连接器。

  1. 打开 ChatGPT → Settings → Connectors (或点击 composer 中的 🔧 图标 → Manage connectors)。
  2. 点击 "Add custom connector"
  3. 填入:
    • Name: Heap
    • MCP server URL: https://cloud.anythingmcp.com/mcp
    • Authentication: Bearer token → 粘贴 MCP API key
  4. 点击 Connect

可用工具

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

ChatGPT 免费套餐能用自定义 MCP Connectors 吗? 不能 — 需要 Plus、Pro、Team 或 Enterprise。

下一步

Ready to ship

Your Heap agent is one click away.

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