连接 Helicone 请求与会话 MCP

通过 npx 启动本地 stdio 服务,使用 env_vars 转发 HELICONE_API_KEY。欧盟账号需注意当前服务基址的兼容限制。

Helicone 给 Codex 的是本机 stdio,不是远程 HTTP。官方 MCP 页有 Codex 专节,表名就是 helicone。包是 @helicone/mcp@latest,用 npx 起进程,再去查你账号里的请求和会话。配置使用 command 和 args。

Helicone 官方 Codex 把 HELICONE_API_KEY 写成 env 表字面量。那是把密钥嵌进 ~/.codex/config.toml,TOML 占位符也不会展开。Codex 正确写法是从启动 Codex 的那个进程转发变量名:

codex mcp add helicone -- npx @helicone/mcp@latest
[mcp_servers.helicone]
command = "npx"
args = ["@helicone/mcp@latest"]
env_vars = ["HELICONE_API_KEY"]
enabled = true
startup_timeout_sec = 60

这是 stdio,不要 codex mcp login heliconemcp add 写进用户层 ~/.codex/config.toml,对你所有项目生效。官方 TOML 没写 -y;冷启动想跳过 npm 确认,才把 args 改成 ["-y", "@helicone/mcp@latest"]。不要一上来 --yolo:查请求时若打开响应体,密钥和提示词会进上下文。

密钥从 Settings → API Keys 拿,欧盟账号走 eu.helicone.ai。变量必须在启动 Codex 的 shell 里。不要把 sk-helicone- 开头的值写进 env 表、argshttp_headers

欧盟密钥目前仍打美区 https://api.helicone.ai@helicone/mcp@latest 和仓库里的 helicone-client.ts 都把基址写死了,设 HELICONE_BASE_URL 不会被读到,请求会 401。在上游合进可读环境变量之前,不要把欧盟密钥当这台 MCP 的主路径。

官方文档 Codex 节只写了查请求、查会话。源仓 README 还多了 AI Gateway 调用;那是这台 stdio 服务器自己的工具,不是 [model_providers],也不要另起一张 HTTP 表。

网页 Cloud 不读取 ~/.codex/config.toml。配置后重新打开会话。用 codex mcp get helicone 看传输是 stdio,command 是 npx。会话里 /mcp 只是核对工具,不是登录入口。

来源