在 Codex 中接入 Rshift MCP
Codex 可以通过 MCP server 调用 Rshift 工作区工具。适合让 Codex 在代码、文档或运营任务中读取 Rshift 的品牌和工具能力。
接入前准备
在 Rshift 工作区 AI 页面启用 MCP。
复制 MCP URL。
复制完整 MCP 密钥。
确认你的 Codex 环境支持 MCP server 配置。
添加服务器
Codex 使用 config.toml 管理 MCP。默认位置是 ~/.codex/config.toml，也可以在受信任项目里使用 .codex/config.toml。
推荐把密钥放在环境变量里，再让 Codex 从环境变量读取：
export RSHIFT_MCP_KEY="<MCP_KEY>"
然后在 config.toml 中添加：
[mcp_servers.rshift] url = "https://mcp.rshift.com/<workspace>/" bearer_token_env_var = "RSHIFT_MCP_KEY"
如果必须写静态 header，也可以使用 http_headers，但不建议把真实密钥提交到仓库：
[mcp_servers.rshift]
url = "https://mcp.rshift.com/<workspace>/"
http_headers = { "Authorization" = "Bearer <MCP_KEY>" }
验证是否成功
重新打开 Codex CLI / IDE session。
在 Codex TUI 中运行
/mcp，确认rshiftserver 可用。先调用只读工具测试连接。
常见问题
配置无效：确认使用的是
config.toml和[mcp_servers.rshift]，不是 JSON。授权失败：确认
RSHIFT_MCP_KEY环境变量存在，并且值是密钥本身，不要包含Bearer前缀。工具不可见：确认工作区 MCP 已启用且套餐包含 MCP。
修改配置后无变化：重启 Codex session，或用
codex mcp --help查看当前 CLI 支持的 MCP 管理命令。
安全提醒
不要把 MCP 密钥写入共享 prompt、公开 issue 或代码仓库。需要排查时，只描述错误码和配置形状，不发送密钥明文。