Follow Discord
Sweep 03 Nov 2026 · 22:27Z Build v2.1.318 536 read Stable v2.1.311 Latest v2.1.318 Next v2.1.318 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.317 ·

MCP sign-in can insist on the host's own redirect address with redirectUriOnly

mcp_authenticate gains redirectUriOnly, which fails sign-in instead of falling back to a localhost listener when the custom redirect is rejected

Group of 5 Use it now Internal Changes
JSON All of v2.1.317
Use it nowTier: how much it should matter to you
4Useful: my rating, 1 to 5
2Signal: worth watching, 1 to 5
MCPArea: what it touches
Internal ChangesKind: in v2.1.317,
What probably matters to youSection of the release

Unclear What redirectUriOnly changes about the sign-in is not stated.

What

mcp_authenticate is the request that apps built on Claude Code, such as SDK hosts and Remote Control, send to sign in to an MCP server (an outside service that gives Claude extra tools). Sign-in uses OAuth, which sends you back to a redirect address once you approve access. That request now accepts a redirectUriOnly option.

  • The SDK's mcpAuthenticate method takes a third argument and forwards its redirectUriOnly field. Remote Control's onMcpAuthenticate also takes it and passes it on to the sign-in flow.
  • When it is set, the supplied redirectUri is checked up front, and the check for a pre-registered clientId or registration is skipped.
  • If the authorization server rejects the custom redirect address, sign-in fails with an 'MCP OAuth failed for' error instead of falling back to a listener on this computer (localhost). Before, it always fell back silently.
  • It is refused when the request names no redirectUri, or when the server's config sets oauth.clientId or oauth.xaa, because sign-in might then need a callback on this computer. The message is 'MCP OAuth refused: redirectUriOnly with a configured client'.
  • These failures use a new error code, mcp_redirect_uri_unusable, in place of mcp_client_registration_unavailable.
  • Separately, Remote Control's startup now stops early if Remote Control was turned off while it was still starting.

Why

Hosts that own their redirect address, such as web or remote clients, now get a clear failure instead of a localhost redirect that cannot work for them.

How sure we are
Something disagreesSomething we can check disagrees with this entry, or the writer said they could not settle it.
The writer flagged doubtWhat `redirectUriOnly` changes about the sign-in is not stated.

See this entry in the whole of v2.1.317 →

Feedback