Connector guide2-minute read5 MCP toolsEnglish · Deutsch · Italiano

Heap を Gemini に接続する方法 — 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

Public API

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

TL;DR

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

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Heap をクリック、認証情報を貼り付け、MCP API キーを発行 — 完了です。Docker も git clone もローカルサーバーも不要。

Heap + Gemini

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

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

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 — アダプターをインストール

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

ステップ 3 — Gemini にコネクタを追加

Gemini CLI は ~/.gemini/settings.json (Windows は %APPDATA%\gemini\settings.json) から MCP サーバを読み込みます。追加:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_API_KEY" }
    }
  }
}
  1. AnythingMCP の Profile → MCP API Keys → New KeyMCP API key を取得。
  2. ファイルを保存し gemini を再起動。
  3. Gemini CLI で /mcp を実行 — Heap が利用可能として表示されます。
  4. Vertex AI Studio: 同じ Bearer ヘッダーで https://cloud.anythingmcp.com/mcp をリクエストの tools 配列に渡してください。

利用可能なツール

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

Gemini 1.5 Pro / 2.x は MCP をサポートしますか? はい — Gemini CLI ≥ 0.4 と Vertex AI tools API は Bearer ヘッダー付きの httpUrl MCP コネクタを受け入れます。

次のステップ

このガイドは役に立ちましたか?

Ready to ship

Your Heap agent is one click away.

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

関連ガイド