---
title: "Cursor + OmniChannels.ai：开发时发送并追踪消息"
description: "通过 .cursor/mcp.json 为 Cursor 添加 OmniChannels.ai MCP 服务器，让其 Agent 发送 WhatsApp、短信和 RCS 测试消息并读取送达报告。"
canonical: "https://omnichannels.ai/zh/integrations/cursor/"
language: "zh"
updated: "2026-10-10"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
---

# Cursor + OmniChannels.ai：开发时发送并追踪消息

Canonical: https://omnichannels.ai/zh/integrations/cursor/
Language: zh
Publisher: OmniChannels.ai by BroadNet Technologies

**简而言之:** 在 .cursor/mcp.json 中添加远程 MCP 服务器 https://mcp.broadnet.me/mcp，令牌从环境变量读取。Cursor Agent 即可发送 WhatsApp、短信和 RCS、列出模板并读取送达报告，每次调用前都需批准。

通过 MCP 连接 · 通过 API 和 Webhook 连接

## 您可以做什么

### 编码时发送测试消息

无需离开编辑器即可端到端检查消息流程，消息只会发送到你已验证的号码。

> 试着这样提问: "给 971500000000 发一条 WhatsApp 消息，告知订单已发货。"

### 查询模板名称与变量

Agent 列出已审核的 WhatsApp 模板，让你写的代码使用准确的模板名称和参数。

> 试着这样提问: "列出我已审核的阿拉伯语 WhatsApp 模板，并显示每个模板需要的变量。"

### 调试送达问题

读取代码刚刚发出的消息的送达报告，查看失败原因。

> 试着这样提问: "查看我最近发送的那条消息的送达报告，并解释失败原因（如有）。"

### 依据规范编写集成代码

把我们的 OpenAPI 规范提供给 Agent，它写出的 REST 调用就会使用准确的字段，包括 multipart 发送。

> 试着这样提问: "根据 OpenAPI 规范，编写一个发送批量短信活动的 TypeScript 函数。"

## 连接方式

OmniChannels.ai 运行一个基于 Streamable HTTP 的远程 MCP 服务器。Cursor 会读取项目中的 .cursor/mcp.json，或对所有项目生效的 ~/.cursor/mcp.json，并解析 url 和 headers 字段里的 ${env:NAME}，因此令牌可以保存在环境变量里，而不必写入文件。

连接成功后，Cursor 会在 MCP 设置中列出该服务器的工具，你可以逐个开启或关闭。Cursor 默认在运行 MCP 工具前请求批准，并先显示参数。由于每次发送都是真实计费的消息，请对所有发送类工具保持批准开启。

- 接入点：https://mcp.broadnet.me/mcp（Streamable HTTP）
- 请求头：Authorization: Bearer ${env:BROADNET_TOKEN}
- 配置文件：.cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）
- 排错：在 Output 面板的 MCP Logs 中查看

## 设置步骤

1. **申请 API 访问权限:** 申请测试权限并获取 API 令牌。测试消息只会发送到你已验证的本人号码。
2. **获取 MCP 密钥:** 在管理后台依次打开 Integrations、MCP Integration，选择 Get temporary key。 (指南: https://omnichannels.ai/developers/mcp/)
3. **把服务器添加到 mcp.json:** 在 mcpServers 下添加名为 omnichannels 的条目，填入我们的 URL，以及读取 ${env:BROADNET_TOKEN} 的 Authorization 请求头。 (指南: https://omnichannels.ai/developers/mcp-cursor/)
4. **设置变量并重启:** 在 Cursor 启动所用的环境（例如 shell 配置文件）中设置 BROADNET_TOKEN，然后重启 Cursor。
5. **检查工具列表:** 在 Cursor 的 MCP 设置中关闭 Agent 不需要的所有工具，并对发送类工具保持批准开启。
6. **发送第一条消息:** 让 Agent 向你已验证的号码发送一条测试消息，批准调用，然后查看送达报告。

## 示例工作流程

Cursor Agent (Agent 对话中的一个请求) → OmniChannels.ai MCP 服务器 (你批准调用后，工具开始运行) → 你的测试手机 (WhatsApp、短信或 RCS 消息已送达) → 送达报告 (Agent 通过读取工具回读状态)

## 常见问题

### Cursor 有 OmniChannels.ai 官方扩展吗？

没有。Cursor 通过其标准 MCP 支持接入，在 .cursor/mcp.json 中使用我们的公开 MCP 接入点和你的 API 令牌，无需安装任何东西。

### 可以把 .cursor/mcp.json 提交到代码仓库吗？

可以，前提是令牌通过 ${env:BROADNET_TOKEN} 从环境变量读取。管理后台提供的现成配置里包含密钥本身，请不要把那个版本纳入版本控制。

### 服务器报错或没有显示工具，应该检查什么？

打开 Output 面板并选择 MCP Logs。授权错误说明请求头缺失，或密钥有误、已过期。变量为空则说明 Cursor 启动时没有设置 BROADNET_TOKEN。

### Agent 可以通过哪些渠道发送？

这些工具覆盖你账户已启用的各个渠道，例如短信、WhatsApp、RCS、Telegram、Messenger、Instagram 和推送通知。具体工具列表取决于服务器版本和你的账户。

## 开发者指南

- https://omnichannels.ai/developers/mcp-cursor/
- https://omnichannels.ai/developers/mcp/
- https://omnichannels.ai/developers/openapi/
- https://omnichannels.ai/developers/errors-and-limits/

## 厂商文档

- [Model Context Protocol in Cursor](https://cursor.com/docs/context/mcp)
- [Model Context Protocol — introduction](https://modelcontextprotocol.io/introduction)

## 相关集成

- https://omnichannels.ai/zh/integrations/claude-code/
- https://omnichannels.ai/zh/integrations/vs-code/
- https://omnichannels.ai/zh/integrations/claude/
- https://omnichannels.ai/zh/integrations/langchain/

Cursor 是其所有者的商标。OmniChannels.ai 与 Cursor 无关联，也未获得 Cursor 的认可；本页介绍的是利用 Cursor 自身的 MCP、HTTP 或 Webhook 功能建立的连接。

更新于: 2026-10-10