Skip to content

fix(oauth): omit resource param on token refresh - #2645

Closed
Epochex wants to merge 4 commits into
modelcontextprotocol:mainfrom
Epochex:fix/oauth-refresh-resource-param
Closed

fix(oauth): omit resource param on token refresh#2645
Epochex wants to merge 4 commits into
modelcontextprotocol:mainfrom
Epochex:fix/oauth-refresh-resource-param

Conversation

@Epochex

@Epochex Epochex commented May 19, 2026

Copy link
Copy Markdown

Fixes #2578.

Entra ID v2.0 rejects RFC 8707
esource on refresh token requests, and Pydantic AnyHttpUrl normalizes bare-domain URLs with a trailing slash.

Changes:

  • Strip the trailing slash when deriving the RFC8707 resource from PRM metadata.
  • Do not include
    esource in
    efresh_token grant requests.

Tests:

  • uv run --frozen pytest tests/client/test_auth.py -k get_resource_url_strips_trailing_slash_from_bare_domain_prm
  • uv run --frozen pytest tests/client/test_auth.py -k refresh_token_request_omits_resource_even_when_required_by_protocol
  • uv run --frozen python -m ruff check src/mcp/client/auth/oauth2.py tests/client/test_auth.py
  • uv run --frozen python -m ruff format src/mcp/client/auth/oauth2.py tests/client/test_auth.py

@maxisbey

Copy link
Copy Markdown
Contributor

Thanks for the PR. Closing in favor of #2590, which was opened first (May 13) and covers the same two fixes — dropping resource from the refresh_token grant and undoing Pydantic's trailing-slash normalization on the PRM resource URL — with equivalent test coverage.

One substantive difference worth noting: this PR strips the slash with .rstrip("/"), which also removes intentional trailing slashes from non-root paths (e.g. https://api.example.com/mcp/…/mcp). RFC 9728 requires exact-string identity on the resource identifier, so #2590's narrower approach (only strip when the path is exactly / with no query or fragment) is the safer one.

If you spot anything #2590 misses, a review there would be welcome.

AI Disclaimer

@maxisbey maxisbey closed this May 27, 2026
@Epochex

Epochex commented May 27, 2026

Copy link
Copy Markdown
Author

Thanks, that makes sense. I checked #2590 and it covers both changes; its root-only normalization is the better behavior for exact resource identifiers. I don't see anything from this PR to carry over.

fede-kamel added a commit to fede-kamel/python-sdk that referenced this pull request Aug 19, 2026
…railing slash from PRM resource

Two compounding bugs broke silent token refresh against Microsoft Entra
ID v2.0 (AADSTS9010010), causing MCP servers using Entra OAuth to lose
authentication after ~1 hour:

- _refresh_token() sent the RFC 8707 resource parameter on
  refresh_token grants, which Entra v2.0 strictly rejects since
  March 2026. The parameter is now omitted from refresh requests.
- Pydantic's AnyHttpUrl normalizes bare-domain PRM resource URLs to
  include a trailing slash, so the resource audience never matched the
  IdP app registration. get_resource_url() now strips the slash, but
  only when the path is exactly "/" with no query or fragment - RFC
  9728 requires exact-string identity, so intentional trailing slashes
  on deeper paths are preserved.

Implements the approach maintainers endorsed when consolidating earlier
attempts (modelcontextprotocol#2590, since closed unmerged; see discussion on modelcontextprotocol#2645/modelcontextprotocol#2646).

Fixes modelcontextprotocol#2578
fede-kamel added a commit to fede-kamel/python-sdk that referenced this pull request Aug 20, 2026
…railing slash from PRM resource

Two compounding bugs broke silent token refresh against Microsoft Entra
ID v2.0 (AADSTS9010010), causing MCP servers using Entra OAuth to lose
authentication after ~1 hour:

- _refresh_token() sent the RFC 8707 resource parameter on
  refresh_token grants, which Entra v2.0 strictly rejects since
  March 2026. The parameter is now omitted from refresh requests.
- Pydantic's AnyHttpUrl normalizes bare-domain PRM resource URLs to
  include a trailing slash, so the resource audience never matched the
  IdP app registration. get_resource_url() now strips the slash, but
  only when the path is exactly "/" with no query or fragment - RFC
  9728 requires exact-string identity, so intentional trailing slashes
  on deeper paths are preserved.

Implements the approach maintainers endorsed when consolidating earlier
attempts (modelcontextprotocol#2590, since closed unmerged; see discussion on modelcontextprotocol#2645/modelcontextprotocol#2646).

Fixes modelcontextprotocol#2578
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

OAuth token refresh sends RFC 8707 resource parameter that Entra ID v2.0 rejects (AADSTS9010010)

2 participants