WhatsApp MCP服务器:让AI智能体连接WhatsApp与短信
WhatsApp MCP服务器如何让Claude、Cursor等AI智能体安全地发送WhatsApp和短信:连接步骤、护栏设置、用户同意要求以及典型使用场景,附代码示例供开发者参考。
作者: OmniChannels.ai Editorial Team · 审阅: BroadNet Messaging Solutions Team
集成
简短回答
WhatsApp MCP服务器把消息操作暴露为AI智能体可以通过Model Context Protocol发现并调用的工具。通过位于https://mcp.broadnet.me/mcp的OmniChannels.ai MCP服务器,Claude Code或Cursor等客户端使用Bearer token完成身份验证后,即可发送短信和WhatsApp消息、列出模板并读取送达报告。智能体以您账户的权限行事,所以护栏很重要。
本页内容
要点速览
- MCP(Model Context Protocol)是一个开放标准,让AI客户端可以列出并调用远程服务器上的工具;OmniChannels.ai服务器把其工具映射到您的代码所使用的同一套REST API。
- 一个端点(基于Streamable HTTP的https://mcp.broadnet.me/mcp)和一个请求头(Authorization: Bearer <token>),即可连接Claude Code、Cursor、VS Code、Claude Desktop和其他客户端。
- 拥有发送工具的智能体可以给真实的人发消息,并花掉真实的余额,所以只启用它需要的工具,并要求在任何发送之前经过人工确认。
- WhatsApp的规则对智能体依然适用:事先同意、客户服务窗口之外使用已获批的模板,以及短信的发件人ID规则。
- 试验期间使用临时密钥,永久密钥只用于经过审核的生产智能体。
本指南面向希望让AI智能体发送或跟踪WhatsApp和短信消息、又不想手写每个集成的开发者和技术负责人,说明什么是WhatsApp MCP服务器、如何连接、在智能体接触真实客户之前应设置哪些护栏,以及MCP在哪些场合并不适用。
什么是WhatsApp MCP服务器?
WhatsApp MCP服务器是一种服务,它把发送模板或读取送达报告等消息操作,暴露为AI客户端可以发现并调用的工具。它使用Model Context Protocol(MCP),这是一个把AI助手与外部工具和数据连接起来的开放标准。
没有MCP时,要让助手具备发送消息的能力,就得为每个模型或框架编写自定义函数。有了MCP,客户端连接一个URL,向服务器询问有哪些工具,并在用户请求需要时调用它们。我们的MCP服务器词条给出了简短定义。
有两点容易被忽略:
- **MCP不会绕过WhatsApp的规则。**服务器调用的WhatsApp Business平台操作与任何其他集成相同,所以模板、事先同意和客户服务窗口依然适用。
- **智能体的安全程度取决于它的token。**这些工具以您所提供密钥的权限、发件人ID和余额行事。
OmniChannels.ai MCP服务器如何运作?
这是一个位于单一端点、使用Bearer token验证的远程MCP服务器。它的工具映射到开发者文档中记载的同一套REST API,所以智能体能做的,就是您自己的代码用该token能做的。
| 设置 | 值 |
|---|---|
| 端点 | https://mcp.broadnet.me/mcp |
| 传输方式 | MCP Streamable HTTP |
| 鉴权 | 每个请求带Authorization: Bearer <token> |
| 作用对象 | 您的账户:渠道、发件人ID、模板和余额 |
| 典型工具领域 | 各渠道的发送(短信、WhatsApp、RCS、Telegram、Messenger、Instagram、推送)、列出和发送WhatsApp模板、读取送达报告 |
确切的工具列表取决于服务器版本和您的账户,所以请从您的客户端读取,而不是从博客文章中获取。不带token的请求会在协议层面被拒绝,这是一个有用的冒烟测试。
如何连接Claude、Cursor或其他客户端?
把端点和请求头添加到客户端的MCP配置中,并把token保存在环境变量或密钥输入中,使其永远不会进入代码仓库。
五步连接
- **获取密钥。**在管理门户中打开“Integrations”,再打开“MCP Integration”,然后选择“Get temporary key”。生产智能体的永久密钥来自您的账户管理员或主账户。
- **将其保存为密钥。**例如在shell中把它导出为
BROADNET_TOKEN。 - **把服务器添加到您的客户端。**以Claude Code为例:
claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp \
--header "Authorization: Bearer $BROADNET_TOKEN"
- **检查工具。**在Claude Code中,
/mcp命令会显示该服务器及其工具。在Cursor、VS Code和Claude Desktop中,配置位于客户端自己的MCP设置文件中。 - 在第一次真实提示之前,关闭智能体不需要的工具。
客户端格式会随版本变化,因此Cursor、VS Code和Claude Desktop的确切代码片段放在文档里,并为Claude Code、Cursor和n8n提供了分步页面。Claude Code自己的MCP文档是其命令的参考。
要在不使用任何客户端的情况下测试,请携带您的token向端点发送MCP initialize请求。文档展示了完整的curl命令。
AI智能体能用WhatsApp和短信做什么?
连接的工具允许的任何事情:发送、查询和报告。它的实际价值在于围绕消息的灵活的、用人类语言描述的任务,而不是那些应当保留在代码中的大批量流程。
适合智能体的提示示例:
- “用OmniDemo给447700900123发一条短信,说技术人员下午3点到。”
- “列出我已获批的阿拉伯语WhatsApp模板。”
- “给971500000000发送
order_updateWhatsApp模板,订单号为INV-400。” - “昨天的账单营销活动中有多少条消息失败了,原因是什么?”
- “为我们的秋季发布起草一张RCS卡片,在发送任何内容之前先给我看。”
好的使用场景,大致按安全程度排序:
| 使用场景 | 所需工具 | 风险 |
|---|---|---|
| 客服人员的送达查询(“这位客户收到短信了吗?”) | 只读报告工具 | 低 |
| 开发者在构建集成时,向您自己的号码发送测试消息的助手 | 发送工具,仅限测试号码 | 低到中 |
| 模板查询和供审阅的文案起草 | 模板列表工具 | 低 |
| 经人工批准后发送一次性通知的运营助手 | 发送工具加确认 | 中 |
| 向客户发送消息的自主智能体 | 发送工具,无需确认 | 高;需要经过审核的设计 |
一个回答送达问题的内部助手完全不需要发送工具。请将其移除。
如何防止AI智能体给错误的人发消息?
把智能体当作拿着公司手机的新员工:权限有限、起初有人监督,并且有它所做操作的记录。文档列出了各项保障措施;这里连同理由一起列出。
- **最小权限。**只启用任务所需的工具。回答送达问题的智能体不需要发送工具;发送验证码的智能体不需要模板或账户工具。
- **人工参与。**配置客户端,使其在任何发送类工具之前要求确认,在向多个收件人发送之前更是必须确认。在Claude Code中,权限规则把MCP工具称为
mcp__<server>__<tool>,所以您可以让读取类工具自由运行,而发送类工具仍然需要提示。 - **试验用临时密钥。**测试时使用临时密钥,永久密钥只用于经过审核的生产智能体。
- **先用测试号码。**让新智能体指向您自己已验证的号码,直到您信任它的行为。
- **查看日志。**在送达报告中复查智能体发送了什么,尤其是在最初几周。
- **迅速撤销。**如果密钥泄露,请让账户管理员或我们的支持团队撤销并签发新密钥。
- **尊重用户同意。**智能体必须遵守与任何其他发送方相同的事先同意、发件人ID和渠道规则。
提示词注入值得特别一提。如果智能体读取不受信任的文本,例如收到的客户消息或网页,这些文本中可能包含指令。不要让会读取不受信任内容的智能体在无人监督的情况下访问发送工具。请把读取和发送分为不同的步骤,由人来批准发送。
哪些WhatsApp和短信规则依然适用?
全部适用。智能体只是另一个发送方。
- **事先同意。**Meta的WhatsApp Business消息政策要求人们已同意接收您的消息。能给电子表格里任何人发消息的智能体,并不会改变这一点。
- **模板与窗口。**只有在客户服务窗口之内才可以发送自由格式的WhatsApp消息;窗口之外您需要已获批的模板。请参阅我们的24小时客户服务窗口指南和WhatsApp API文档。
- **费用。**Meta按送达消息的类别收费,而智能体可能迅速产生大量消息。请限制它可以发送的数量,并用我们的WhatsApp价格计算器测算成本。
- **短信发件人ID。**在许多国家,短信需要已注册的发件人ID。智能体使用您账户上已获批的发件人ID。
实战示例:客服团队增加送达状态助手
“Souq Rafiq”(虚构)是阿联酋的一家线上零售商,希望客服人员无需打开仪表盘,就能回答“客户收到我们的消息了吗?”
- **设置:**管理员生成临时密钥,并为两位客服负责人把Claude Desktop连接到MCP服务器。
- **工具:**只启用读取报告的工具,发送工具处于关闭状态。
- **使用:**一位负责人询问:“昨天的账单营销活动中有多少条消息失败了,原因是什么?”智能体读取送达报告,并按状态汇总原因。
- **复查:**两周后,管理员检查送达报告,确认没有发送任何消息,并为一个小型生产助手申请永久密钥。
- **下一步:**为让助手能重发漏发的通知,团队启用一个发送工具并打开确认,先把范围限定在测试号码组。
什么时候MCP是错误的选择?
对任何确定性的、大批量的场景,请使用REST API、OpenAPI规范或SDK。
- **验证码和事务类流程。**登录验证码应来自您掌控的代码,而不是可能改写它的模型。请参阅REST快速入门。
- **批量营销活动。**请使用营销活动工具或批量端点,配合经过审核的文件,而不是对话式提示。
- **无人值守的客户聊天。**面向客户的智能体需要精心设计的对话流程、知识、转交人工和监控。那是AI智能体产品,而不是开发者的MCP会话。
- **本指南的局限。**客户端配置格式和工具列表会随版本变化。请在文档和您的客户端中确认这两者。
OmniChannels.ai 如何提供帮助
OmniChannels.ai在https://mcp.broadnet.me/mcp提供MCP服务器,同时提供位于https://api.broadnet.me的REST API,并在短信、WhatsApp、RCS、Messenger、Instagram、Telegram、邮件和推送上使用统一的Bearer token模型。BroadNet是Meta官方的Business Solution Provider,其AI智能体产品支持英语和阿拉伯语,可转交给人工客服,并通过MCP使用工具;请参阅AI智能体。测试访问只发往您自己已验证的号码。请从MCP指南和开发者概览开始。
常见问题
什么是MCP服务器?
MCP服务器是通过开放标准Model Context Protocol向AI客户端提供工具的程序。客户端连接后列出工具,并在用户请求需要时调用它们。远程MCP服务器运行在服务商的基础设施上,所以您只需连接一个URL并完成身份验证,而无需安装代码。
Claude可以发送WhatsApp消息吗?
Claude本身无法接入WhatsApp,但支持MCP的Claude客户端可以调用消息类MCP服务器的工具。连接OmniChannels.ai MCP服务器后,Claude Code或Claude Desktop可以在您的工具设置和Meta规则的约束下,从您的账户发送已获批的WhatsApp模板或短信。
让AI智能体发送消息安全吗?
只有配备护栏才安全。启用最少的工具集,要求发送前经过人工确认,先用您自己已验证的号码测试,试验期间使用临时密钥,并复查送达报告。智能体以您token的权限行事,所以只要您允许,它就能花掉余额并联系真实的人。
智能体给别人发消息需要WhatsApp模板吗?
在客户服务窗口之外需要。Meta只允许在客户开启的窗口有效期间发送自由格式消息;否则企业必须发送已获批的模板。智能体可以列出您已获批的模板并按名称发送,但无法当场凭空创建一个新的已获批模板。
MCP服务器会取代REST API吗?
不会。这些工具映射到同一套REST API,使用相同的token和权限。当AI客户端需要自行发现并调用操作时使用MCP;而对于验证码流程和订单通知等确定性的生产代码,则使用REST API、OpenAPI规范或SDK。
如何获取MCP密钥?
登录管理门户,打开“Integrations”下的“MCP Integration”,然后选择“Get temporary key”。生产智能体的永久密钥由您的账户管理员或主账户签发。测试访问只发往您自己已验证的号码,目前没有即时自助注册。
资料来源
继续阅读
更多指南集成
WhatsApp消息API发送示例:cURL、Node、Python、PHP
如何用API发送WhatsApp消息:提供可运行的cURL、Node.js、Python和PHP示例,涵盖模板消息与会话消息、送达状态跟踪以及常见错误处理,方便开发者快速接入。
10 分钟阅读
集成
WhatsApp Webhook指南:事件、安全与重试
WhatsApp Webhook的工作方式:消息与状态事件、可靠的处理程序、Meta签名校验、重试机制、幂等处理,以及事件丢失时的恢复办法,帮助开发者稳定接收送达状态。
10 分钟阅读
客户支持
WhatsApp AI客服智能体:设计要点与Meta规则
如何设计WhatsApp AI客服智能体:知识库、护栏、转人工、阿拉伯语与英语支持,以及Meta 2026年条款对AI的规定,帮助出海企业安全地用AI做海外客服。
10 分钟阅读
