WhatsApp Business Tools MCP

npx add-mcp 'https://mcp.facebook.com/whatsapp_business_tools'

WhatsApp Business Tools MCP

對於在 WhatsApp Business Platform (Cloud API) 上開發的開發人員，WhatsApp Business Tools MCP 伺服器可讓您的 AI 代理程式和 IDE 助理在同一處管理及偵錯 WhatsApp Business 整合。它可讓代理程式探索您管理的商家和 WhatsApp 帳號、為電話號碼進行上線和註冊、建立及管理訊息範本、設定 Webhook，以及傳送訊息，並以您的身分操作您管理的應用程式和商家。

注意： 注意： WhatsApp Business Tools MCP 伺服器的介面和工具集目前為測試版，可能會有所變更。

概覽

下表摘要說明伺服器詳細資料：

屬性	值
伺服器名稱	WhatsApp Business Tools
傳輸方式	Streamable HTTP
端點	https://mcp.facebook.com/whatsapp_business_tools
驗證	Meta 開發人員帳號登入 (OAuth)
用戶端 ID	不需要。伺服器會自動識別支援的用戶端。
重新導向 URI	不需要。您不必為此伺服器建立或設定 Meta 應用程式。
支援的用戶端	Claude Code、Claude Desktop、ChatGPT、Codex CLI、Codex app
狀態	測試版 - 介面和工具集可能會有所變更

開始之前

若要連線用戶端，您需要使用上述支援的用戶端之一，並確保版本為最新。

伺服器正逐步推出，因此即使您的用戶端已連線，您的帳號也可能尚未能使用。

伺服器會操作您自己的資產，因此代理程式若要使用大多數工具，您還需要：

• 您要管理之商家的管理員存取權（MANAGE 角色）。
• 您具有管理員權限且已連結至該商家的 WhatsApp 啟用應用程式，也就是採用 WhatsApp Business Messaging 使用案例的應用程式（或舊版應用程式上的 WhatsApp 產品）。您必須具有應用程式的管理員存取權，僅有商家的管理員存取權並不足夠。
• 已接受該商家的 WhatsApp Business Cloud API 服務條款。管理員接受條款之前，訊息傳送和電話號碼註冊都會遭到封鎖。

如果缺少任何必要條件，工具會傳回可採取行動的錯誤訊息，告知您需要修正的項目，並提供可進行修正的頁面連結。

連線您的用戶端

若要連線支援的用戶端並完成 OAuth 授權，請依照將 MCP 用戶端連線至 Meta 的指示操作。使用概覽中的伺服器名稱和端點。此伺服器不需要用戶端 ID，因此請使用自動註冊。

範圍

同意授權時，伺服器會要求下列權限：

範圍	存取權
business_management	探索並操作您管理且在同意授權時選取的商家。
whatsapp_business_management	管理 WhatsApp Business 帳號、電話號碼、訊息範本和 Webhook。
whatsapp_business_messaging	從您已註冊的電話號碼傳送訊息。

您可以在 Facebook 的 設定 > 你的動態 > 商家整合 中檢視這些權限並撤銷存取權。

驗證您的連線

請代理程式使用您連線時指定的名稱，列出它從此伺服器取得的工具。接著執行唯讀工具，例如 whatsapp_biz_businesses，列出您管理的商家。若該呼叫傳回您的商家，而非驗證或權限錯誤，即表示連線正常。

速率限制

為保護平台，系統會依使用者和工具限制請求速率。如果您超過限制，工具會傳回速率限制錯誤；請稍候片刻再重試。

工具

WhatsApp Business Tools MCP 提供以 whatsapp_biz_ 為命名空間前綴的工具。大多數工具的範圍限定於您管理的商家，因此一般工作階段會先列出您的商家，再選擇其中一個。測試期間，工具集仍在持續演進。

探索

• whatsapp_biz_businesses — 列出您管理且在同意授權時授予存取權的商家。請先使用此工具選擇商家。範例：「列出我可以管理 WhatsApp 的商家。」
• whatsapp_biz_accounts — 列出商家底下的 WhatsApp 帳號（和訊息帳號）。範例：「顯示商家 1234567890 的 WhatsApp 帳號。」
• whatsapp_biz_phone_numbers — 列出商家或 WhatsApp 帳號上的電話號碼，以及其狀態和上線狀態。範例：「列出此商家的電話號碼及其狀態。」

電話號碼上線

• whatsapp_biz_add_phone_number — 將電話號碼新增至 WhatsApp 帳號。範例：「將電話號碼 +1 555 010 1234 新增至我的 WhatsApp 帳號。」
• whatsapp_biz_send_verification_code — 將驗證碼傳送至電話號碼。範例：「透過簡訊將驗證碼傳送至此號碼。」
• whatsapp_biz_verify_phone_number — 使用收到的驗證碼驗證電話號碼。範例：「使用驗證碼 123456 驗證此號碼。」
• 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 — 建立、更新和刪除訊息範本。範例：「以 en_US 建立名為 order_update 的行銷範本。」

訊息傳送

• whatsapp_biz_send_message — 從已註冊的號碼傳送自由格式文字（僅會在 24 小時客戶服務時段內送達）或已核准的範本訊息。傳送前會與您確認目標。範例：「從此號碼將 order_update 範本傳送至 +1 555 010 9999。」

Webhook

• whatsapp_biz_configure_webhooks — 設定 WhatsApp 主題的回呼 URL 和驗證權杖，並訂閱允許的欄位。範例：「為此商家設定 Webhook，回呼 https://example.com/webhook."
• whatsapp_biz_subscribe_webhook — 將 WhatsApp 帳號訂閱至您應用程式的 Webhook，以便傳送該帳號的事件。範例：「將此 WhatsApp 帳號訂閱至 Webhook。」

帳號設定

• whatsapp_biz_configure_payments — 設定付款方式，讓帳號能夠傳送計費訊息。範例：「協助我為此帳號設定付款方式。」
• whatsapp_biz_verify_business — 檢查並開始商家驗證。範例：「商家驗證狀態為何？我要如何開始驗證？」
• whatsapp_biz_system_user_token — 取得連結，以便為您的商家產生系統使用者存取權杖，讓您可以建立直接呼叫 WhatsApp Cloud API 的自訂訊息解決方案。權杖會在 Business Settings 中安全地產生；此工具會傳回 System Users 頁面的深層連結，您可在該頁面選取系統使用者並產生權杖。若要進一步瞭解，請參閱建立系統使用者並產生永久存取權杖。範例：「提供連結，讓我為此商家建立系統使用者存取權杖。」

意見回饋

如果您有意見回饋或希望看到更多工具，請分享您的意見回饋。

相關內容

• MCP 概覽
• 將 MCP 用戶端連線至 Meta
• WhatsApp Business Platform 說明文件

---

此產品的完整說明文件索引：https://developers.facebook.com/documentation/mcp/llms.txt