No install? Use cloud.anythingmcp.com directly.
Sign in, install the WhatsApp Business Cloud API in one click, paste the credentials, mint an MCP API key — done. No Docker, no git clone, no local server to run.
💡 インストール不要? 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）。