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

- 规范 URL: https://www.broadnet.me/zh/developers/mcp
- 语言: zh-CN
- 最后更新: 2026-10-21
- 发布方: BroadNet (https://www.broadnet.me)
- 上述页面的 Markdown 版本，根据渲染后的页面生成。

Model Context Protocol· /developers/mcp

BroadNetMCP服务器将BroadNet消息API作为AI智能体可以调用的工具。将任何支持远程服务器的MCP客户端指向一个端点，使用您的BroadNet令牌进行身份验证，智能体即可在您的账户上发送并追踪消息。

**端点**

https://mcp.broadnet.me/mcp

**传输**

MCP可流式传输的HTTP

**身份验证**

Authorization: Bearer <token>

**通道**

WhatsApp、短信、RCS、Telegram、推送、电子邮件、Messenger、Instagram

## 什么是MCP服务器

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

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

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

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

知识服务器（公开）

只读回答，数据源与本网站一致。无需账号、无需令牌、无需个人数据。

**Endpoint**

https://www.broadnet.me/mcp

**身份验证**

无

**访问**

只读

**工具**

search_site, get_facts, check_coverage, sender_id_rules, estimate_price, count_sms_segments, get_regulation, list_answers, get_answer, list_case_studies, get_case_study, get_changelog, get_status

**速率限制**

每个IP每分钟60请求数

消息服务器（您的账户）

使用您的BroadNet令牌权限发送并追踪消息。

**Endpoint**

https://mcp.broadnet.me/mcp

**身份验证**

Authorization: Bearer <token>

**访问**

作用于您的账户

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

初始化（知识服务器）

```
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"}}}'
```

tools/call（知识服务器）

```
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"}}}'
```

知识服务器支持MCP 2026-07-28（按请求元数据，服务器/发现）以及追溯至2024-11-05的早期基于初始化的修订版本。返回的价格仅为参考价，而非报价；监管相关回答仅供规划参考，不构成法律建议。

## 端点与身份验证

每个账户都有一个端点：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配置。典型的条目如下：

mcp.json

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

字段名称在不同客户端之间略有不同（有些期望类型为"http"或"streamable-http"，有些从单独的设置中读取标头）。请检查您客户端的MCP文档，并确保不要将令牌提交到代码文件中 ——如果您的客户端支持环境变量，请使用环境变量。

若要在没有客户端的情况下测试连接，请自行发送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端点，每个智能体都使用相同的复制粘贴步骤。

演示录像（1分10秒，无声）：登录BroadAdmin，将Cursor连接到BroadNet MCP服务器，并用自然语言发送一条WhatsApp消息。

相同流程的解说版本（1分20秒，含配音），开头附有概览卡片。

## 安全注意事项

- 该令牌为发送凭证 任何持有该密钥的人都可以从您的账户发送消息。请像保管密码一样保管它，切勿将其存储在共享文件或提交到代码库中。
- 实验优先使用临时密钥 在测试阶段请使用临时密钥，仅在为生产环境智能体配置时，才向您的账户管理员申请永久密钥。
- 仅启用您需要的工具 MCP客户可以自主关闭单个工具。仅发送短信的智能体无需模板、报备或账户工具。
- 保持人工介入 智能体根据自然语言指令执行操作。在执行发送消息的工具（尤其是向大量接收者发送消息）之前，请让客户端请求确认。
- 撤销泄露的令牌 如果令牌泄露，请联系您的账户管理员或BroadNet支持团队以撤销该令牌并签发新令牌。

## 相关

[API参考 MCP工具背后的REST端点，采用Bearer认证。](https://www.broadnet.me/developers/api) [OpenAPI 3.1规范 完整的机器可读API描述。](https://www.broadnet.me/developers/openapi.yaml) [快速入门 使用curl或TypeScript SDK发送您的首条短信。](https://www.broadnet.me/zh/developers/quickstart) [指南：安全的AI智能体 智能体如何通过MCP发送短信和WhatsApp，以及首先需要设置的防护机制。](https://www.broadnet.me/zh/blog/mcp-server-sms-whatsapp-ai-agents)

## 问题

### 什么是BroadNet MCP服务器URL？

https://mcp.broadnet.me/mcp. It uses the MCP Streamable HTTP transport and requires an Authorization: Bearer header with your BroadNet token.

### 哪些AI客户端可以连接？

任何可以通过Streamable HTTP连接到远程服务器并发送自定义Authorization标头的MCP客户端。演示录像使用的是Cursor。

### 在哪里获取令牌？

通过您的BroadNet账户。在BroadAdmin门户中，Integrations → MCP Integration会签发临时密钥；永久密钥由您的账户管理员或主账户提供。

### 智能体能否发送真实消息？

是的。在演示录像中，智能体的WhatsApp发送返回HTTP 200，且消息成功送达手机。这些工具将以您令牌的权限进行操作，完全如同您自己的API调用一样，因此请将每一次发送都视为真实操作：仅启用智能体所需的工具，并对发送操作要求确认。

## 基于BroadNet构建

获取账户和令牌，然后连接您的智能体或直接调用API。

[联系我们](https://www.broadnet.me/zh/contact) [开发者中心](https://www.broadnet.me/zh/developers)