WhatsApp Business を Claude に接続する方法 — MCP 経由で Claude から WhatsApp 送信

Q: 24 時間ウィンドウ外でフリーフォームテキストを送るとどうなりますか?

Meta はエラーコード `131047`（「Re-engagement message」）を返します。`whatsapp_send_template_message` を使用してください。

Q: Claude Code は Claude Desktop と同じように動作しますか?

はい — 同じ MCP URL です。

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.

Open Cloud

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

WhatsApp Business を Claude に接続

WhatsApp Business Cloud API は Meta がホストするゲートウェイで、WhatsApp メッセージをプログラムから送信できます — テキスト、テンプレート、メディア、ボイスノート、インタラクティブボタン、位置情報。AnythingMCP を使えば、Claude Desktop、Claude Code、claude.ai からすべてを自然言語で操作できます。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 分のセットアップ）。
Claude Desktop、Claude Code、または claude.ai アカウント。

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

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

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

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`）

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

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

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

ステップ 4 — Claude にコネクタを追加（コード不要、4 クリック）

推奨ルート — 設定ファイルを触らずに claude.ai web で動作します。

claude.ai/customize/connectors を開きます。
"Add custom connector" をクリック。
以下を入力:
- Name: WhatsApp Business
- URL: https://cloud.anythingmcp.com/mcp
- Authentication: Bearer token → MCP API キーを貼り付け（AnythingMCP → Profile → MCP API Keys → New Key）
Connect をクリックして認可。

完了です。14 個の WhatsApp ツールがチャットに表示されます — プロンプトを入力し始めてください。

上級: Claude Desktop / Claude Code (JSON / CLI)

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %AppData%\Claude\claude_desktop_config.json（Windows）を編集:

{
  "mcpServers": {
    "whatsapp-business": {
      "url": "https://cloud.anythingmcp.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_API_KEY"
      }
    }
  }
}

Claude Desktop を再起動。WhatsApp ツールが 🔧 メニューに表示されます。

Claude Code — CLI コマンド 1 つ:

claude mcp add whatsapp-business \
  --transport http \
  --url https://cloud.anythingmcp.com/mcp \
  --header "Authorization: Bearer YOUR_MCP_API_KEY"

claude mcp list で確認。

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

グループ	ツール
検出	`whatsapp_list_phone_numbers`, `whatsapp_list_message_templates`, `whatsapp_get_message_template`
テキストとテンプレート	`whatsapp_send_text_message`, `whatsapp_send_template_message`
メディア（URL または media ID）	`whatsapp_send_image`, `whatsapp_send_audio`, `whatsapp_send_video`, `whatsapp_send_document`
インタラクティブと位置情報	`whatsapp_send_location`, `whatsapp_send_interactive_buttons`
既読確認とプロファイル	`whatsapp_mark_message_as_read`, `whatsapp_get_business_profile`, `whatsapp_update_business_profile`

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

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

adapter の instructions フィールドが Claude にこのルールを伝えるので、ユーザーの最後の返信から数日後に「あの顧客にフォローアップを送って」と頼んだとき、Claude はフリーフォームテキストではなく 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 に使用してください。

Claude Code は Claude Desktop と同じように動作しますか? はい — 同じ MCP URL です。