MCP 経由で Interakt を Cursor に接続する方法

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

Interakt + Cursor

Interakt の WhatsApp Business アカウントで AI が作業できます：承認済みテンプレートの一覧、属性とタグ付きの顧客の検索と一覧、顧客の追加と更新、イベントの記録、チャットの割り当て。テンプレートメッセージとテキストメッセージの送信はインストール時にオフです。

前提条件

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

INTERAKT_API_KEY

ステップ 1 — 認証情報を取得

設定は約 2 分で終わります。Growth プラン以上の Interakt アカウントが必要です。API が使えるのはこのプランからです。

1. Interakt で Settings → Developer Setting を開きます。
2. Secret Key を、表示されているとおり、前に Basic を付けずに INTERAKT_API_KEY にコピーします。キーはすでにエンコードされており、コネクターは api.interakt.ai にだけ送信します。
3. コネクターをインストールし、interakt_list_templates を実行します。WhatsApp テンプレートが一覧表示され、キーとプランが有効であることを確認できます。

電話番号: ほとんどのツールは、国番号を除いた番号と国番号を別々に受け取ります（例：9876543210 と +91、既定はインド）。自由テキストのツールは + なしの完全な番号を受け取ります（例：919876543210）。

読み取れる内容: WhatsApp テンプレート（コード名、表示名、言語、カテゴリ、承認状態、ヘッダー、プレースホルダー付きの本文、フッター、ボタン）、電話番号または Interakt ID で探す顧客（名前、メール、WhatsApp のオプトイン、独自の属性などの属性、タグ、作成日時と最終更新日時）、そして指定期間に作成・更新された顧客（100 件ずつ）です。

メッセージ履歴はなし: Interakt の API は過去のメッセージや配信状況を返しません。これらは Interakt の Webhook にしか届きません。そのため AI は、顧客がメッセージを読んだかどうかを確認できません。

変更の前に必ず確認: interakt_upsert_customer は顧客を作成するか、同じ番号の顧客を更新します（属性はマージされ、タグは追加のみで削除されません）。interakt_track_event は Order Placed などのイベントを顧客のタイムラインに記録し、顧客にメッセージを送る Interakt のオートメーションが起動することがあります。interakt_assign_chat は共有受信箱の顧客チャットを、メールアドレスで指定したチームメンバーに割り当てます。AI は対象の顧客と正確な変更内容を示し、あなたの承認を待ちます。

インストール時はオフ: interakt_send_template と interakt_send_text。メッセージはすぐに顧客に届き、テンプレートの会話には Meta の料金がかかります。自由テキストを送れるのは顧客の最後のメッセージから 24 時間以内だけで、それを過ぎると Interakt は拒否し、承認済みテンプレートしか使えません。テンプレートにはプレースホルダー（{{1}}、{{2}} など）ごとにちょうど 1 つずつ値を順番に渡す必要があるため、AI はまずテンプレートを読んで数を確認します。画像や文書のヘッダーがあるテンプレートには、ファイルの公開リンクも必要です。これらのツールは管理者が意図して有効にし、有効にした後も AI はテンプレートまたは本文、番号、値を示してあなたの承認を待ちます。成功の応答は Interakt がメッセージを受け付けたという意味で、配信されたという意味ではありません。

制限: Interakt のリクエスト上限は Growth で毎分 300 件、Advanced で毎分 600 件で、1 回のリクエストは最大 32 KB です。429 が返ったら、AI は 1 分待ってから再試行します。

よくあるエラー: 401 はキーが間違っているか、プランに API アクセスがないことを示します。Basic を付けずに Secret Key をコピーし直し、Growth 以上のプランか確認してください。400 は項目の不足や誤りを示し、Interakt のメッセージがどの項目かを示します。たとえば "Missing variable values for template's body" はテンプレートの値が足りないことを意味します。429 はレート制限に達したことを示します。

このコネクターは、テンプレートの作成、キャンペーンの実行、メディアのアップロード、RCS や SMS への切り替え、Webhook の管理は行いません。

ステップ 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 — Cursor にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:

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

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧にあり接続済みであることを確認します。
4. チャットを始めましょう。エージェントが Interakt のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「顧客 +91 98765 43210 を探して、名前、タグ、WhatsApp の受信に同意しているかを見せてください。」
• 「承認済みテンプレートのうちマーケティング用はどれですか。それぞれ必要なプレースホルダーの数も教えてください。」
• 「昨日 Interakt で追加または更新された顧客を一覧にしてください。」
• 「+91 98765 43210 に、注文番号 1042、合計 Rs 1,499 の Order Placed イベントを記録してください。先に内容を見せてください。」
• 「Rahul Sharma（+91 99887 76655）のチャットを [email protected] に割り当ててください。実行前に確認させてください。」

FAQ

Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続