Document progressive hosted MCP onboarding

[hmishra2250]

Summary

Documents the final Stage 1 hosted MCP onboarding model in user-facing language:

• try Firecrawl immediately through keyless /v2/mcp;
• connect an account through browser OAuth on /v2/mcp-oauth;
• run unattended with an API key in an authorization header or environment reference.

What changed

• keyless /v2/mcp documentation identifies Search, Scrape, and Parse as the anonymous tools;
• Claude and ChatGPT guides use the explicit account endpoint for browser connections;
• Claude Code and other header-capable clients use API-key or environment-backed authorization;
• CIMD and DCR are described as automatic client-registration mechanisms rather than user-supplied client IDs;
• API keys are removed from recommended MCP URLs;
• recovery guidance covers gated tools, invalid credentials, quota limits, and reconnecting an account;
• existing users on /v2/mcp remain documented as compatible during migration;
• unsupported claims about automatic tool behavior and automatic session upgrading are avoided.

Publication order

Publish after DB #216, Core #3973, Web #2767, MCP #308, and Infra #305 have been reviewed and the deployed credential matrix has passed. The documentation intentionally does not publish Stage 2 context-optimization behavior.

Verification

• endpoint, credential, recovery, and compatibility claims were checked against the final runtime and Web implementations;
• local documentation validation and changed-file checks passed;
• the complete local Stage 1 composition verified the behavior described here;
• real Claude, ChatGPT, Claude Code, and Codex checks against the deployed endpoints remain the final release gate.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
firecrawl	🟢 Ready	View Preview	Jul 8, 2026, 9:48 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[hmishra2250]

Follow-up docs blockers addressed in b92011d7:

• Removed the remaining hosted MCP API-key-in-URL examples from English quickstarts and SDK guides.
• Moved key-based/headless setup to Authorization: Bearer fc-YOUR_API_KEY headers.
• Applied a repo-wide cleanup to localized copies too, so unsafe hosted MCP URL examples do not remain in translated docs.
• Kept the OAuth-first hosted endpoint as https://mcp.firecrawl.dev/v2/mcp.

Local verification re-run:

• git diff --check → clean
• Custom repo-wide scan for https://mcp.firecrawl.dev/<secret-or-placeholder>/v2/mcp → 0 matches
• npx prettier --write on all changed docs → completed
• npx mint@latest validate → blocked locally because Mintlify rejects Node 26.4.0 (mintlify is not supported on node versions 25+); remote Mintlify checks are running on the PR.