通过MCP将AI智能体连接至BroadNet。

什么是MCP服务器

Model Context Protocol (MCP)是一种开放标准，允许AI智能体发现并调用外部工具。BroadNet MCP服务器是一个远程MCP服务器：您的客户端通过HTTPS与其连接，列出其提供的工具，并代表您进行调用。

这些工具对应于API参考文档和OpenAPI规范中记录的相同BroadNet API ——例如发送消息、处理WhatsApp模板、读取状态报告。智能体将以您授予的令牌权限进行操作，完全如同您自己的代码一样。

两个MCP服务器：知识与消息服务

BroadNet运行两台MCP服务器。本页描述的消息服务器负责处理您的账户。知识服务器是公开的：智能体无需登录即可向其咨询关于BroadNet的覆盖范围、发送者ID规则、公布的价目表、法规及公司概况。

通过终端尝试知识服务器：先进行初始化握手，然后进行工具调用。

curl -X POST https://www.broadnet.me/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-06-18","capabilities":{},
                 "clientInfo":{"name":"curl","version":"1.0"}}}'

curl -X POST https://www.broadnet.me/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-06-18" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"sender_id_rules","arguments":{"country":"ae"}}}'

端点与身份验证

每个账户都有一个端点：https://mcp.broadnet.me/mcp. 每个请求都必须在Authorization标头中携带您的BroadNet令牌。

您可以从您的BroadNet账户获取令牌。在演示中，它是在BroadAdmin门户的Integrations → MCP Integration下通过“Get temporary key”生成的；门户说明永久密钥由您的账户管理员或主账户签发。

不带请求头的请求会在协议层面被拒绝——这是服务器对未认证初始化调用的实际响应：

event: message
data: {"jsonrpc":"2.0","id":1,"error":{"code":-32001,
  "message":"Authorization bearer token is required. Connect with an
  'Authorization: Bearer <BroadNet token>' header."}}

连接MCP客户端

大多数MCP客户端会使用包含服务器URL和请求头的JSON配置。典型的条目如下：

{
  "mcpServers": {
    "broadnet": {
      "type": "http",
      "url": "https://mcp.broadnet.me/mcp",
      "headers": {
        "Authorization": "Bearer ${BROADNET_TOKEN}"
      }
    }
  }
}

若要在没有客户端的情况下测试连接，请自行发送MCP初始化请求：

curl -X POST https://mcp.broadnet.me/mcp \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-06-18","capabilities":{},
                 "clientInfo":{"name":"curl","version":"1.0"}}}'

演示内容

产品团队的录制视频将使用Cursor作为MCP客户端，通过五个步骤演示整个流程：

1. 1
   登录

   使用您的BroadNet账号登录BroadAdmin门户。

2. 2
   获取密钥与配置

   开放集成 → MCP集成，生成临时密钥并复制现成的客户端配置。

3. 3
   将服务器添加到客户端

   在MCP客户端中，添加一个新的MCP服务器，并将配置粘贴到mcp.json中——使用带有Bearer标头的URL https://mcp.broadnet.me/mcp。

4. 4
   查看工具

   客户端连接并列出BroadNet工具，每个工具都可以开启或关闭。

5. 5
   使用自然语言提问

   用户要求智能体向某个号码发送一条WhatsApp消息。智能体选择WhatsApp发送工具，API返回HTTP 200表示消息已接受，随后消息从企业账户到达WhatsApp。

在录像中，客户端报告了380个BroadNet工具，其中包括send_message、post_sms_send、post_whatsapp_message_send、get_whatsapp_template_list、post_whatsapp_template_send、post_rcs_message_send、post_telegram_message_send、post_instagram_message_send、post_messenger_message_send、post_push_message_send和get_report_delivery。确切列表取决于服务器版本和您的账户。

同一录音的旁白版本会增加一个概览卡：一个MCP端点，每个智能体都使用相同的复制粘贴步骤。

安全注意事项

• 该令牌为发送凭证

  任何持有该密钥的人都可以从您的账户发送消息。请像保管密码一样保管它，切勿将其存储在共享文件或提交到代码库中。

• 实验优先使用临时密钥

  在测试阶段请使用临时密钥，仅在为生产环境智能体配置时，才向您的账户管理员申请永久密钥。

• 仅启用您需要的工具

  MCP客户可以自主关闭单个工具。仅发送短信的智能体无需模板、报备或账户工具。

• 保持人工介入

  智能体根据自然语言指令执行操作。在执行发送消息的工具（尤其是向大量接收者发送消息）之前，请让客户端请求确认。

• 撤销泄露的令牌

  如果令牌泄露，请联系您的账户管理员或BroadNet支持团队以撤销该令牌并签发新令牌。

相关

问题