推送MCP

提示

一封传话支持通过 Model Context Protocol (MCP) 与 AI 助手（如 Trae、Claude、Cursor、OpenClaw 等）深度集成，让 AI 助手能够主动向您汇报任务成果或发送重要通知。

# 一、什么是 MCP？

Model Context Protocol (MCP) 是一个开放协议，旨在标准化 AI 助手如何与其工作所在的外部工具和资源进行通信。通过添加一封传话的 MCP 服务器，您可以赋予您的 AI 助手发送通知和汇报进度的能力。

# 二、配置说明（用户必读）

使用此 MCP 服务器前，请先完成以下两步，否则无法推送：

在一封传话 (opens new window) 注册账号并创建推送通道，获取 32 位通道码。
在 AI 助手中手动添加远程 MCP 服务器，按下表填写：

配置项	值	说明
名称	`push-server`	固定，必须与 skill 中调用的服务器名一致
URL	`https://www.phprm.com/services/push/mcp`	远程 MCP 服务地址
Headers	见下表	通过 HTTP Header 传递凭证

Headers 说明：

Header 名	必填	值	用途
`X-Push-Channel-Code`	✅ 必填	`您的32位通道码`	推送凭证；不配置无法接收推送
`X-Mcp-Source`	❌ 可选	`客户端标识`（如 `trae`、`cursor`、`claude-code`）	仅用于服务端日志区分来源，可填任意值

注意

通道码是推送凭证，只允许配置在 MCP 服务器的 X-Push-Channel-Code Header 中。不得硬编码进代码、配置文件并提交 git，也不得写入 head/body/url 推送内容。

# 三、提供工具（Tools）

MCP 服务器对外暴露以下工具：

工具名	用途
`send_push_message`	发送一条推送消息到指定的渠道

send_push_message 参数：

参数	类型	必填	说明
`head`	String	✅ 必填	消息标题，纯文本，支持 Unicode，200 字符以内
`body`	String	❌ 可选	消息内容，支持 Markdown/JSON（JSON 用于 webhook 通道推送到业务服务器），50,000 字符以内
`url`	String	❌ 可选	点击消息跳转的链接，500 字符以内
`channelCode`	String	❌ 可选	覆盖 Header 中的通道码；不指定时使用 Header 预设的 `X-Push-Channel-Code`

# 四、各 AI 编辑器/工具配置示例

按 AI 客户端类型选择对应配置。所有配置中 ****** 需替换为您自己的 32 位通道码。

# 1. Cursor

为 Cursor、Kiro 编辑器配置远程 MCP Server：

