Codex 中的 Whisperr
本页介绍如何将 Whisperr 添加到 Codex(OpenAI 的终端应用)。您只需运行两条命令,然后在浏览器中登录 Whisperr 并点击 Allow。不用复制密钥。
连接之后能做什么,请参阅 MCP 集成概览。改用网页版 ChatGPT?请参阅 ChatGPT。
开始之前
- 已安装并登录的 Codex。如需设置,请参阅 OpenAI 的 Codex 文档。
- 一个 Whisperr 账户 —— 登录网页应用。派出会议机器人需要有效订阅;读取已保存的对话则不需要。
如何添加 Whisperr
1. 添加 Whisperr 服务器
在终端中运行:
codex mcp add whisperr --url https://prod-whisperr-mcp.fly.dev/mcp
whisperr 是 Codex 用来称呼它的名字。这个地址与 Whisperr 网页应用中 MCP 集成 页面显示的地址相同。
2. 登录 Whisperr
运行:
codex mcp login whisperr
浏览器会打开 Whisperr。如果您还没登录,请先登录(用您在 Whisperr 使用的 Google、Apple 或邮箱均可)。然后您会看到 Connect Codex to Whisperr,其中显示您当前登录的账户,以及 Codex 将能够执行的全部操作:
- 把 Whisperr 会议机器人派进您的 Zoom、Teams 和 Google Meet 通话
- 查看并停止您的会议机器人
- 读取您已保存的对话和转录
点击 Allow。(Cancel 不会连接任何内容。如果账户不对,请点击 Not you? Use a different account。)

页面会提示您将被送回一个以 127.0.0.1 开头的地址。那是 Codex 在您自己的电脑上监听,以完成登录。不会向其他任何地方发送任何内容。
只有在您刚刚亲自运行了 codex mcp login whisperr 时,才点击 Allow。如果有您意料之外的页面要求您把 Codex 连接到 Whisperr,请点击 Cancel。
3. 启动 Codex
回到终端,登录完成后,运行:
codex
要检查 Whisperr 是否已连接,您可以随时运行 codex mcp list。
4. 向 Codex 提出请求
用日常的话提出请求:
| 请求 | 会发生什么 |
|---|---|
| “给我看看 Whisperr 里最近几场对话的标题” | 您已保存的对话,附带链接 |
| “读一下我最近的 Whisperr 对话并总结” | Codex 读取转录及其翻译,然后进行总结 |
| “把 Whisperr 机器人派到你的会议链接,翻译英语和日语” | 机器人加入,Codex 给您实时转录链接。如果会议设有等候室,请允许“Whisperr Bot”进入 |
| “机器人进会议了吗?”/“停止机器人” | Codex 查看机器人的状态,或让它离开 |
Codex 会显示它用到的每个 Whisperr 工具,例如 whisperr.list_conversations,然后根据查到的内容作答:

您的套餐同一时间只能运行一个机器人。如果 Codex 提示您已达上限,请先让它停止正在运行的机器人。
断开 Whisperr
- 在 Whisperr 中: 在网页应用中打开 MCP 集成。在 Connected apps 下,您会看到 Codex 以及它的连接时间。点击 Disconnect。Codex 会被登出,必须重新登录才能使用。
- 在 Codex 中: 运行
codex mcp logout whisperr登出,或运行codex mcp remove whisperr彻底移除 Whisperr。
之后想重新连接:执行 logout 后,运行 codex mcp login whisperr。执行 remove 后,先运行第 1 步的命令把 Whisperr 加回来,再登录。
故障排除
| 您看到的情况 | 该怎么做 |
|---|---|
codex: command not found | 没有安装 Codex,或它不在您的路径(PATH)中。请参阅 OpenAI 的 Codex 文档。 |
codex mcp add 提示名为 whisperr 的服务器已存在 | 运行 codex mcp remove whisperr,然后重新添加。 |
| 浏览器没有打开 Whisperr | 把 codex mcp login whisperr 在终端中打印出的地址复制到浏览器中。 |
| Whisperr 页面提示登录请求无效或已过期 | 请求的有效时间很短。请再次运行 codex mcp login whisperr。 |
| Whisperr 提示您的账户已达到 API 密钥数量上限 | 每个已连接的应用会占用一个密钥。打开 MCP 集成(或 Developer Console),移除不用的密钥或应用,然后重试。 |
| Codex 无法使用 Whisperr,或提示您需要登录 | 再次运行 codex mcp login whisperr。如果您在网页应用中点击了 Disconnect,Codex 就需要重新登录。 |
| “subscription_required” | 派出机器人需要有效订阅。读取对话则不需要。 |
| “concurrency_limit” | 您有一个机器人还在会议中。请先停止它。 |
| 机器人没有加入 | 检查会议链接,并看看是否有等候室 —— 主持人必须允许“Whisperr Bot”进入。 |
| “No saved conversations” | Codex 只能看到保存到云端的对话。请先运行一次机器人,或开启保存到云端。 |
更多内容请参阅 MCP 集成概览。
相关内容
- MCP 集成 —— Codex、ChatGPT 和 Claude 能用 Whisperr 做什么
- ChatGPT —— 改为连接网页版 ChatGPT
- Claude Code(终端) —— 将 Whisperr 添加到 Claude Code
- 会议机器人 —— 机器人如何加入通话