WhatsApp Business Tools MCP：WhatsApp BusinessをAIエージェントに接続する方法

WhatsApp Business向けMeta公式MCPサーバー：エージェントができること、Claude Codeでの接続コマンド、CodexとChatGPTでの設定、ベータ版の制限を解説します。

記事の全文を読む

2026年9月15日、Metaは公式のWhatsApp Business Tools MCPサーバーを公開しました。このサーバーは、Claude Code、Codex、ChatGPT、CursorなどのAIエージェントをWhatsApp Business Platformに接続します。Developer Console、Business Manager、APIドキュメントを行き来する代わりに、エージェントに作業内容を伝えるだけで、電話番号の追加、メッセージテンプレートの作成、Webhookの設定、テストメッセージの送信を行えます。

サーバーはまだベータ版です。アクセスは段階的に提供されており、このリリースは開発とテストを目的としています。大規模な本番メッセージ配信向けではありません。以下では、4つのクライアントでの準備と接続手順を説明します。コマンドと設定は、2026年9月18日時点のMeta公式ドキュメントに照らして確認しました。

Ailootの利用方法については、ドキュメントをご覧ください。

WhatsApp Business Tools MCPとは？

重要なポイント

これはMeta公式のリモートMCPサーバーで、AIエージェントにWhatsApp Business Platformを管理するためのツールを提供します。対象はアカウント、電話番号、メッセージテンプレート、Webhook、テスト送信です。アクセスにはOAuthを使います。Metaアカウントでサインインし、サーバーに操作を許可するビジネスを選択します。

MCP（Model Context Protocol）は、外部システムをAIエージェントに接続するためのオープン規格です。詳しくは、Claude Code向けMCPサーバー：すぐに使える7つの連携の記事をご覧ください。インストールコマンド付きの検証済み連携は、MCPカタログに掲載されています。

このリリース以前は、WhatsApp連携の設定は次のような流れでした。Developer Consoleを開き、アプリを作成し、ビジネスをリンクし、電話番号を追加し、コードで認証し、トークンを生成し、Webhookを設定し、APIドキュメントを確認してから、ようやく最初のコードを書き始めます。

Metaはこのサーバーの仕組みを次のように説明しています（英語からの翻訳）：

必要なことを伝えると、エージェントがアカウント、電話番号、テンプレート、API呼び出しを自分で特定します。

— Meta for Developers、https://developers.facebook.com/blog/post/2026/09/15/whatsapp-business-messaging-mcp-ai-agent/

現在、Metaには2つのMCPサーバーがあり、混同しやすいので注意してください。Meta Social Technologies MCPは、ドキュメントの検索、Graph APIエンドポイントの発見、アプリのエラー診断などを行う汎用の開発者ツールです。WhatsApp Business Tools MCPは、WhatsAppアカウント、電話番号、テンプレート、Webhook、テストメッセージを扱います。両者は互いに補完するため、必要に応じて両方を接続できます。

接続するとエージェントは具体的に何ができる？

重要なポイント

サーバーは4種類のタスクに対応しています。電話番号を一から設定する場合は、追加、認証コードの送信、認証、登録を行います。メッセージテンプレートでは、作成、編集、承認状況の確認ができます。Webhookでは、コールバックURLを指定し、フィールドを購読します。前提条件の確認では、規約への同意や支払い方法の設定が済んでいないことをエージェントが検出し、問題を解決するための直接リンクを提示します。

サーバーのツールはwhatsapp_biz_というプレフィックスで分類されています。公式ドキュメントによると、次のとおりです。

概要：whatsapp_biz_businesses、whatsapp_biz_accounts、whatsapp_biz_phone_numbers。利用可能なビジネス、アカウント、電話番号を確認します。
電話番号の設定：whatsapp_biz_add_phone_number、whatsapp_biz_send_verification_code、whatsapp_biz_verify_phone_number、whatsapp_biz_register_phone_number。
テンプレート：whatsapp_biz_list_templates、whatsapp_biz_get_template、whatsapp_biz_create_template、whatsapp_biz_update_template、whatsapp_biz_delete_template。
メッセージ：whatsapp_biz_send_message。24時間の会話ウィンドウ内では自由形式のテキストを、それ以外では承認済みテンプレートを送信します。エージェントは送信前に宛先をあなたに確認します。
Webhook：whatsapp_biz_configure_webhooks、whatsapp_biz_subscribe_webhook。
アカウントの設定：whatsapp_biz_configure_payments、whatsapp_biz_verify_business、whatsapp_biz_system_user_token。Cloud APIを直接呼び出すためのシステムユーザートークンを作成するリンクを提示します。

顧客が先にビジネスへメッセージを送ると、カスタマーサービスウィンドウが開きます。この時間内は24時間、自由形式のテキストで返信できます。顧客から新しいメッセージが届くたびに、ウィンドウの期限は延長されます。期限が切れた後は、承認済みテンプレートでのみ顧客に連絡できます。エージェントはこのルールを把握しており、宛先がウィンドウの対象外の場合は、通常のテキストではなくテンプレートの送信を提案します。

