Connecting to Codex

Use this guide to connect OpenAI Codex to PropampAI MCP so Codex can access your PropampAI tools while it works. It applies to the Codex CLI, the Codex desktop app, and the Codex IDE extension — all three share the same MCP configuration (~/.codex/config.toml), so you only set this up once.

Before You Start

1. Install a recent version of the Codex CLI (npm install -g @openai/codex or brew install codex) and sign in.
2. Keep this MCP endpoint ready:

• https://mcp.propamp.ai/mcp

Note: Codex talks to remote MCP servers over Streamable HTTP only. Use the /mcp endpoint above — the /mcp/sse URL from the Claude guide will not work in Codex.

Add the Server in the Codex App

In the Codex desktop app:

1. Open Settings → MCP servers → Add server.
2. Choose Streamable HTTP (not STDIO).
3. Name: propamp, URL: https://mcp.propamp.ai/mcp.
4. Complete the PropampAI sign-in when prompted.

Note: custom MCP servers are added under MCP servers, not under Plugins — the Plugins section is only for packaged bundles from the OpenAI directory. Codex web/cloud tasks do not read this configuration; PropampAI tools are available in the app, CLI, and IDE extension.

Add the Server via config.toml (CLI)

Open ~/.codex/config.toml and add:

[mcp_servers.propamp]
url = "https://mcp.propamp.ai/mcp"

Then sign in to PropampAI via OAuth:

codex mcp login propamp

Codex opens the PropampAI sign-in page in your browser. Enter your PropampAI email and password — the same credentials you use on the PropampAI web app — and return to the terminal when it confirms the login.

Alternative: Static Bearer Token

If your Codex version does not support codex mcp login, or you prefer a fixed token, point Codex at an environment variable holding a PropampAI access token:

[mcp_servers.propamp]
url = "https://mcp.propamp.ai/mcp"
bearer_token_env_var = "PROPAMP_MCP_TOKEN"

Export PROPAMP_MCP_TOKEN in your shell before starting Codex. Keep in mind access tokens expire — OAuth login is the recommended path.

Verify Connection

1. Run codex mcp list and confirm propamp appears.
2. Start a Codex session and ask something that needs PropampAI data, for example: “List my available products in the US marketplace.”
3. If Codex calls propamp tools and returns real data, setup is complete.

Troubleshooting

• 401 Unauthorized — your login expired. Run codex mcp login propamp again (or refresh the token in PROPAMP_MCP_TOKEN).
• 404 on requests mid-session — the server expired an idle session. Codex starts a new one automatically; if it doesn’t, restart the Codex session.
• Server not found / SSE errors — check the URL is exactly https://mcp.propamp.ai/mcp (no /sse suffix).
• No tools appear — update Codex to the latest version; remote MCP servers require Streamable HTTP support.