---
title: "VS Code + OmniChannels.ai：在 Copilot 智能体模式中使用消息工具"
description: "将 OmniChannels.ai MCP 服务器添加到 VS Code，让 GitHub Copilot 智能体模式发送测试 WhatsApp 和短信、读取模板并查看送达报告。"
canonical: "https://omnichannels.ai/zh/integrations/vs-code/"
language: "zh"
updated: "2026-10-10"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
---

# VS Code + OmniChannels.ai：在 Copilot 智能体模式中使用消息工具

Canonical: https://omnichannels.ai/zh/integrations/vs-code/
Language: zh
Publisher: OmniChannels.ai by BroadNet Technologies

**简而言之:** 在 .vscode/mcp.json 中将我们的远程 MCP 服务器添加为 http 服务器，promptString 输入项会安全保存 API 令牌。GitHub Copilot 智能体模式即可发送测试消息、列模板并读取送达报告。

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

## 您可以做什么

### 编写与模板匹配的代码

Copilot 通过 MCP 列出您已审核的 WhatsApp 模板，并按每个模板所需的变量编写发送代码。

> 试着这样提问: "列出我已审核的 WhatsApp 模板，然后写一个 C# 方法，用订单号和送达日期发送 order_update 模板。"

### 搭建并测试 webhook 接口

Copilot 为送达状态和入站消息编写接口，然后您触发一次测试发送，查看真实载荷到达。

> 试着这样提问: "写一个 FastAPI webhook 接口，按消息 ID 保存送达状态，并能接收随渠道而异的字段，然后向 447700900123 发送一条测试短信，让我观察它的到达。"

### 上线前核对送达情况

您的代码发出测试消息后，Copilot 读取送达报告，您可以核对处理程序记录的状态是否一致。

> 试着这样提问: "查看最近发给 971500000000 的消息的送达报告，并将其状态与我们数据库中的记录对比。"

### 依据规范而非记忆

工作区中有我们的 OpenAPI 规范时，Copilot 会使用准确的路径和字段，包括哪些发送需要 multipart/form-data。

> 试着这样提问: "根据 docs/omnichannels-openapi.yaml，编写批量 WhatsApp 发送辅助函数，并指出哪些字段以 multipart/form-data 方式发送。"

### 起草阿拉伯语和英语文案

Copilot 起草两种语言的消息文本，并在调用任何发送工具之前先展示给您。

> 试着这样提问: "起草一条阿拉伯语和英语的预约提醒短信，各不超过一个分段，并在向 966500000000 发送测试前先给我看。"

## 连接方式

VS Code 从工作区中的 .vscode/mcp.json 读取 MCP 服务器。我们的服务器以带 Authorization 请求头的 http 服务器形式添加，令牌来自 password 设为 true 的 promptString 类型输入项，因此 VS Code 只会提示您输入一次，并且令牌不会出现在您提交的文件中。

在 GitHub Copilot 智能体模式中，已启用的 MCP 服务器提供的工具会出现在工具列表里，您可以逐个开关，VS Code 也可以在调用工具前请您确认。每次发送都是真实且计费的消息，因此对任何会发送的工具都请保持确认开启。不同 VS Code 版本的配置字段会有变化，如果某个字段无法识别，请查阅其 MCP 文档。

- 文件：.vscode/mcp.json，服务器类型 http，URL 为 https://mcp.broadnet.me/mcp
- 请求头：Authorization: Bearer ${input:omnichannels-token}
- 令牌输入：password: true 的 promptString
- 只在工具列表中启用该工作区所需的工具

## 设置步骤

1. **申请 API 访问权限:** 申请测试权限并获取 API 令牌。测试发送只会发往您自己已验证的号码。
2. **获取临时密钥:** 在管理后台打开 Integrations，进入 MCP Integration，选择 Get temporary key。 (指南: https://omnichannels.ai/developers/mcp/)
3. **创建 .vscode/mcp.json:** 添加一个类型为 http、使用我们 URL 的 omnichannels 服务器，一个使用 ${input:omnichannels-token} 的 Authorization 请求头，以及一个 password 设为 true 的 promptString 输入项。 (指南: https://omnichannels.ai/developers/mcp/)
4. **启动服务器并输入密钥:** 在 VS Code 中启动服务器，按提示粘贴您的密钥，并确认工具已出现在 Copilot 智能体模式中。
5. **限制工具范围:** 在工具列表中关闭该工作区不需要的工具，并对每个发送类工具保持确认开启。
6. **用自己的号码测试:** 让 Copilot 向您已验证的号码发送一条测试消息，然后读取送达报告。

## 示例工作流程

Copilot 智能体模式 (在协助您写代码时调用 MCP 工具) → OmniChannels.ai MCP 服务器 (使用您的令牌发送、列出模板并读取报告) → 您的测试手机 (向已验证号码发送测试 WhatsApp 或短信) → 送达报告 (Copilot 通过读取工具回读状态)

## 常见问题

### VS Code 有 OmniChannels.ai 扩展吗？

没有。VS Code 通过 .vscode/mcp.json 中标准的 MCP 服务器支持，使用我们的公开端点和您的 API 令牌连接。无需从扩展市场安装任何内容。

### 我的令牌存放在哪里？

使用设为 password: true 的 promptString 输入项，VS Code 会在服务器启动时询问令牌并安全保存，而不会写入 mcp.json。请提交该文件，但切勿提交密钥。

### 哪种 Copilot 模式会使用这些工具？

MCP 工具用于 Copilot 的智能体模式，由您选择可用的工具。请查阅 VS Code 针对您版本的最新文档，以及组织内管控 MCP 的相关策略。

### 其他编辑器可以用同样的配置吗？

任何支持 Streamable HTTP 和自定义 Authorization 请求头的客户端都能使用同一端点，只是各自保存配置的格式不同。Cursor 和 Claude Code 的示例请参见 MCP 服务器指南。

## 开发者指南

- https://omnichannels.ai/developers/mcp/
- https://omnichannels.ai/developers/openapi/
- https://omnichannels.ai/developers/webhooks/

## 厂商文档

- [Add and manage MCP servers in VS Code](https://code.visualstudio.com/docs/copilot/customization/mcp-servers)
- [MCP configuration reference — VS Code](https://code.visualstudio.com/docs/copilot/reference/mcp-configuration)

## 相关集成

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

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

更新于: 2026-10-10