サーバーにはアクセス制御が組み込まれています。Metaアカウントでサインインし、特定のビジネスを選択します。トークンは会話履歴に含まれません。各読み取り操作はあなたのコンテキストで実行され、呼び出しはログに記録されます。また、変更を伴う操作には認証済みのユーザーが必要で、サーバーアプリのキーだけでは不十分です。

接続前に確認することは？

重要なポイント

必要な前提条件は3つです。管理対象のMetaビジネスでのMANAGEロール、WhatsAppシナリオが有効なアプリの管理者権限、WhatsApp Business Cloud API規約への同意です。いずれかが不足していると、ツールは問題を説明するエラーと、解決できるページへのリンクを返します。

サーバーはあなたに代わって操作し、あなたのリソースだけを使用します。最初に呼び出す前に、次の項目を確認してください。

管理者（MANAGEロール）であるMetaビジネスがある。
WhatsApp Business Messagingシナリオが有効なMetaアプリ（または旧アプリの場合はWhatsApp製品）があり、そのアプリ自体の管理者である。ビジネスレベルの権限だけでは不十分です。
そのビジネスでWhatsApp Business Cloud APIの規約に同意済みである。同意していないと、電話番号の登録とメッセージ送信がブロックされます。

Metaによると、利用規約、支払い方法、ビジネス認証に関する問題は、明確な説明なしに発生することがよくあります。エージェントは事前にこれらを確認し、規約への同意、支払い方法の指定、ビジネス認証の開始ができる直接リンクを提示します。

Claude Codeにサーバーを接続する方法

重要なポイント

claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_toolsコマンドを実行し、セッション内で/mcpと入力してサーバーを選択し、Metaでサインインします。クライアントを再起動した後は、再度サインインする必要があります。

Claude Codeをまだインストールしていない場合は、まず公式サイトからClaude Codeをインストールする方法をご覧ください。

サーバーを追加する
ターミナルで次を実行します。
```
claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools
```
サーバーはリモートのため、ローカルにインストールする必要はありません。
Metaでサインインする
Claude Codeのセッションで/mcpと入力し、whatsapp_business_toolsを選択します。Metaアカウントにサインインするためのブラウザーウィンドウが開きます。ブラウザーが開かない場合は、クライアントからリンクをコピーして手動で開いてください。
権限を付与する
同意画面で、アクセスを許可するWhatsApp対応のビジネスとアプリを選択します。サーバーは3つの権限を要求します。business_management（管理者であるビジネスの検索）、whatsapp_business_management（アカウント、電話番号、テンプレート、Webhook）、whatsapp_business_messaging（自分の電話番号からのメッセージ送信）です。
接続を確認する
Claude Codeを再起動し、/mcpから再度サインインして、whatsapp_business_toolsサーバーでどのツールを利用できるかエージェントに尋ねます。次に、安全な読み取り操作を行います。「管理できるビジネスの一覧を表示して」と依頼すると、エージェントはwhatsapp_biz_businessesを呼び出します。ツールが表示されない場合やサインインエラーが発生した場合は、サーバーアドレスを確認し、もう一度サインインしてください。

OAuthサインインはクライアントの起動に紐づいているため、Claude Codeの再起動後はもう一度サインインする必要があります。facebook.comの設定にある「Business Integrations」から、いつでもアクセスを取り消せます。

Codex、ChatGPT、Claude Desktopを接続する方法

重要なポイント

3つのクライアントすべてで同じサーバーアドレスとOAuthサインインを使います。異なるのは設定の場所だけです。Codex App：Settings、MCP Serversから、Streamable HTTPサーバーを追加します。ChatGPT：Settings、Pluginsから、URLで追加します。Claude Desktop：Settings、Connectorsから、カスタムコネクターを追加します。

Codex App。 設定（左下の歯車）を開き、MCP Serversに移動して、Add serversを選択します。Streamable HTTPを選び、次を入力します。

Name：WhatsApp Business Tools
URL：https://mcp.facebook.com/whatsapp_business_tools
Authentication：OAuth

Authenticateをクリックし、ブラウザーでサインインします。

ChatGPT。 Settings、Plugins、Browse pluginsの順に開き、右上の「+」アイコンを選択します。名前、同じURL、認証方式としてOAuthを入力します。

Claude Desktop。 Settings、Connectors、Add custom connectorの順に開きます。Name：WhatsApp Business Tools、URL：同じサーバーアドレス。

どのクライアントでも、追加後は同じ手順で確認します。再起動し、もう一度サインインして、ツール一覧を表示し、安全な読み取り操作でビジネス一覧を確認します。

最初のセッションでは何をする？ビジネス一覧からテストメッセージまで

重要なポイント

