---
title: "连接 Helicone 请求与会话 MCP"
summary: "通过 npx 启动本地 stdio 服务，使用 env_vars 转发 HELICONE_API_KEY。欧盟账号需注意当前服务基址的兼容限制。"
category: mcp
level: starter
surfaces: [cli, app, ide]
tags: ["MCP", "Helicone", "stdio", "观测"]
canonical: /tips/mcp-helicone-stdio/
---

# 连接 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 的那个进程**转发变量名：

```bash
codex mcp add helicone -- npx @helicone/mcp@latest
```

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

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

密钥从 [Settings → API Keys](https://us.helicone.ai/settings/api-keys) 拿，欧盟账号走 [eu.helicone.ai](https://eu.helicone.ai/settings/api-keys)。变量必须在启动 Codex 的 shell 里。不要把 `sk-helicone-` 开头的值写进 `env` 表、`args` 或 `http_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` 只是核对工具，不是登录入口。

## 来源

- [Helicone · MCP Server](https://docs.helicone.ai/integrations/tools/mcp)
- [Helicone/helicone · helicone-mcp](https://github.com/Helicone/helicone/tree/main/helicone-mcp)
- [@helicone/mcp](https://www.npmjs.com/package/@helicone/mcp)