Skip to content

DX: MCP client OAuth (private_key_jwt) compatibility docs + Auth Logs default filter #754

Description

@ekline

Summary

Two developer-experience gaps surfaced through support while debugging MCP-over-OAuth client connections.

1. MCP client token-endpoint auth compatibility

Some MCP clients (for example, the ChatGPT connector) enforce private_key_jwt at the token endpoint even when the authorization server advertises other supported token-endpoint auth methods. This caused the /oauth/token exchange to fail for that client while the same server worked correctly with other clients. A platform fix has shipped.

  • Document the supported MCP client token-endpoint auth methods and any known client-specific quirks.
  • Document the remediation step for affected users: disconnect and reconnect the connector to force a fresh client registration with the corrected configuration.

Related: #671 (COOP header troubleshooting for OAuth popup flows in MCP clients).

2. Auth Logs default filter hides failures

When debugging a failing flow, developers reported the Auth Logs view defaults to showing success events only. The failing event that explains the error is hidden until the filter is switched to show all events, which costs debugging time.

  • Evaluate defaulting the Auth Logs view to show all events, or surfacing failures more prominently.
  • Consider exposing per-client logs on the MCP Clients page.

Related: #738 (DX for product — feature-term discoverability).

Source

Surfaced through developer support. Item 1 is shipped (docs follow-up); item 2 is a product/DX consideration.

Activity

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    DX for productDX initiatives tracked for the product teamdocumentationImprovements or additions to documentationmcp

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions