连接到 Codex

OpenAI Codex

让 Codex 使用真实产品数据：流量、关键事件、漏斗、留存、会话路径和实验结果。需要原生工具调用时使用托管 MCP；Codex 能在项目中执行命令时，也可以使用 skill 与 CLI。

通过托管 MCP 连接

使用支持远程 Streamable HTTP 和 OAuth 的 Codex 客户端。在 Codex CLI 中运行：

codex mcp add agent-analytics --url https://mcp.agentanalytics.sh/mcp
codex mcp login agent-analytics

用拥有 Agent Analytics 项目的 Google 或 GitHub 身份完成浏览器授权，无需复制账户 API key。已有可用连接时，请直接复用。

开启新对话并询问：

List my Agent Analytics projects, then show the overview for my-site for the last 7 days.

将 my-site 替换为列表中的项目。支持 MCP Apps 的客户端可以在工具结果旁显示交互视图；其他客户端仍可使用文本和结构化数据。可用分析取决于账户权限和方案。

本地插件预览

Agent Analytics 插件包含分析 skill 和托管 MCP 连接，目前可用于本地测试，尚未列入 OpenAI 公共插件目录。请按插件仓库说明使用仓库中发布的版本；本地测试包可能与公开版本不同。

skill 与 CLI 的前置条件

Codex 所使用的环境中可用 npx
可以访问你想连接到 Agent Analytics 的 Google 或 GitHub 身份，以便在 Codex 打开浏览器审批时登录

替代路径：安装 Agent Analytics skill

npx skills add agent-analytics/skills

然后告诉 Codex：

Set up Agent Analytics for this project. Install it here if needed. Open the browser for me or give me a login link, then wait. I will sign in with Google or GitHub, approve it, and paste back any finish code if you need it. Then create the project, add tracking and key events, and verify the first event.

这个 skill 会教会 Codex 如何配置跟踪、查询分析、检查项目健康状况以及运行实验，全部都在同一轮对话中完成。浏览器审批会在设置过程中创建或连接账户，所以你不需要先准备 API key。

验证安装

向 Codex 询问：

List my Agent Analytics projects
How is my-site doing this week?
Create an experiment for the signup CTA on my-site

如果你还没有创建第一个真实项目，请继续阅读 5 分钟完成第一个项目。

故障排查

MCP 未返回项目时，请确认授权了拥有这些项目的账户。
工具返回数据但没有显示视图时，请检查 MCP Apps 支持，刷新连接并开启新对话。改用 CLI 不会绕过权限或方案限制。
如果 skill 卡在审批步骤，请完成浏览器登录；如果 Codex 要求 finish code，就把它回贴给 Codex。
如果你明确选择了高级/手动 API-key 路径，请确认 AGENT_ANALYTICS_API_KEY 存在于代理实际运行的环境中。
如果 npx 不可用，请先安装所需的 Node.js 运行时，或者临时改走直接 API 路线。
如果你需要端点级调试，请使用 API reference 并用 curl 进行测试。