{
  "mcpServers": {
    "push-server": {
      "url": "https://www.phprm.com/services/push/mcp",
      "headers": {
        "X-Push-Channel-Code": "******",
        "X-Mcp-Source": "cursor"
      }
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11

打开 Cursor 设置 → MCP → Add Server，粘贴上述 JSON。

# 2. Kiro

亚马逊推出的 AI Agentic IDE，前身为 Amazon Q Developer。原生支持远程 MCP，IDE / CLI / Web 三端配置通用：

{
  "mcpServers": {
    "push-server": {
      "url": "https://www.phprm.com/services/push/mcp",
      "headers": {
        "X-Push-Channel-Code": "******",
        "X-Mcp-Source": "kiro"
      }
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11

用户级：~/.kiro/settings/mcp.json（全局）
工作区级：.kiro/settings/mcp.json（项目内，可提交 git 共享）

# 3. OMate

为 OMate 编辑器配置远程 MCP Server：

{
  "mcpServers": {
    "push-server": {
      "url": "https://www.phprm.com/services/push/mcp",
      "headers": {
        "X-Push-Channel-Code": "******",
        "X-Mcp-Source": "omate"
      }
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11

打开 OMate 设置页 → MCP 服务器管理，点击「添加服务器」（OMate 仅支持远程 MCP）。名称填 push-server，URL 填上方服务地址；若界面支持 JSON 导入，可直接粘贴配置。

# 4. Cline

VS Code 自治 AI 编程代理插件，原生仅支持 stdio/SSE 传输，远程 HTTP 需通过 mcp-remote 桥接（需本机已安装 Node.js (opens new window)）：

{
  "mcpServers": {
    "push-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.phprm.com/services/push/mcp",
        "--header",
        "X-Push-Channel-Code:******",
        "--header",
        "X-Mcp-Source:cline"
      ]
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

配置文件：cline_mcp_settings.json（放在项目根目录或 ~/）。桥接启动后，在 Cline 设置 → MCP Servers 中添加上面的 stdio server。

# 5. Continue

开源跨 IDE AI 编程助手（VS Code + JetBrains），配置使用 YAML 格式：

mcpServers:
  push-server:
    type: http
    url: https://www.phprm.com/services/push/mcp
    headers:
      X-Push-Channel-Code: ******
      X-Mcp-Source: continue

1
2
3
4
5
6
7

配置文件位置：.continue/config.yaml（项目根目录）或 ~/.continue/config.yaml（全局）。YAML 缩进敏感，不要写成 JSON。

# 6. Zed

Rust 编写的高性能原生编辑器（macOS/Linux），内置 MCP 支持。配置根键为 context_servers（注意不是 mcpServers）：

{
  "context_servers": {
    "push-server": {
      "url": "https://www.phprm.com/services/push/mcp",
      "headers": {
        "X-Push-Channel-Code": "******",
        "X-Mcp-Source": "zed"
      }
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11

打开设置（Cmd/Ctrl + ,）→ 搜索 context_servers，或直接编辑 ~/.config/zed/settings.json。

# 7. Claude Desktop

Claude Desktop 仅支持本地 stdio 方式，需通过 mcp-remote 桥接远程服务（需本机已安装 Node.js (opens new window)）：

{
  "mcpServers": {
    "push-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.phprm.com/services/push/mcp",
        "--header",
        "X-Push-Channel-Code:******",
        "--header",
        "X-Mcp-Source:claude-desktop"
      ]
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

配置文件位置：

Windows：%APPDATA%\Claude\claude_desktop_config.json
macOS：~/Library/Application Support/Claude/claude_desktop_config.json

保存后重启 Claude Desktop 生效。

# 8. Qoder

为 Qoder 编辑器配置远程 MCP Server，需添加官方要求的 type: streamable-http 字段：

{
  "mcpServers": {
    "push-server": {
      "type": "streamable-http",
      "url": "https://www.phprm.com/services/push/mcp",
      "headers": {
        "X-Push-Channel-Code": "******",
        "X-Mcp-Source": "qoder"
      }
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11
12

打开 Qoder 设置 → MCP → My Servers → Add（QoderWork 为 Connectors → Add → Paste JSON Configuration）。

# 9. Gemini CLI

为 Gemini CLI 工具配置远程 MCP Server：

{
  "mcpServers": {
    "push-server": {
      "httpUrl": "https://www.phprm.com/services/push/mcp",
      "timeout": 30000,
      "headers": {
        "X-Push-Channel-Code": "******",
        "X-Mcp-Source": "gemini-cli"
      }
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11
12

配置文件位置：~/.gemini/settings.json。

# 10. Claude Code

为 Claude Code 配置远程 MCP Server，使用命令行配置：

claude mcp add --transport http push-server \
  https://www.phprm.com/services/push/mcp \
  --header "X-Push-Channel-Code: ******" \
  --header "X-Mcp-Source: claude-code"

1
2
3
4

配置文件位置：~/.claude.json。

# 11. Open Code

为 Open Code 编辑器配置远程 MCP Server：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "push-server": {
      "type": "remote",
      "url": "https://www.phprm.com/services/push/mcp",
      "enabled": true,
      "headers": {
        "X-Push-Channel-Code": "******",
        "X-Mcp-Source": "opencode"
      }
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14

配置文件位置：~/.config/opencode/opencode.json。

# 12. VS Code / Copilot

VS Code（含 GitHub Copilot）配置远程 MCP Server。⚠️ Copilot 使用根键 servers 而非 mcpServers：

{
  "servers": {
    "push-server": {
      "type": "http",
      "url": "https://www.phprm.com/services/push/mcp",
      "headers": {
        "X-Push-Channel-Code": "******",
        "X-Mcp-Source": "vscode"
      }
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11
12

配置文件位置：

项目级（推荐，可提交 git 共享）：.vscode/mcp.json
全局：~/.config/Code/User/mcp.json（Windows 为 %APPDATA%\Code\User\mcp.json）

# 13. JetBrains 全家桶

IntelliJ IDEA / PyCharm / WebStorm / GoLand / Rider / Android Studio 等。2025.2+ 版本内置 MCP Server 原生支持，使用 GUI 配置（无 JSON 文件）：

确保 IDE 版本 ≥ 2025.2（推荐 2026.1，数据库工具已内置）
打开 Settings/Preferences → Tools → MCP Servers
点击 + Add MCP Server，选择 HTTP 类型，按下表填写：

字段	值
服务器名称	`push-server`
传输类型	`HTTP`（或 `SSE`）
URL	`https://www.phprm.com/services/push/mcp`

Headers（点击 + 新增）：

Key	Value
`X-Push-Channel-Code`	`******`（替换为你的通道码）
`X-Mcp-Source`	`jetbrains`

# 14. Windsurf (Codeium)

Codeium 推出的 AI 原生 IDE，免费版无代码量限制：

{
  "mcpServers": {
    "push-server": {
      "url": "https://www.phprm.com/services/push/mcp",
      "headers": {
        "X-Push-Channel-Code": "******",
        "X-Mcp-Source": "windsurf"
      }
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11

配置文件位置：

全局：~/.windsurf/mcp_config.json（Windows：%USERPROFILE%\.windsurf\mcp_config.json）
项目级：.windsurf/mcp_config.json（在项目根目录创建，自动覆盖全局）
GUI 管理：Settings → Cascade → Model Context Protocol → + Add Remote Server

# 15. WorkBuddy（腾讯）

腾讯推出的全场景 AI 办公智能体（俗称"小龙虾"），原生支持远程 MCP，兼容 OpenClaw Skill：

{
  "mcpServers": {
    "push-server": {
      "type": "http",
      "url": "https://www.phprm.com/services/push/mcp",
      "headers": {
        "X-Push-Channel-Code": "******",
        "X-Mcp-Source": "workbuddy"
      }
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11
12

打开侧边栏 插件 → 右上角 MCP 服务器 → 配置 MCP（可视化编辑，也可直接编辑配置文件）
用户级：~/.workbuddy/mcp.json；项目级：.workbuddy/mcp.json
保存后自动检测连接状态（🟢 绿色成功 / 🔴 红色需检查）

# 16. 百度搭子（DuMate）

百度推出的通用办公智能体（WAIC 2026 镇馆之宝），主打桌面执行和跨应用操作：

{
  "mcpServers": {
    "push-server": {
      "type": "http",
      "url": "https://www.phprm.com/services/push/mcp",
      "headers": {
        "X-Push-Channel-Code": "******",
        "X-Mcp-Source": "dumate"
      }
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11
12

打开搭子，点击左侧 技能 → 连接应用，或直接编辑配置文件
配置文件路径：~/.dumate/mcp.json（Mac/Windows 统一）
保存后自动加载

# 17. 钉钉悟空

钉钉推出的 AI 桌面智能体（独立客户端 + 钉钉集成），支持手动配置 MCP Server 连接：

{
  "mcpServers": {
    "push-server": {
      "type": "http",
      "url": "https://www.phprm.com/services/push/mcp",
      "headers": {
        "X-Push-Channel-Code": "******",
        "X-Mcp-Source": "wukong"
      }
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11
12

打开悟空客户端，点击左下角 头像 → 设置 → MCP服务
点击「添加 MCP Server」，选择 HTTP 类型
⚠️ 企业用户注意：管理员可能开启了 MCP 白名单，需要联系管理员将 push-server 加入白名单

# 18. 千问办公

阿里通义千问推出的办公智能体，可在「连接器 / MCP 服务」中手动添加远程 HTTP MCP 服务：

{
  "mcpServers": {
    "push-server": {
      "type": "http",
      "url": "https://www.phprm.com/services/push/mcp",
      "headers": {
        "X-Push-Channel-Code": "******",
        "X-Mcp-Source": "qwenwork"
      }
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11
12

打开千问办公，进入 设置 → 连接器（MCP 服务），选择「自定义添加 / 手动添加」
传输类型选 HTTP（Streamable HTTP），名称填 push-server，URL 与 Headers 按上方填写
保存后确认连接器状态为已连接，直接对它说「用 push-server 给我推送一条测试通知」验证

# 19. Trae（字节）

为 Trae 编辑器配置远程 MCP Server：

{
  "mcpServers": {
    "push-server": {
      "url": "https://www.phprm.com/services/push/mcp",
      "headers": {
        "X-Push-Channel-Code": "******",
        "X-Mcp-Source": "trae"
      }
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11

打开 AI 对话框右上角「设置 → MCP → + 添加 → 手动添加」，选择 HTTP 类型。

# 20. 豆包

豆包网页版/客户端使用 push-server。通过自定义连接器 + 专属智能体两步完成。

第 1 步：新建自定义连接器（类型选 HTTP）：

{
  "url": "https://www.phprm.com/services/push/mcp",
  "headers": {
    "X-Push-Channel-Code": "******",
    "X-Mcp-Source": "doubao"
  }
}

1
2
3
4
5
6
7

打开豆包 技能·连接器·伙伴 → 新建 → 自定义连接器，按下表填写：

第 2 步：再新建专属智能体/伙伴，把 SKILL.md 正文（不含 frontmatter）粘贴到指令框，勾选刚建的连接器。

# 21. Codex（OpenAI）

OpenAI Codex CLI 原生支持 MCP，配置文件为 TOML 格式，根键为 mcp_servers（下划线，注意不是驼峰 mcpServers）：

[mcp_servers.push-server]
transport = "streamable-http"
url = "https://www.phprm.com/services/push/mcp"
headers = [
    "X-Push-Channel-Code:******",
    "X-Mcp-Source:codex"
]

1
2
3
4
5
6
7

配置文件：~/.codex/config.toml（Codex CLI ≥ 0.46.0 生效）
或用 CLI 命令：codex mcp add push-server --transport http --url https://www.phprm.com/services/push/mcp --header "X-Push-Channel-Code:******" --header "X-Mcp-Source:codex"

# 22. Grok Build（xAI）

xAI 推出的开源编码智能体 CLI，原生支持 stdio / SSE / Streamable HTTP 三种传输。配置文件为 TOML，CLI 命令 grok mcp add 一键管理：

[mcp_servers.push-server]
transport = "streamable-http"
url = "https://www.phprm.com/services/push/mcp"
headers = [
    "X-Push-Channel-Code:******",
    "X-Mcp-Source:grok"
]

1
2
3
4
5
6
7

安装：npm install -g @xai/grok-build（需 Node 20+），然后 grok-build login 登录 xAI 账号
用户级配置：~/.grok-build/config.toml；项目级：./grok-build.toml
或用 CLI 命令：grok mcp add push-server --transport http --url https://www.phprm.com/services/push/mcp --header "X-Push-Channel-Code:******" --header "X-Mcp-Source:grok"
验证：grok mcp list 查看，grok mcp doctor push-server 诊断连接

# 23. OpenClaw

开源全栈 Agent Gateway，原生支持 MCP。配置文件为 JSON5（允许注释和尾随逗号），根键为 mcp.servers（嵌套，注意不是直接 mcpServers）：

{
  "mcp": {
    "servers": {
      "push-server": {
        "url": "https://www.phprm.com/services/push/mcp",
        "transport": "streamable-http",
        "headers": {
          "X-Push-Channel-Code": "******",
          "X-Mcp-Source": "openclaw"
        }
      }
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14

配置文件：~/.openclaw/openclaw.json（JSON5 格式）
保存后运行 openclaw mcp reload 重新加载，或重启 Gateway
也可通过 openclaw mcp add CLI 管理

# 24. 讯飞星辰 / 星火 MaaS

科大讯飞 Agent 开发平台（开源版 Astron）。配置格式与 Cursor/Windsurf 一致：

{
  "mcpServers": {
    "push-server": {
      "type": "http",
      "url": "https://www.phprm.com/services/push/mcp",
      "headers": {
        "X-Push-Channel-Code": "******",
        "X-Mcp-Source": "xingchen"
      }
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11
12

需已购买讯飞星辰 Token Plan 或 Coding Plan（maas.xfyun.cn）
配置文件路径按客户端而定（Cursor: .cursor/mcp.json / VS Code: .vscode/mcp.json）

# 25. 阿里云百炼

阿里云百炼智能体平台，支持在 Agent 市场部署、快速部署、代码创建三种入口接入 MCP。鉴权与百炼 API Key 公用（${DASHSCOPE_API_KEY} 环境变量）：

{
  "mcpServers": {
    "push-server": {
      "type": "streamableHttp",
      "baseUrl": "https://www.phprm.com/services/push/mcp",
      "headers": {
        "Authorization": "Bearer ${DASHSCOPE_API_KEY}",
        "X-Push-Channel-Code": "******",
        "X-Mcp-Source": "bailian"
      }
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13

已开通百炼（bailian.console.aliyun.com），并创建 API-KEY
集群部署时配置写入 MCP_JSON 环境变量；ECS 部署写入 /root/ 或镜像 config 目录
鉴权方式：Authorization: Bearer ${DASHSCOPE_API_KEY}（环境变量自动解析）
传输类型推荐 streamableHttp（SSE 已在 2025-03 规范中废弃）

注意

阿里云百炼使用 ${DASHSCOPE_API_KEY} 环境变量引用百炼 API Key。部署时确保该环境变量已设置，不要把真实 Key 直接写入配置文件。通道码 ****** 需替换为你的推送通道码。

# 26. 扣子 Coze（字节）

字节跳动扣子（Coze）智能体平台。两条路可选：桌面端「扩展 → MCP」直接粘贴 JSON，或网页端「资源库 → 插件」创建 MCP 类型插件后再挂到智能体。

{
  "mcpServers": {
    "push-server": {
      "type": "streamable-http",
      "url": "https://www.phprm.com/services/push/mcp",
      "headers": {
        "X-Push-Channel-Code": "******",
        "X-Mcp-Source": "coze"
      }
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11
12

配置步骤：

方式一（桌面端，最快）：打开扣子桌面端 → 扩展 → MCP → 添加自定义 MCP，粘贴上方 JSON，点「下一步」等待工具列表加载出来。
方式二（网页端）：登录 coze.cn → 资源库 → + 资源 → 插件，类型选 MCP（插件图标可上传本地图片）。
插件 URL 填上方地址（必须为 HTTPS 域名，不支持 IP 形式），并在 Header 列表 中逐条添加 X-Push-Channel-Code、X-Mcp-Source。
授权方式选「不需要授权」（通道码已放在自定义 Header 里，无需 Service token / API key）。
新建（或打开）智能体 → 在「技能 / 插件」中勾选刚创建的 push-server，对话里说「用 push-server 给我推送一条测试通知」验证。

注意

扣子对传输类型敏感：type 必须写 streamable-http，写成 http 会出现「MCP 工具列表为空 / 工具不出现」。通道码 ****** 记得替换成自己的 32 位通道码。

# 27. DeepSeek Harness

DeepSeek 官方开源的 Agent 运行框架（缩写 dsh，MIT 协议，「一切皆插件」），桌面版 DSH Desktop 内置运行时，下载打开即用。官方插件 @deepseek-ai/dsh-mcp-client 提供 MCP 客户端能力，支持 stdio 与 streamable-http 两种传输。

{
  "mcpServers": {
    "push-server": {
      "type": "streamable-http",
      "url": "https://www.phprm.com/services/push/mcp",
      "headers": {
        "X-Push-Channel-Code": "******",
        "X-Mcp-Source": "deepseek-harness"
      }
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11
12

配置步骤：

安装 MCP 客户端插件：命令行执行 dsh plugin --profile web add @deepseek-ai/dsh-mcp-client；桌面版也可在 设置 → 插件 → 添加插件 里搜索安装（需 Node.js 环境）。
打开 设置 → 插件配置（Web 版 / 桌面版相同），新增一条 MCP 服务，名称填 push-server，传输选 streamable-http，粘贴上方配置。
也可直接用社区插件 dsh-mcp-bridge：安装后启用其中的 remote-http 服务，只填远程服务 URL 即可（Headers 仍需带上通道码）。
配置支持热替换无需重启，工具会以 mcp__push-server__xxx 形式注册；在会话里说「用 push-server 给我推送一条测试通知」验证。

注意

dsh 仍在快速迭代（0.1.x 预览版），插件配置的键名可能随版本调整：若粘贴 JSON 不生效，改用 @deepseek-ai/dsh-mcp-client 的 YAML 写法（serverName / transport / url / headers 四个字段，含义与上方 JSON 一致）。通道码 ****** 记得替换成自己的 32 位通道码。

# 五、相关名词

通道码：电脑端具体推送通道的唯一标识，比如企业微信通道码、钉钉通道码、飞书通道码、邮件通道码，或者这些通道码可以属于某个组合通道码。
群组提醒：用户在移动端创建的一个允许多通道配置、多用户加入的提醒，允许开放到消息市场供其他人订阅，需要和好友或者陌生人分享可创建提醒。

# 六、如何获取通道码？

# 七、相关开源项目

push-server（后端 / MCP 服务）：https://github.com/teakong/push-server (opens new window) —— 一封传话的推送后端与 MCP 服务器实现。
push-server-frontend（纯前端分享 / 通道管理页面）：https://github.com/teakong/push-server-frontend (opens new window) —— push-server 的轻量级前端配套项目，基于原生 HTML/JS 实现，无需后端即可部署。提供通道（Channel）的查看、二维码分享、浏览器弹幕（Danmu）集成、测试推送与 MCP 配置指引等可视化界面，是 SKILL.md 中通道管理与分享场景的纯前端入口。

配合 SKILL 文档一起使用，可让 AI 助手以更结构化的方式报告任务。

#mcp

Last Updated: 2026/10/06, 12:15:52

← 浏览器弹幕挂件推送Skill→