Document OAuth invalid_grant errors and malformed URL handling

[mintlify]

Updates the OAuth Conformance troubleshooting table to reflect two improvements from a recent PR: actionable invalid_grant error messages that include the authorization server's reason, and graceful handling of non-absolute URLs in the OAuth sequence diagram.

Files changed:

• docs/cli/oauth-conformance.mdx — added a new token_request 400 invalid_grant troubleshooting row and expanded the received_resource_metadata — AS URL mismatch row to cover non-absolute URL values and mention the sequence diagram annotation behavior

---

Summary by cubic

Documents actionable invalid_grant token errors and flags non-absolute authorization_servers URLs to speed up OAuth troubleshooting.

• Adds a troubleshooting row for token_request 400 invalid_grant with common causes; the CLI now includes the authorization server’s reason (e.g., "Token is not active").
• Expands received_resource_metadata — AS URL mismatch to cover non-absolute authorization_servers values; require an absolute AS URL (e.g., https://auth.example.com) that serves /.well-known/oauth-authorization-server. The sequence diagram annotates non-absolute values with "(not an absolute URL)".

^{Written for commit cdd749c. Summary will update on new commits.}

[chatgpt-codex-connector]

Codex usage limits have been reached for code reviews. Please check with the admins of this repo to increase the limits by adding credits.
Credits must be used to enable repository wide code reviews.

[mintlify]

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

Project	Status	Preview	Updated (UTC)
mcpjam	🔴 Failed	–	Aug 17, 2026, 6:58 PM

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

[chelojimenez]

✅ Snyk checks have passed. No issues have been found so far.

Status	Scan Engine	Critical	High	Medium	Low	Total (0)
✅	Open Source Security	0	0	0	0	0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.

[github-actions]

Auto-approved: the Mintlify triage classifier verified this docs-only PR against the code and queued it for merge.

[github-actions]

Internal preview

Preview URL: https://mcp-inspector-pr-4068.up.railway.app
Deployed commit: 2767d13
PR head commit: 59eccb8
Backend target: staging fallback.
Health: ✅ Convex reachable
Access is employee-only in non-production environments.