Documentation

Install the Codex plugin

Four short paths depending on your setup.

Step 1
Set environment variables
Copy-Item .env.example .env
Step 2
Add your key
Set AMBIGUITY_COMPILER_MODEL_PROVIDER and the matching server-only API key in the environment that runs the MCP server.
Step 3
Start MCP
cd mcp-server; bun run start
Step 4
Connect in Codex
Add the running stdio server as ambiguity-compiler in your Codex MCP settings.

Troubleshooting

  • Live compilation fails: verify the selected provider and matching API key.
  • Schema errors: choose a model that supports strict structured outputs.
  • Records are local JSON data, not a multi-user or cloud database.