Codex (OpenAI)

Codex speaks stdio MCP, so it connects to the hosted Keupera server through the mcp-remote bridge. Authorize with OAuth (browser sign-in) or an API key.

mcp-remote runs via npx, so you need Node.js installed. No global install is required.

Add the server

Add Keupera to ~/.codex/config.toml:

[mcp_servers.keupera]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.keupera.com/mcp"]

Authorize

Start Codex. On first use, mcp-remote opens your browser to sign in to Keupera and Allow access. The token is cached and refreshed automatically.

Option B — API key

[mcp_servers.keupera]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.keupera.com/mcp", "--header", "Authorization: Bearer sk_live_your_key"]

Get your key from Settings → API Keys in the dashboard.

Verify and use

Restart Codex and confirm the keupera tools are listed, then ask, for example: “List my tracked keywords by opportunity and draft an article for the top one.”

Troubleshooting

Tools don't appear / server won't start

Confirm Node.js is installed (node --version) and that the TOML block is valid. Restart Codex to reload the config.

Claude Code Gemini CLI

Overview

Connect

Guides

Reference

Option B — API key

Verify and use

Troubleshooting

​Option A — OAuth (sign in)

​Option B — API key

​Verify and use

​Troubleshooting

Option A — OAuth (sign in)

Option B — API key

Verify and use

Troubleshooting