インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、Iterable をワンクリックで追加して、AI クライアント（Claude、ChatGPT、Copilot、Cursor）を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
AI から Iterable を操作できます。ユーザーとそのイベントやメッセージの確認、リスト、キャンペーンと指標、テンプレート、カタログの分析に加え、プロフィールの更新、イベントの記録、リスト登録の管理、そしてあなたの確認後にトリガーメールの送信もできます。
こう聞いてみよう
Iterable のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Iterable をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Iterable + Gemini
AI から Iterable を操作できます。ユーザーとそのイベントやメッセージの確認、リスト、キャンペーンと指標、テンプレート、カタログの分析に加え、プロフィールの更新、イベントの記録、リスト登録の管理、そしてあなたの確認後にトリガーメールの送信もできます。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
ITERABLE_API_URL, ITERABLE_API_KEY
ステップ 1 — 認証情報を取得
設定は 3 分ほどで終わります。プロジェクトで API キーを作成できる Iterable ユーザーと、プロジェクトが米国と EU のどちらでホストされているかの情報が必要です。
- Iterable のプロジェクト設定で Integrations → API Keys を開き、New API Key をクリックします。AI に読み書きさせるなら Server-side キー、読み取りだけなら Read-only キーを選びます。JavaScript キーと Mobile キーは使えません。
- キーをコピーして
ITERABLE_API_KEYに貼り付けます。キーは 1 つのプロジェクトに属するので、1 つのコネクタは 1 つの Iterable プロジェクトを扱います。キーはApi-Keyヘッダーで Iterable にだけ送られます。 ITERABLE_API_URLにプロジェクトのデータセンターを設定します。米国のプロジェクトはhttps://api.iterable.com、EU のプロジェクト（app.eu.iterable.com でサインインするもの）はhttps://api.eu.iterable.comで、/apiなどのパスは付けません。- コネクタをインストールし、まず
iterable_list_channelsを実行します。キーを確認し、プロジェクトのマーケティングチャネルとトランザクションチャネルを表示します。
プロジェクト全体で 1 つのキー: キーは個人ではなくプロジェクトとして動作します。このコネクタを使う人は、キーが読めるすべてのユーザーとキャンペーンを見られます。MCP サーバーは、それを見てよい人とだけ共有してください。
対応範囲: メールアドレスまたは userId によるユーザープロフィールと全フィールド、最近のイベント（カスタムイベント、購入、送信、開封、クリック、バウンス、配信停止）、送信済みメッセージ。リストのサイズとメンバー。キャンペーンの詳細と指標。テンプレート、チャネル、メッセージタイプ、カタログとそのアイテム。キャンペーン指標はキャンペーンごとに 1 行の表で返り、送信数、配信数、ユニーク開封とクリック、バウンス、苦情、配信停止、購入、売上が含まれます。
変更はあなたの承認後: AI は書き込む内容を示し、変更のたびにあなたの確認を待ちます。
iterable_update_userはプロフィールにフィールドをマージします。変更されたフィールドによって、ユーザーが動的リストに入ったりジャーニーが始まったりすることがあります。iterable_track_eventは登録や予約などのカスタムイベントを記録します。これもジャーニーを開始することがあります。iterable_subscribe_to_listとiterable_unsubscribe_from_listはリストの登録状態を変えます。チャネルのオプション付きで登録解除すると、そのチャネルからの全体的な配信停止と同じになります。iterable_send_emailはトリガーキャンペーンのメールを 1 人に、すぐに、または指定した時刻に実際に送ります。多くの人への送信は、Iterable のキャンペーンで行います。
インストール時はオフ: iterable_delete_user_by_email と iterable_delete_user_by_user_id は、プロフィールとそのデータを完全に削除します。管理者が意図して有効にした場合だけ使えます。Read-only キーでは書き込みはすべて 403 になります。読み取り専用で使うなら書き込みツールをオフにしてください。
メールアドレスか userId か: プロジェクトがメールベース、userID ベース、ハイブリッドのどれかに応じて、AI はユーザーをメールアドレスか userId のどちらかで特定し、同じ呼び出しで両方は使いません。回答内の時刻はエポックミリ秒です。
プロジェクトごとの制限: ほとんどの読み取りは 1 秒 100 回、キャンペーン指標は 1 分 10 回、リストのサイズとメンバーは 1 分 5 回、送信済みメッセージは 1 秒 3 回までです。大きなリストのメンバーは約 100 KB で切り詰められるため、AI は先にリストのサイズを確認します。
よくあるエラー: 401「Invalid API key」は、キーが間違っているか削除された、JavaScript キーか Mobile キーである、または別のデータセンターのキーであることを示します。ITERABLE_API_URL を確認してください。BadParams や RequestFieldsTypesMismatched などのコード付きの 400: パラメータかフィールドの型が誤っています。メッセージに該当箇所が示されます。404 または NotFound: そのユーザー、リスト、キャンペーンはこのプロジェクトにありません。429: レート制限に達しました。少し待って再試行してください。
このコネクタはエクスポートジョブやバルクエンドポイントを使わず、テンプレートやスニペットの編集、実験やジャーニーの管理、アプリ内・プッシュ・SMS・Web プッシュの送信、メッセージタイプごとの購読変更、カタログの変更は行いません。
ステップ 2 — アダプターをインストール
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
ステップ 3 — Gemini にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、
YOUR_MCP_API_KEYと置き換えます。 - ファイルを保存し、
geminiを再起動します。 - Gemini CLI で
/mcpを実行します（またはシェルでgemini mcp list）。anythingmcpが接続済みとして表示されるはずです。 - プロンプトを入力しましょう。Gemini CLI が
Iterableのツールを呼び出せるようになりました。
利用可能なツール
| Tool | What it does |
|---|---|
iterable_list_lists | List the user lists of the Iterable project: id, name, type (Standard, Dynamic, Suppression, Internal), description and creation time… |
iterable_get_list_size | Count the users in one Iterable list |
iterable_list_list_users | Get the users of one Iterable list as plain text, one email (or userId) per line |
iterable_get_user_by_email | Get an Iterable user profile by email: email, userId and all dataFields (profile fields, subscription and channel settings, signup date and… |
iterable_get_user_by_id | Get an Iterable user profile by userId: email, userId and all dataFields |
iterable_get_user_events_by_email | Get the latest events of an Iterable user by email, newest first: custom events, purchases, email sends, opens, clicks, bounces… |
iterable_get_user_events_by_user_id | Get the latest events of an Iterable user by userId, newest first: custom events, purchases, message sends, opens, clicks, bounces and… |
iterable_get_sent_messages | List the messages Iterable sent to a user (by email or userId): message id, campaign id, template id and time, optionally filtered by… |
iterable_list_campaigns | List the campaigns of the Iterable project, a page at a time: id, name, type (Blast or Triggered), state, message medium, template, lists… |
iterable_get_campaign | Get one Iterable campaign by id: name, type, state, message medium, template id, send size, lists and suppression lists, labels, workflow… |
iterable_get_campaign_metrics | Get campaign metrics from Iterable as CSV text: one row per campaign with columns such as total sends, deliveries, unique opens and clicks… |
iterable_list_templates | List the message templates of the Iterable project, a page at a time: template id, name, message type, campaign, creator, created and… |
iterable_list_channels | List the message channels of the Iterable project: id, name, channel type (Marketing or Transactional) and medium (Email, Push, SMS) |
iterable_list_message_types | List the message types of the Iterable project: id, name, channel id, subscription policy (opt-in or opt-out), frequency cap and rate limit |
iterable_list_catalogs | List the catalog names of the Iterable project (catalogs hold products, articles or other items used for personalization) |
iterable_list_catalog_items | List the items of one Iterable catalog, a page at a time: item id, last modified time and the item's fields |
iterable_update_user | Create or update an Iterable user profile by email or userId: the dataFields given are merged into the profile, missing fields are kept |
iterable_track_event | Record a custom event for an Iterable user (by email or userId), such as a signup, a booking or a page view, with its data |
iterable_subscribe_to_list | Add users to a static Iterable list (by email or userId), creating profiles that do not exist unless update_existing_users_only is true |
iterable_unsubscribe_from_list | Remove users from a static Iterable list (by email or userId) |
iterable_send_email | Send the email of a triggered Iterable campaign to one user (by email or userId), now or at send_at, with dataFields for the template |
iterable_delete_user_by_email | Delete an Iterable user by email, asynchronously (email-based and hybrid projects) |
iterable_delete_user_by_user_id | Delete Iterable users by userId, asynchronously; every profile with that userId is removed for good |
プロンプトの例
- 「Iterable で [email protected] を調べて。プロフィールのフィールド、直近 20 件のイベント、今月メールを送ったキャンペーンを見せて。」
- 「直近 5 件のブラストキャンペーンの送信数、ユニーク開封、ユニーククリック、配信停止を表で比較して。」
- 「VIP Newsletter リストには何人いる？Welcome キャンペーンはどのテンプレートを使っている？」
- 「[email protected] を Beta testers リストに追加して、beta_signup イベントを記録して。ただし書き込む内容を先に見せて。」
FAQ
Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。
次のステップ
このガイドは役に立ちましたか?
