连接 ClipSeek 与 Codex

你需要从 ClipSeek → 设置 → AI Agent 获取两项内容：连接地址和访问令牌。配置和使用期间，请保持 ClipSeek 运行。

1. 准备 ClipSeek

1. 打开素材库，开启启用 Agent 访问。
2. Codex 在同一台电脑上运行时，监听范围保持仅本机。
3. 复制显示的本机连接地址，再点击复制访问令牌。

首次测试时，先保持允许整理与导入关闭。搜索、读取字幕和查看预览都不需要这项权限。

2. 在 Codex 中添加服务

1. 打开 Settings → MCP servers → Add server。
2. 名称填 clipseek，类型选择 Streamable HTTP。
3. 填入从 ClipSeek 复制的连接地址。
4. 如果当前版本提供 Bearer Token 字段，粘贴访问令牌；没有该字段时，使用下方的配置文件方式。
5. 保存并按提示重启。在输入框键入 /mcp，检查连接状态。

不同 Codex 版本的界面名称可能不同。官方 OpenAI MCP 文档提供桌面端、CLI 和 IDE 的配置说明。

进阶：使用 config.toml 配置

将以下内容加入本机的 ~/.codex/config.toml。连接地址请替换为 ClipSeek 显示的完整地址，<port> 只是占位符。

[mcp_servers.clipseek]
url = "http://127.0.0.1:<port>/mcp"
bearer_token_env_var = "CLIPSEEK_MCP_TOKEN"
default_tools_approval_mode = "prompt"
tool_timeout_sec = 120

在启动 Codex 的环境中，将本机环境变量 CLIPSEEK_MCP_TOKEN 设置为复制的令牌，然后完全退出并重新启动 Codex。配置里写的是变量名称，不是令牌本身。在另一个终端设置变量，不会更新已经运行的桌面应用。

prompt 表示调用此服务的工具时请求确认。Codex 也支持 writes，会对未标记为只读的工具请求确认。这是客户端的审批策略，与 ClipSeek 的整理与导入权限分别控制。

不要重复添加 [mcp_servers.clipseek] 配置段，也不要将凭据放入项目文件或共享配置。

3. 测试连接

在 Codex 中发送：

列出我的 ClipSeek 素材库，并告诉我当前打开的是哪一个。不要修改任何内容。

能获取素材库列表，就可以继续尝试常用工作流中的提示词。

连接失败时

看到的情况	检查方法
无法连接、连接被拒绝	确认 ClipSeek 正在运行、Agent 访问已开启，且状态显示运行中。重新复制连接地址。
Unauthorized / HTTP 401	重新复制当前令牌。重新生成令牌后，旧令牌会失效；使用环境变量时，更新变量并重启 Codex。
服务停止或端口错误	查看 ClipSeek 的 AI Agent 设置中的错误。已保存的端口可能被占用，服务不会自动换到其他端口。
找不到素材库	打开目标素材库，或先让 Codex 列出素材库再选择。
整理或导入被拒绝	需要这些操作时，再开启允许整理与导入。

分享截图前，请遮住令牌和完整下载链接。更多说明见安全与权限。