跳到主要内容

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。)

Whisperr 的 Connect Codex to Whisperr 页面,列出 Codex 将能够执行的操作,并有 Cancel 和 Allow 按钮

页面会提示您将被送回一个以 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 的 list_conversations 工具后,列出最近的五场 Whisperr 对话
提示

您的套餐同一时间只能运行一个机器人。如果 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 集成概览。

相关内容​