Codex 接入

OpenAI Codex CLI 是 OpenAI 官方的命令行 AI 编程助手，2025 年起支持 MCP（含远程 HTTP）。本页演示如何在 Codex CLI 接入 Keepamore。

一、安装 Codex CLI

需要 Node.js 18+ 与有效的 OpenAI API Key（或 ChatGPT 订阅登录）。

npm install -g @openai/codex
codex --version

首次运行：

codex

会引导你登录 / 填 OpenAI Key。

二、配置 Keepamore MCP

Codex 的配置文件在 ~/.codex/config.toml（Windows: %USERPROFILE%\.codex\config.toml）。打开（不存在就新建），追加：

[mcp_servers.keepamore]
url = "https://mcp.keepamore.com/mcp"

[mcp_servers.keepamore.headers]
"X-API-Key" = "km_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

旧版 Codex 只支持 stdio 服务，需借助 mcp-remote 桥接：

[mcp_servers.keepamore]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.keepamore.com/mcp", "--header", "X-API-Key:km_xxx"]

升级 Codex CLI 到最新版后即可走原生 HTTP 配置。

保存后重新打开 Codex 会话，输入 /mcp 查看挂载的服务，应能看到 keepamore 与它下属的 13 个工具。

三、配置 Keepa 数据分析师指令

Codex 通过 ~/.codex/instructions.md（或项目内 AGENTS.md）提供持久化 system 指令：

1. 编辑 ~/.codex/instructions.md
2. 粘贴 Keepa 数据分析师 prompt
3. 保存

下次 codex 启动会自动加载。

四、开始对话

codex

进入交互模式后输入：

帮我用 keepamore 工具查一下 B08N5WRWNW 最近 90 天的价格走势

Codex 会按 prompt 风格调用 keepa_get_product，并以电报体回复。

也可以走非交互模式跑一次性脚本：

codex exec "调用 keepa_get_quota 查询额度"

Codex IDE / VS Code 扩展

如果你用的是 Codex IDE 扩展（VS Code 上的同名扩展），MCP 配置入口在：

• 命令面板 (Ctrl/Cmd+Shift+P) → Codex: Open MCP Settings
• 表单填 Name: keepamore / URL: https://mcp.keepamore.com/mcp / Header: X-API-Key=km_xxx

底层读写的同样是 ~/.codex/config.toml，与 CLI 共享。

故障排查

现象	原因	处理
/mcp 看不到 keepamore	TOML 语法错	用 toml-cli 校验；注意 section 名称大小写
header 没生效	段名拼错	必须是 [mcp_servers.<name>.headers]
旧版 Codex 报 "unknown field url"	版本太老不支持 HTTP	npm i -g @openai/codex@latest
401 / 403	Key 错 / 套餐过期	主站重置 Key

---

下一步：扣子 Coze 接入 · Refly AI 接入