Desktop MCP 接入指南

仅 Desktop 客户端提供本机 MCP，可让 Cursor、Claude Code、Codex、WorkBuddy 等 AI 工具管理台词、打开提词窗并控制播放。网页端与手机 App 没有 MCP。

使用前准备

  1. 安装并打开 Desktop
  2. 登录账号
  3. 开通 月 / 季 / 年会员（非会员不会启动 MCP）
  4. 打开 设置 → MCP，确认状态为绿色「运行中」，并复制服务地址

默认地址：

http://127.0.0.1:17890/mcp

若端口被占用，可能变为 17891–17899，请以设置页显示为准。关闭 Desktop 后，外部客户端将无法连接。

各端如何配置

在客户端中添加 HTTP / Streamable HTTP 类型的 MCP，URL 填设置页复制的地址。

Cursor

在 MCP 配置（如 .cursor/mcp.json）中：

{
  "mcpServers": {
    "teleprompter": {
      "url": "http://127.0.0.1:17890/mcp"
    }
  }
}

Claude Code

claude mcp add --transport http teleprompter http://127.0.0.1:17890/mcp

Codex

codex mcp add teleprompter --url http://127.0.0.1:17890/mcp

或在 ~/.codex/config.toml 中设置 url。

WorkBuddy

在 MCP 管理中新增 URL 型服务，地址同上。

Pi 等其他客户端

需客户端支持 HTTP MCP（Pi 可能要额外安装适配器）。只支持 stdio 的客户端需自行桥接；Desktop 不提供 stdio 入口。

支持哪些指令

Agent 会按你的话自动选用；下列为 Desktop MCP 当前能力。

词稿与文件夹

  • 列出 / 读取 / 创建 / 更新 / 删除 / 搜索词稿
  • 移动词稿到文件夹
  • 文件夹的新建、重命名、删除

常见说法：「写一段 1 分钟口播并创建成台词稿」。

提词窗口

  • 打开 / 关闭悬浮提词窗
  • 打开预览窗

打开浮窗受会员多开上限影响（月 2 / 季 3 / 年 5）。详见 会员权益说明。

播放控制

需先打开提词窗，然后可：

  • 播放 / 暂停 / 回顶部
  • 设置或调节匀速速度（CPM）
  • 切换匀速 / AI 跟读（悬浮窗目前主要为匀速）
  • 翻页、跳段落、开关目录
  • 查询当前播放状态

常见说法：「打开刚才那篇稿并开始匀速播放，速度 280」。

账号

  • 查看当前用户与会员信息
  • 查看跟读用量 / 剩余额度

常见问题

设置里没有「运行中」？

未登录或非月季年会员时，服务不会启动。请先登录并升级会员。

客户端连不上？

确认 Desktop 已打开；URL 端口与设置页一致；客户端选择的是 HTTP/URL，而不是本地脚本路径。

能改稿但不能播放？

请先打开提词窗，再让 Agent 执行播放类指令。

数据会上公网吗？

不会。MCP 只监听本机 127.0.0.1，不会部署成线上 MCP 服务。

同机其他程序能调用吗？

可以。服务运行期间，本机能访问该地址的进程都可能调用（权限等同当前登录账号）。请在受信电脑上使用；退出 Desktop 即关闭服务。

相关文章