docs: document DCR redirect-URI step for MCP behind Cloudflare Access (#48)

* docs: document DCR redirect-URI step for MCP behind Cloudflare Access

Enabling Managed OAuth alone leaves MCP clients unable to finish Dynamic
Client Registration when their redirect URI isn't allowlisted, so they log
in but expose no tools (issue #47). Document allowing localhost/loopback
clients and HTTPS web-connector redirect URIs, linking Cloudflare's docs.

* docs: fold DCR redirect-URI guidance into the setup steps

Move the Dynamic Client Registration guidance from a standalone paragraph
into step 6 of the numbered list, with sub-bullets for localhost/web
redirect URIs and a footnote explaining why (logs in but no tools).

* docs: replace DCR footnote with a sub-bullet
This commit is contained in:
Ben Senescu 2026-06-28 17:58:51 -04:00 committed by GitHub
parent e4b0c53b3b
commit da06190e5f
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -66,7 +66,13 @@ Managed OAuth is required for MCP clients and is not enabled by default.
3. Find your OpenSEO application, then select `Edit`.
4. Go to `Additional settings` -> `OAuth`.
5. Turn on `Managed OAuth`.
6. Save.
6. In `Managed OAuth settings`, allow the redirect URIs your MCP clients use:
- Allow `localhost` / loopback clients — for CLI and desktop agents (Codex
CLI, Claude Code) that register `http://localhost:PORT/callback`.
- Add HTTPS redirect URIs for web connectors (a path may end in `/*`).
- Without this, clients can't finish [Dynamic Client Registration](https://developers.cloudflare.com/cloudflare-one/access-controls/applications/http-apps/managed-oauth/)
and log in but expose no tools.
7. Save.
MCP clients should connect to: