ChatGPT (Apps SDK)

OAuth sign-in. No tokens.

This is the OpenAI-preferred install path. Settings → Connectors → Browse → BankBridge → OAuth. Works on ChatGPT web for Plus, Pro, Business, Enterprise, and Edu plans.

Step 01

Find BankBridge in the directory.

ChatGPT → Settings → Connectors → Browse. Search for “BankBridge.” Click Add.

Note: BankBridge is working its way through OpenAI’s app review. If you don’t see it yet, use the Developer Mode install meanwhile. Same server, same tools, just a different auth path.

Step 02

Sign in via OAuth.

ChatGPT opens a BankBridge sign-in window. Enter your email, click the magic link, then Allow back in ChatGPT. No API key to copy, no token to paste.

Step 03

Verify it works.

Start a new chat. Ask:

try this

how much did I spend on food last month?

ChatGPT surfaces BankBridge in the tools picker; enable it per-chat.

Apps SDK vs. Developer Mode

Two paths, same server. Apps SDK (this page) is OAuth-based, no token, approved app distribution. Developer Modeis Bearer-token, not gated by OpenAI review, but you have to paste a key. Apps SDK is the smoother path for end-users; Developer Mode is the escape hatch for devs who want to run BankBridge before OpenAI’s review completes.

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 setup_required.

Your BankBridge account has no active subscription yet, or it was canceled or is past due. The connection itself works; each tool answers with the link that finishes setup.

Fix: Visit Settings to start or restore your subscription, then connect a bank.

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.