跳转到正文
OmniChannels.ai

AI 助手与智能体

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

通过 MCP 连接通过 API 和 Webhook 连接更新于

简而言之

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

您可以做什么

  • 编码时发送测试消息

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

    试着这样提问

    “给 971500000000 发一条 WhatsApp 消息,告知订单已发货。”

  • 查询模板名称与变量

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

    试着这样提问

    “列出我已审核的阿拉伯语 WhatsApp 模板,并显示每个模板需要的变量。”

  • 调试送达问题

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

    试着这样提问

    “查看我最近发送的那条消息的送达报告,并解释失败原因(如有)。”

  • 依据规范编写集成代码

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

    试着这样提问

    “根据 OpenAPI 规范,编写一个发送批量短信活动的 TypeScript 函数。”

连接方式

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

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. 1

    申请 API 访问权限

    申请测试权限并获取 API 令牌。测试消息只会发送到你已验证的本人号码。

  2. 2

    获取 MCP 密钥

    在管理后台依次打开 Integrations、MCP Integration,选择 Get temporary key。

    指南: MCP server for AI agents
  3. 3

    把服务器添加到 mcp.json

    在 mcpServers 下添加名为 omnichannels 的条目,填入我们的 URL,以及读取 ${env:BROADNET_TOKEN} 的 Authorization 请求头。

    指南: Use the MCP server with Cursor
  4. 4

    设置变量并重启

    在 Cursor 启动所用的环境(例如 shell 配置文件)中设置 BROADNET_TOKEN,然后重启 Cursor。

  5. 5

    检查工具列表

    在 Cursor 的 MCP 设置中关闭 Agent 不需要的所有工具,并对发送类工具保持批准开启。

  6. 6

    发送第一条消息

    让 Agent 向你已验证的号码发送一条测试消息,批准调用,然后查看送达报告。

厂商文档

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

示例工作流程

一个典型请求如何从 Cursor 传到您的客户,再返回。

  1. 01

    Cursor Agent

    Agent 对话中的一个请求

  2. 02

    OmniChannels.ai MCP 服务器

    你批准调用后,工具开始运行

  3. 03

    你的测试手机

    WhatsApp、短信或 RCS 消息已送达

  4. 04

    送达报告

    Agent 通过读取工具回读状态

1. Cursor Agent: Agent 对话中的一个请求 2. OmniChannels.ai MCP 服务器: 你批准调用后,工具开始运行 3. 你的测试手机: WhatsApp、短信或 RCS 消息已送达 4. 送达报告: 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 和推送通知。具体工具列表取决于服务器版本和你的账户。

获取 API 与 MCP 访问权限

请告诉我们您的渠道、国家和使用场景。工程师会签发测试凭证并验证您的测试号码。