WhatsApp Business Tools MCP

官方

WhatsApp Business Tools MCP 伺服器可讓您的 AI 代理與 IDE 助手在單一位置管理及除錯您的 WhatsApp Business 整合。它使代理能探索您所管理的商家與 WhatsApp 帳號、上線並註冊電話號碼、建立及管理訊息範本、設定 Webhook，以及傳送訊息——以您的身分，在您所管理的應用程式與商家上操作。

造訪 facebook.com

你可以用 WhatsApp Business Tools MCP 做什麼？

探索受管资产 — 让您的助手通过 whatsapp_biz_businesses、whatsapp_biz_accounts 和 whatsapp_biz_phone_numbers 列出您所管理的商家、WhatsApp 账户或电话号码。
接入并注册号码 — 让您的助手添加电话号码、发送并验证其代码，然后使用 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_create_template、whatsapp_biz_update_template 和 whatsapp_biz_delete_template 列出、创建、更新或删除 WhatsApp 消息模板。
发送消息 — 指示您的助手通过 whatsapp_biz_send_message 从已注册的号码发送自由格式文本或已批准的模板消息，该工具会在发送前确认收件人。
配置 Webhook 和账户设置 — 让您的助手使用 whatsapp_biz_configure_webhooks、whatsapp_biz_subscribe_webhook、whatsapp_biz_configure_payments、whatsapp_biz_verify_business 和 whatsapp_biz_system_user_token 等工具设置 Webhook、订阅账户、配置付款、检查商家验证或生成系统用户令牌链接。

託管 MCP 伺服器

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

可安裝到 Claude Code、Codex、Cursor 等客戶端

文件

針對在 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）
狀態	Beta - 介面和工具組可能會有變更

先決條件

此伺服器會對您自己的資產進行操作，因此在代理程式可以使用大多數工具之前，您需要：

您要管理之商家的管理員存取權（MANAGE 角色）。
您為管理員的 WhatsApp 啟用應用程式，並連接到該商家——一個具有 WhatsApp Business Messaging 使用案例的應用程式（或在較舊應用程式上具有 WhatsApp 產品）。您必須對應用程式具有管理員存取權，而不僅是對商家。
已接受該商家的 WhatsApp Business Cloud API 服務條款。在管理員接受之前，訊息傳送和電話號碼註冊會被封鎖。

如果缺少任何先決條件，工具會傳回可操作的錯誤訊息，告訴您需要修正什麼，並提供可修正問題的頁面連結。

設定您的 IDE 或代理程式用戶端

WhatsApp Business Tools MCP 伺服器是一個遠端伺服器。支援遠端 MCP 伺服器的用戶端可以直接連接到端點。對於僅支援本機（stdio）伺服器的用戶端，請使用 mcp-remote 橋接器，它會透過 stdio 代理遠端伺服器。

使用以下其中一個區段設定您的用戶端，然後完成 OAuth 登入以進行驗證。

Claude Code 和 Desktop

Claude Code — 執行以下命令以新增伺服器：

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

然後在會話中執行 /mcp，並選取 whatsapp_business_tools 以進行驗證。

Claude Desktop — 開啟 Settings > Connectors > Add custom connector，然後設定：

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

OpenAI Codex App 和 ChatGPT

Codex App — 開啟 Settings（左下角的齒輪圖示）> MCP Servers > Add servers，選擇 Streamable HTTP，然後設定：

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

按一下 Authenticate 並完成 OAuth 登入。

ChatGPT — 開啟 Settings > Plugins > Browse plugins，按一下右上角的 + 以新增外掛程式，然後設定：

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

儲存外掛程式並完成 OAuth 登入。

OAuth 登入

WhatsApp Business Tools MCP 伺服器會透過 OAuth 使用您的 Meta 開發人員帳號進行驗證，因此相同的登入流程適用於每個用戶端。

登入流程

在您將伺服器新增到用戶端之後（請參閱設定您的 IDE 或代理程式用戶端）：

啟動連線。 許多用戶端會在新增伺服器時自動開始 OAuth 流程。其他用戶端則要求您先按一下 Connect 或 Authenticate。
登入。 您的瀏覽器會開啟，以使用您的 Meta 帳號登入。如果沒有自動開啟，請複製用戶端列印的連結並手動開啟。
授予存取權。 在同意畫面上，選取您希望伺服器存取的商家和 WhatsApp 啟用應用程式。
確認。 返回您的用戶端並驗證您的連線。

當您重新啟動用戶端時，需要再次完成登入流程。

範圍

伺服器在同意期間會要求以下權限：

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

您可以隨時在 facebook.com > Settings > Business Integrations 檢閱或撤銷存取權。

驗證您的連線

新增伺服器後，請確認您的代理程式可以看到工具：

重新啟動 IDE 或代理程式用戶端。
要求代理程式列出它從 whatsapp_business_tools 伺服器取得的工具。
執行低風險的讀取工具。例如，要求它使用 whatsapp_biz_businesses 列出您所管理的商家。

如果代理程式回報沒有工具或驗證錯誤，請重新檢查端點 URL，並確認您已完成登入流程。

工具

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 — 傳送驗證碼到電話號碼。範例：「透過 SMS 傳送驗證碼到此號碼。」
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 和驗證權杖，並訂閱允許的欄位。範例：「使用回呼 https://example.com/webhook." 為此商家設定 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 頁面的深層連結，您可以在其中選取系統使用者並產生權杖。若要深入瞭解，請參閱<a href="/documentation/business-messaging/whatsapp/get-started#step-5-create-a-system-user-and-generate-a-permanent-access-token" target="_blank">建立系統使用者並產生永久存取權杖</a>。範例：「給我一個為此商家建立系統使用者存取權杖的連結。」

速率限制

為了保護平台，每個使用者每個工具的請求都會受到速率限制。如果您超過限制，工具會傳回速率限制錯誤；請稍等片刻後重試。

意見回饋

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