Quick start

This walkthrough assumes the worker is already deployed. If you ARE the super-admin and need to deploy from scratch first, see Deploy to Cloudflare.

The fastest path is OAuth via Custom Connector (no config file, no Node). If your Claude Desktop is too old for the Custom Connector UI, use the bearer-token fallback.

1. Create a user account

OAuth needs a user identity — the master token won’t work for the connector.

1. Open the admin dashboard: https://seo-navigator-mcp.autumn-recipe-cac7.workers.dev/admin/login (or https://<your-worker>.workers.dev/admin/login if you self-host).
2. Sign in on the Master token tab with the master secret.
3. Go to Users → click + New user → fill in username + password.
4. Assign at least one site to the user. The OAuth-issued token will only see those sites.

Skip this step if a user account already exists for you.

2. Add Claude Desktop’s Custom Connector

1. Open Claude Desktop.
2. Settings → Connectors → Add custom connector.
3. Fill in:
   • Name: SEO Navigator
   • Remote MCP server URL: https://seo-navigator-mcp.autumn-recipe-cac7.workers.dev/mcp
   • Leave OAuth Client ID and OAuth Client Secret empty — Dynamic Client Registration handles them automatically.
4. Click Add.
5. A browser tab opens at /oauth/authorize. Sign in with the user account from step 1.
6. Click Approve on the consent screen. The tab closes itself.

The connector is now active. Access tokens last 1 hour and auto-refresh; you won’t have to touch this again for 30 days.

No Custom Connector button?

Some Claude Desktop builds before May 2026 don’t have the Custom Connector UI. Use the bearer-token path — it works on every version but needs Node.js installed locally.

3. Verify

Start a new chat. The 🔌 icon at the bottom should show seo-navigator with at least 31 tools available.

Ask:

List my sites.

Claude calls list_sites and returns what your user account has access to. If you see your sites, you’re set. If you see 0 tools or Disconnected, see Troubleshooting.

4. Try a real workflow

Pick whichever matches what you do:

• Write a blog post — create_draft + schedule_draft
• Build a page — Gutenberg or Elementor
• Vibe-code a page in HTML — generate HTML in Claude, deploy as Gutenberg
• Push an Astro route — full static site on Cloudflare Pages
• Content + Design team flow — markdown on GitHub

Common errors

• OAuth login screen says “No user accounts” — finish step 1 first, then retry the connector setup.
• E_AUTH / “Unauthorized” — OAuth session expired or revoked. Remove and re-add the connector.
• E_SCOPE_DENIED — your user account doesn’t have that site granted. Master-admin can grant in /admin/users.
• Tool fails with WP 400 or similar — run diagnose_site site_id="..." to see the upstream cause.