Skip the install. Get this working in under 2 minutes.
Start a free trial on cloud.anythingmcp.com, add the WhatsApp Business Cloud API in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.
Summary
Meta の WhatsApp Business Cloud API を AnythingMCP で MCP サーバーとして公開。テキスト、テンプレート、メディア(画像/音声/ボイス/動画/ドキュメント)、位置情報、インタラクティブボタン、ビジネスプロファイル管理のすぐ使える 14 ツール。Bearer 認証、SDK 不要、クライアントコード不要。
こう聞いてみよう
WhatsApp Business Cloud API のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → WhatsApp Business をクリック、永続的な System User アクセストークンと WhatsApp Business Account ID を貼り付け、MCP API キーを発行 — 完了です。Docker も
git cloneもローカルサーバーも不要。下のローカルインストール手順はスキップして、クライアント接続セクションに直接進めます。
Model Context Protocol 上の WhatsApp Business
WhatsApp Business Cloud API は Meta がホストする公式ゲートウェイで、WhatsApp メッセージをプログラムから送信できます — テキスト、事前承認済みテンプレート、メディア、位置ピン、インタラクティブボタンフロー、ビジネスプロファイル管理。AnythingMCP はこれを MCP サーバーとしてラップするので、Claude、ChatGPT、Copilot、独自エージェントなど、どのエージェントからも自然言語で操作できます。
WhatsApp adapter は組み込み済みです。維持する SDK もクライアントコードもありません。エンジンが Bearer トークン認証を処理し、Meta の messaging_product=whatsapp スキーマに正確に一致するリクエストをすべてのメッセージタイプで生成します。
AnythingMCP なしで WhatsApp が面倒な理由
| ステップ | WhatsApp Cloud API が要求するもの |
|---|---|
| 1 | Meta Business Suite で永続的な System User アクセストークンを生成(一時的な 24 時間 dev トークンとは別)。権限は whatsapp_business_messaging + whatsapp_business_management |
| 2 | WhatsApp Business Account (WABA) 配下の各送信番号の phoneNumberId を取得 |
| 3 | メッセージタイプごとに正しい JSON ボディを構築 — text/template/image/audio/video/document/location/interactive — それぞれ独自のスキーマとフィールド配置の癖がある |
| 4 | 現在サポートされている Graph API バージョンを使用(v15 は終了、v20 は 2026 年 9 月期限。adapter は v22.0 を使用) |
| 5 | 24 時間カスタマーサービスウィンドウを尊重 — その外では事前承認済みテンプレートのみ送信可能 |
これらすべてが BEARER_TOKEN 認証プロファイル + 14 個のメッセージシェイプツールとして、adapter spec の JSON で一度宣言されます。維持するクライアントコードはありません。
インストール
git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && docker compose up -d
http://localhost:3000/connectors/store を開き、WhatsApp Business を選んで以下を入力:
| フィールド | 値 |
|---|---|
WHATSAPP_ACCESS_TOKEN | 永続的な System User アクセストークン |
WHATSAPP_BUSINESS_ACCOUNT_ID | あなたの WABA ID(例: 123456789012345) |
Profile → MCP API Keys から MCP API キーを発行し、エージェントを http://localhost:4000/mcp に向けます。
利用可能なツール (14)
| ツール | 機能 |
|---|---|
whatsapp_list_phone_numbers | WABA 上の各番号の phoneNumberId を取得 |
whatsapp_list_message_templates | 承認済みテンプレートとコンポーネントを一覧 |
whatsapp_get_message_template | テンプレートを ID で取得 |
whatsapp_send_text_message | フリーフォームのテキストを送信(24 時間ウィンドウ内のみ) |
whatsapp_send_template_message | 事前承認済みテンプレートを送信(常時許可) |
whatsapp_send_image | 公開 URL または media ID で JPG/PNG を送信 |
whatsapp_send_audio | 音声ファイルを送信 — OGG-Opus は本物のボイスノートとして表示 |
whatsapp_send_video | MP4/3GPP 動画を送信 |
whatsapp_send_document | PDF/DOC/XLS をオプションのファイル名付きで送信 |
whatsapp_send_location | 位置情報を送信 |
whatsapp_send_interactive_buttons | 1–3 個の返信ボタンを送信 |
whatsapp_mark_message_as_read | 既読確認(青いダブルチェック)を送信 |
whatsapp_get_business_profile | 公開ビジネスプロファイルを読み取り |
whatsapp_update_business_profile | about/住所/email/Web サイトを更新 |
24 時間ウィンドウの解説
WhatsApp は カスタマーサービスウィンドウ を強制します: フリーフォームメッセージ(テキスト、メディア、インタラクティブ、位置情報)は、ユーザーが最後にあなたの番号にメッセージを送信してから 24 時間以内のみ許可されます。そのウィンドウ外では 事前承認済みテンプレート のみが許可されます — Meta Business Suite でテンプレートを作成し、承認を待ち、whatsapp_send_template_message をテンプレート名と言語コードで呼び出します。
adapter はウィンドウを追跡しません。API を呼び出すだけです。ウィンドウ外でフリーフォームテキストを送信しようとすると、Meta はエラー 131047「Re-engagement message」を返します。adapter の instructions フィールドがこのルールを説明するので、エージェントはテンプレートに切り替えるタイミングを知ることができます。
メディア — URL vs アップロード
WhatsApp は 2 つの方法でメディアを受け入れます: バイナリを /PHONE_NUMBER_ID/media にアップロードして media_id を取得するか、公開 HTTPS の link を渡すかです。AnythingMCP は link 方式 を推奨します。なぜなら REST エンジンは multipart upload + send のステップを単一のツールコールでオーケストレーションしないからです。CDN や署名付き URL バケットにファイルをホストし、URL を whatsapp_send_image / audio / video / document に渡してください。mediaId フィールドは、別の場所で事前アップロードする場合のエスケープハッチとして利用できます。
受信メッセージ — スコープ外
このコネクタは 送信専用 です。WhatsApp は受信メッセージを Webhook 経由で配信し、それは自分でホストする必要があります。AnythingMCP の現在のアーキテクチャはリクエスト/レスポンスです。ユーザーメッセージに返信するチャットボットが必要な場合は、AnythingMCP の隣に小さな Webhook 受信機を実行し、このコネクタは送信側に使用してください(既読確認には whatsapp_mark_message_as_read)。
次のステップ
このガイドは役に立ちましたか?