Skip to content
Agent Analytics

OpenAI Codex

OpenAI Codex

For OpenAI Codex, the cleanest path today is the Agent Skills install. It keeps the workflow agent-native and does not require the MCP connector flow.

Prerequisites

Section titled “Prerequisites”
  • An Agent Analytics account at app.agentanalytics.sh
  • A valid Agent Analytics API key
  • npx available in the environment Codex uses
Section titled “Recommended: install the Agent Analytics skill”
Terminal window
npx skills add Agent-Analytics/agent-analytics-mcp

Then expose your API key to the agent environment:

Terminal window
export AGENT_ANALYTICS_API_KEY=aak_...

The skill teaches Codex how to set up tracking, query analytics, inspect project health, and run experiments from the same conversation loop.

Verify the install

Section titled “Verify the install”

Ask Codex:

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

If you have not created your first real project yet, go back to Getting Started and do that next.

Troubleshooting

Section titled “Troubleshooting”
  • If the skill installs but queries fail, check that AGENT_ANALYTICS_API_KEY is present in the environment the agent actually runs in.
  • If npx is unavailable, install the required Node.js runtime first or use the direct API route temporarily.
  • If you need endpoint-level debugging, use the API reference and test with curl.
Section titled “Related”