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）
状态	测试版 - 界面和工具集可能会变化

前提条件

服务器作用于你自己的资产，因此在代理可以使用大多数工具之前，你需要：

• 对你想要管理的企业具有管理员访问权限（MANAGE 角色）。
• 一个你作为管理员的已启用 WhatsApp 的应用，并连接到该企业——一个具有 WhatsApp Business Messaging 用例（或在较旧应用上具有 WhatsApp 产品）的应用。你必须在应用上具有管理员访问权限，而不仅仅是在企业上。
• 已接受该企业的 WhatsApp Business Cloud API 服务条款。在管理员接受之前，消息发送和电话号码注册将被阻止。

如果缺少任何前提条件，工具将返回一个可操作的错误，告诉你需要修复什么，并提供指向可修复页面的链接。

设置你的 IDE 或代理客户端

WhatsApp Business Tools MCP 服务器是一个远程服务器。支持远程 MCP 服务器的客户端可以直接连接到端点。对于仅支持本地（stdio）服务器的客户端，请使用 mcp-remote 桥接器，它通过 stdio 代理远程服务器。

使用以下部分之一配置你的客户端，然后完成 OAuth 登录 进行身份验证。

Claude Code 和 Claude Desktop

Claude Code — 运行以下命令添加服务器：

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

然后在会话中运行 /mcp 并选择 whatsapp_business_tools 进行身份验证。

Claude Desktop — 打开 设置 > 连接器 > 添加自定义连接器，然后设置：

• 名称：WhatsApp Business Tools
• URL：https://mcp.facebook.com/whatsapp_business_tools

OpenAI Codex App 和 ChatGPT

Codex App — 打开 设置（左下角的齿轮图标）> MCP 服务器 > 添加服务器，选择 Streamable HTTP，然后设置：

• 名称：WhatsApp Business Tools
• URL：https://mcp.facebook.com/whatsapp_business_tools
• 认证：OAuth

点击 Authenticate 并完成 OAuth 登录。

ChatGPT — 打开 设置 > 插件 > 浏览插件，点击右上角的 + 添加新插件，然后设置：

• 名称：WhatsApp Business Tools
• URL：https://mcp.facebook.com/whatsapp_business_tools
• 认证：OAuth

保存插件并完成 OAuth 登录。

OAuth 登录

WhatsApp Business Tools MCP 服务器通过 OAuth 使用你的 Meta 开发者账户进行身份验证，因此相同的登录流程适用于每个客户端。

登录流程

将服务器添加到你的客户端后（参见 设置你的 IDE 或代理客户端）：

1. 启动连接。 许多客户端在添加服务器时会自动开始 OAuth 流程。其他客户端要求你先点击 Connect 或 Authenticate。
2. 登录。 你的浏览器将打开，使用你的 Meta 账户登录。如果它没有自动打开，请复制客户端打印的链接并手动打开。
3. 授予访问权限。 在同意屏幕上，选择你希望服务器访问的企业和已启用 WhatsApp 的应用。
4. 确认。 返回你的客户端并 验证你的连接。

当你重新启动客户端时，你需要再次完成登录流程。

权限范围

服务器在同意期间请求以下权限：

范围	访问权限
business_management	发现并操作你在同意期间选择的、你管理的企业。
whatsapp_business_management	管理 WhatsApp Business 账户、电话号码、消息模板和 webhook。
whatsapp_business_messaging	从你注册的电话号码发送消息。

你可以随时在 facebook.com > 设置 > 业务集成 中查看或撤销访问权限。

验证你的连接

添加服务器后，确认你的代理可以看到工具：

1. 重新启动 IDE 或代理客户端。
2. 要求代理列出它从 whatsapp_business_tools 服务器获得的工具。
3. 运行一个低风险的读取工具。例如，要求它使用 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 — 向电话号码发送验证码。示例：“通过短信向此号码发送验证码。”
• 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 小时客户服务窗口内送达）或已批准的模板消息。发送前会与你确认目标。示例：“从此号码向 +1 555 010 9999 发送 order_update 模板。”

Webhooks

• 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 的自定义消息解决方案。令牌生成在业务设置中安全进行——该工具返回指向系统用户页面的深层链接，你可以在其中选择系统用户并生成令牌。要了解更多信息，请参阅 创建系统用户并生成永久访问令牌。示例：“给我一个为此企业创建系统用户访问令牌的链接。”

速率限制

为了保护平台，每个用户每个工具的请求都受到速率限制。如果超过限制，工具将返回速率限制错误；稍等片刻后重试。

反馈

如果你有反馈或想看到更多工具，请 分享你的反馈。

相关

• MCP 概述
• WhatsApp Business Platform 文档

---

此产品的完整文档索引：https://developers.facebook.com/documentation/mcp/llms.txt