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

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

Source: https://ailoot.ai/blog/ja/whatsapp-business-mcp/
Canonical: https://ailoot.ai/blog/ja/whatsapp-business-mcp/
Language: ja
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-234
Revision: sha256-f466039750ecbe76ee3646aad3b0eae04df71db710558b65d166b4342b0de2cb


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の利用方法については、[ドキュメント](https://ailoot.ai/docs/)をご覧ください。



## WhatsApp Business Tools MCPとは？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

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

</div>

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

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

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

<figure>
<blockquote>
<p>必要なことを伝えると、エージェントがアカウント、電話番号、テンプレート、API呼び出しを自分で特定します。</p>
</blockquote>
<figcaption>— Meta for Developers、https://developers.facebook.com/blog/post/2026/09/15/whatsapp-business-messaging-mcp-ai-agent/</figcaption>
</figure>

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

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

</div>

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



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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

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

</div>

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

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

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

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

</div>

Claude Codeをまだインストールしていない場合は、まず[公式サイトからClaude Codeをインストールする方法](https://ailoot.ai/blog/ja/install-claude-code/)をご覧ください。

1.  ### サーバーを追加する

    ターミナルで次を実行します。

    ```bash
    claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools
    ```

    サーバーはリモートのため、ローカルにインストールする必要はありません。

2.  ### Metaでサインインする

    Claude Codeのセッションで`/mcp`と入力し、`whatsapp_business_tools`を選択します。Metaアカウントにサインインするためのブラウザーウィンドウが開きます。ブラウザーが開かない場合は、クライアントからリンクをコピーして手動で開いてください。

3.  ### 権限を付与する

    同意画面で、アクセスを許可するWhatsApp対応のビジネスとアプリを選択します。サーバーは3つの権限を要求します。`business_management`（管理者であるビジネスの検索）、`whatsapp_business_management`（アカウント、電話番号、テンプレート、Webhook）、`whatsapp_business_messaging`（自分の電話番号からのメッセージ送信）です。

4.  ### 接続を確認する

    Claude Codeを再起動し、`/mcp`から再度サインインして、`whatsapp_business_tools`サーバーでどのツールを利用できるかエージェントに尋ねます。次に、安全な読み取り操作を行います。「管理できるビジネスの一覧を表示して」と依頼すると、エージェントは`whatsapp_biz_businesses`を呼び出します。ツールが表示されない場合やサインインエラーが発生した場合は、サーバーアドレスを確認し、もう一度サインインしてください。

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

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

</div>

**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：同じサーバーアドレス。

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

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

</div>

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

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

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

## ベータ版の制限は？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

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

</div>

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

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

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

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

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

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

</div>

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

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

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

## 次にすること

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

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

</div>

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

エージェントを外部システムに接続するその他の方法は、[Claude Code向けMCPサーバー](https://ailoot.ai/blog/ja/mcp-servers-claude-code/)のコレクションをご覧ください。さまざまなタスクに使える連携が、ほかに7つあります。

<div class="section" role="doc-bibliography" aria-label="出典">

### 出典

- [Meta for Developers：WhatsApp Business Tools MCPの発表（15.09.2026）](https://developers.facebook.com/blog/post/2026/09/15/whatsapp-business-messaging-mcp-ai-agent/)
- [Meta：WhatsApp Business Tools MCPドキュメント](https://developers.facebook.com/documentation/mcp/whatsapp-business-tools-mcp)
- [Meta：開発者向けMCPサーバーの概要](https://developers.facebook.com/documentation/mcp)
- [WhatsApp Business Platform：ドキュメント](https://developers.facebook.com/documentation/business-messaging/whatsapp)

</div>



[Ailoot](https://ailoot.ai/)について知りましょう。

## WhatsApp Business Tools MCP：WhatsApp BusinessをAIエージェントに接続する方法：よくある質問

### 最初の接続確認はどう行うとよいですか？

OAuthでログインしたら、ツール一覧と管理可能な事業者を読み取りで確認します。電話番号の追加、テンプレート作成、Webhook設定、テストメッセージ送信の前に、アクセスを確かめられます。

### Webhookを設定すれば、受信メッセージの処理も完成しますか？

いいえ。MCPサーバーはコールバックと購読を設定しますが、そのアドレスで受信・処理するCRM、サポートサービス、ボットは別途構築する必要があります。


## Ailoot · 企業とそのプロジェクト群

Ailootは、蓄積した運営経験、幅広い顧客基盤、安定したサービス、継続的なKPI管理を基盤としています。

企業とそのプロジェクト群：数百万の顧客、毎月数十億規模の売上。

Ailootはこの運営経験を、お客様の製品、エージェント、アプリケーション、自動化でAI機能を利用するためのAPIアクセスに活かしています。
