Whatsapp Business を Cursor に接続する方法 — MCP 経由

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → WhatsApp Business をクリック、永続的な System User アクセストークンと WhatsApp Business Account ID を貼り付け、MCP API キーを発行 — 完了です。Docker も git clone もローカルサーバーも不要。下のローカルインストール手順はスキップして、クライアント接続セクションに直接進めます。

WhatsApp Business を Cursor に接続

WhatsApp Business Cloud API は Meta がホストするゲートウェイで、WhatsApp メッセージをプログラムから送信できます — テキスト、テンプレート、メディア、ボイスノート、インタラクティブボタン、位置情報。AnythingMCP を使えば、Cursor からすべてを自然言語で操作できます。SDK を組み込む必要も、メッセージタイプごとに JSON を手書きする必要もありません。

できること

• 「『ご注文は発送されました — 追跡: https://acme.com/t/12345』を +81 90 1234 5678 に送って。」
• 「order_confirmation テンプレート（en_US）を +81 90 1234 5678 に送って、'John' と 'ORD-9912' を埋めて。」
• 「https://acme.com/inv/9912.pdf の請求書 PDF をキャプション『Invoice 9912』付きで顧客に送って。」
• 「私の WABA の承認済みテンプレートを一覧して、この新規リードに日本語でウェルカムテンプレートを送って。」

前提条件

• WhatsApp Business Account (WABA) に少なくとも 1 つの認証済み送信番号があること。
• whatsapp_business_messaging + whatsapp_business_management 権限を持つ 永続的な System User アクセストークン（一時的な 24 時間 dev トークンはテスト用には機能しますが期限切れになります）。
• AnythingMCP をローカルまたは cloud.anythingmcp.com で実行（3 分のセットアップ）。
• Cursor がインストールされていること。

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

1. https://developers.facebook.com/ → 自分の App → WhatsApp → API Setup を開きます。WhatsApp Business Account ID（WABA ID）をメモします。
2. Meta Business Suite → Business Settings → System Users に移動し、System User を作成、WABA を割り当て、whatsapp_business_messaging + whatsapp_business_management 権限で 新しいトークンを生成 します。コピーしてください — 再表示はされません。
3. 送信用の電話番号が API Setup で 認証済み であることを確認します（テスト番号はすぐに機能します。本番では自分の番号を追加して認証してください）。

ステップ 2 — WhatsApp Business adapter をインストール

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

http://localhost:3000/connectors/store を開き、WhatsApp Business をクリックして以下を入力:

Install をクリック — adapter が 14 ツールでカタログに追加されます。

ステップ 3 — phoneNumberId を一度取得

Cursor に whatsapp_list_phone_numbers を呼び出すよう依頼します（businessAccountId に WABA ID を指定）。各送信番号の id が返ってきます — その値をピン留めしてください。すべての送信ツールが phoneNumberId として必要とします。

ステップ 4 — 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. チャットを始めましょう — エージェントが WhatsApp Business のツールを呼び出せるようになりました。

利用可能なツール（合計 14）

24 時間ウィンドウ — エージェントが知っておくべきこと

WhatsApp は フリーフォーム メッセージ（テキスト、メディア、インタラクティブ、位置情報）を、ユーザーがあなたの番号にメッセージを送ってから 24 時間 以内のみ許可します。そのウィンドウ外では 事前承認済みテンプレート のみ許可されます — テンプレート名と言語で whatsapp_send_template_message を呼び出します。

adapter の instructions フィールドが Cursor にこのルールを伝えるので、ユーザーの最後の返信から数日後に「あの顧客にフォローアップを送って」と頼んだとき、Cursor はフリーフォームテキストではなく whatsapp_send_template_message を使用します。

ボイスノート

公開 HTTPS URL でホストされた OGG-Opus ファイルへの link を使って whatsapp_send_audio を呼び出します。WhatsApp は OGG-Opus を本物のボイスメッセージ（波形 + 再生ボタン）として表示します。MP3 と AMR も機能しますが、通常の音声添付として表示されます。

FAQ

認証済みのビジネス番号なしで動作しますか? Meta のテスト番号はテスト用に機能します（テスターとして追加された番号にのみ送信）。本番で任意の受信者に送信するには、送信番号が WABA で認証・登録されている必要があります。

24 時間ウィンドウ外でフリーフォームテキストを送るとどうなりますか? Meta はエラーコード 131047（「Re-engagement message」）を返します。whatsapp_send_template_message を使用してください。

adapter は受信メッセージを受け取れますか? 直接は不可能です — Meta は受信メッセージに Webhook を使用し、AnythingMCP REST エンジンは送信専用です。AnythingMCP の隣に小さな Webhook 受信機を実行し、このコネクタは送信側と既読確認の whatsapp_mark_message_as_read に使用してください。

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

次のステップ

• コネクタ ランディング
• 接続: Claude
• 接続: ChatGPT
• 接続: Gemini
• 接続: Meta Muse