Codex CLI

要从 Codex CLI 查询 Framedash 遥测数据，请将 Framedash MCP Server 注册到 Codex。你无需插件即可获得 Claude Code 插件所提供的相同 MCP 工具。

使用 codex mcp add 注册

将服务器注册为 stdio MCP 服务器：

codex mcp add framedash \
  --env FRAMEDASH_API_KEY=fd_xxx \
  --env FRAMEDASH_PROJECT_ID=your-project-uuid \
  -- npx -y @framedash/mcp-server

--env 每个变量指定一次。FRAMEDASH_PROJECT_ID 为可选。

通过 config.toml 注册

codex mcp add 会将服务器定义保存到 Codex 配置中。若要手动注册，请在 ~/.codex/config.toml 中添加以下条目：

[mcp_servers.framedash]
command = "npx"
args = ["-y", "@framedash/mcp-server"]

[mcp_servers.framedash.env]
FRAMEDASH_API_KEY = "fd_xxx"
FRAMEDASH_PROJECT_ID = "your-project-uuid"

请将 API 密钥作为环境变量传入，切勿粘贴到聊天中。

环境变量

变量	必填	说明
`FRAMEDASH_API_KEY`	是	具有所用 MCP 工具所需 scope 的 API 密钥。
`FRAMEDASH_PROJECT_ID`	否	默认项目 UUID。
`FRAMEDASH_BASE_URL`	否	API 基础 URL（默认：`https://app.framedash.dev`）。

scope 详情请见 MCP Server。

通过 AGENTS.md 指示代理

Codex 会读取仓库的 AGENTS.md。将 Framedash 文档、CLI 和 MCP Server 的引用放入 AGENTS.md，代理便能了解如何埋点与查询。可复制的代码段请见 AGENTS.md 代码段。

Claude 技能的非插件等价物

Claude Code 插件打包了用于 SQL 查询和 CI 配方的技能。Codex 不会获得这些技能，但相同的内容可在以下页面查阅：

事件架构：可查询的列与校验规则。
故障排查：事件未到达时的排查步骤。
MCP Server：工具与资源参考。

面向 AI 代理: llms.txt