Codex Cloud

Per-environment MCP config.

OpenAI’s GitHub-connected Codex runs in the cloud per environment. Add BankBridge in the environment’s settings pane — no local file editing.

Step 01

Add the server.

Codex Cloud → your env → MCP Servers

1. Codex Cloud → your environment → MCP Servers → + Add server
2. URL: https://bankbridge.money/api/mcp
3. Auth type: Bearer token
4. Token: bbk_your_api_key_here

Step 02

Verify it works.

Codex Cloud reloads the environment. In any Codex session, ask:

try this

what's my biggest expense this month?

For the local Codex CLI instead, see /docs/codex.

Troubleshooting

Client connects but shows 0 tools.

Usually the client is caching an old config, or you're on a mode that doesn't expose tools (Ask/Edit vs Agent, for example).

Fix: Fully quit + relaunch the host app. In VS Code Copilot, switch to Agent mode.

401 Unauthorized on every call.

The API key is missing, typo'd, or got revoked. Check the Authorization header starts with `Bearer ` (note the space) and ends in a key you still own.

Fix: Paste a fresh key from Settings.

Tools return a NO_CONNECTIONS warning.

You haven't linked a bank yet.

Fix: Visit Connect a bank — the bank-connect flow opens automatically, ~30 seconds.

Problems? Email hello@bankbridge.money.