手順は次のとおりです。ビジネスを一覧表示して1つ選び、そのアカウントと電話番号を確認します。電話番号を追加し、SMSまたは通話で認証コードを送信して、コードで番号を認証し、登録します。テンプレートを作成し、テストメッセージを送信して、Webhookを設定します。SMSで届いたコードは、自分でエージェントに伝えます。

サーバー接続後の一般的な初回セッションは次のとおりです。

「管理しているビジネスの一覧を表示して」—エージェントがwhatsapp_biz_businessesを呼び出すので、必要なビジネスを選びます。
「このビジネスのWhatsAppアカウントと電話番号を表示して」—whatsapp_biz_accountsとwhatsapp_biz_phone_numbersでステータスを確認します。
「テスト用の電話番号をアカウントに追加して」—whatsapp_biz_add_phone_number。
「SMSで認証コードを送信して」—whatsapp_biz_send_verification_code。コードがあなたの電話に届きます。
「コード123456で番号を認証して」—whatsapp_biz_verify_phone_numberを実行し、続けてwhatsapp_biz_register_phone_numberで登録します。
「注文通知用に、受信者が希望する言語でorder_updateテンプレートを作成して」—whatsapp_biz_create_template。エージェントは承認状況へのリンクを提示します。
「自分の番号にテストメッセージを送って」—whatsapp_biz_send_message。エージェントは送信前に宛先を確認します。
「https://example.com/webhookにWebhookを設定して」—whatsapp_biz_configure_webhooksを実行し、whatsapp_biz_subscribe_webhookで購読します。

設定後は、顧客からの受信メッセージが指定したアドレスに届きます。通常、そのアドレスでCRM、カスタマーサポートサービス、またはボットがメッセージを取得します。そのアドレスでの処理は別途構築します。サーバーが行うのは設定だけです。

ベータ版の制限は？

重要なポイント

このサーバーはベータ版です。ツールの種類は変わる可能性があり、アクセスは全員に一斉提供されるのではなく、段階的に提供されています。このリリースは開発とテストを目的としており、大規模な本番メッセージ配信には適していません。ツールごとにユーザー単位のリクエスト制限があり、クライアントを再起動した後は再度サインインが必要です。

サーバーの制限として、次の4点に注意してください。

ベータ版であること。 Metaによると、インターフェースとツールの種類は変更される可能性があり、アクセスは段階的に提供されています。まだサーバーに接続できない場合は、利用可能になっていない可能性があります。

用途。 このリリースは開発とテストを目的としており、本番環境での大量送信を意図していません。本番メッセージ配信には、Cloud APIとの完全な連携が必要です。たとえば、whatsapp_biz_system_user_tokenツールがリンクを提示するシステムユーザートークンを使います。

制限。 ツールごとにユーザー単位のリクエスト制限があります。制限を超えるとツールは制限エラーを返すため、時間をおいて再試行してください。

24時間のウィンドウルール。 顧客との会話ウィンドウの対象外では、承認済みテンプレートのみ送信できます。

ビジネスにとってどのような意味がある？

重要なポイント

これで、エージェントとの1回の会話でWhatsApp連携の初期設定を完了できます。エージェントは手順を把握し、プラットフォームのエラーを理解します。主な用途は、カスタマーサポート、注文や予約の通知、テンプレートの準備です。

小規模ビジネスでよくあるケースを考えてみましょう。顧客がWhatsAppでメッセージを送り、あなたはすばやく返信し、注文状況を通知したいとします。これまでは、Metaの複数のダッシュボードを自分で操作するか、開発者に依頼して初期設定を行う必要がありました。今では、エージェントとの会話でこの作業を完了できます。ただし、受信メッセージを自分のアドレスで処理する部分は別途構築が必要です。Webhookの設定後に行う作業です。

すでに連携を稼働させている場合にも、このサーバーは便利です。新しいプロモーションや通知文など、メッセージテンプレートは定期的に更新する必要があります。サーバーを使えば、エージェントがテンプレートを作成または編集し、ダッシュボードに移動させることなく承認状況を表示します。

エージェントが外部システムに接続し、あなたの説明に沿って操作する同様の方法は、MCP経由でNotebookLMをClaude Codeに接続する方法でドキュメントとともに紹介しています。

次にすること

重要なポイント

前提条件を確認し、1つのコマンドでサーバーを接続してサインインしたら、ビジネス一覧を安全に読み取ります。その後、テスト用の電話番号を追加して最初のメッセージを送信します。ベータ版であることを忘れずに。本番メッセージ配信には、Cloud APIとの完全な連携を準備してください。

発表から3日が経ったこのサーバーは、1つのコマンドで使い始められます。Metaでサインインし、エージェントに自分のビジネス一覧を尋ねましょう。その後、必要に応じて電話番号、テンプレート、Webhook、テストメッセージを設定します。

エージェントを外部システムに接続するその他の方法は、Claude Code向けMCPサーバーのコレクションをご覧ください。さまざまなタスクに使える連携が、ほかに7つあります。

出典

Ailootについて知りましょう。

詳細を見る