Skip to content

CLI / mcpdo: --oauth-debug to show each OAuth step #2844

Closed

Description

@CloneOfAlex

Which client?

CLI

The problem

When OAuth fails in the CLI or mcpdo, the user sees only the final error. The web client has a step-by-step OAuth view (discovery, registration, authorization, token exchange); terminal users have nothing comparable, so diagnosing a misconfigured authorization server means re-running in the web client or adding a proxy.

Solution you have in mind (optional)

--oauth-debug (and an mcpdo equivalent) printing each step to stderr: protected-resource and authorization-server metadata URLs and statuses, the registration request/response, the authorization URL, and the token request/response status — with secrets, codes and tokens redacted.

Alternatives or workarounds you have tried

Reproducing the flow in the web client's OAuth view, or running through an intercepting proxy.

Already built it locally?

No response

Before you submit

  • I searched existing issues and this is not a duplicate.
  • This is a request for the Inspector itself, not for the MCP specification or an SDK.

Activity

  1. cliffhall commented on Oct 29, 2026

    @cliffhall
    Member

    Triage: Priority Low (total 5)

    • Severity 3 — terminal users have no way to see OAuth steps; the web client OAuth view is a partial workaround
    • Urgency 2 — wanted eventually, nothing blocked on it
    • Bonuses: none (no milestone, assignee, epic, engagement or reporter-set priority)

    Board: #28, Status Incoming (awaiting maintainer review — no milestone yet).

  2. added this to the v2.15.0 milestone on Oct 29, 2026
  3. Ben-Home commented on Oct 30, 2026

    @Ben-Home
  4. self-assigned this
    on Nov 5, 2026
  5. added 2 commits that reference this issue on Nov 5, 2026
    4b1a9df
    8374378
  6. cliffhall commented on Nov 5, 2026

    @cliffhall
    Member

    Shipped in #2902 (merge ecac785).

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

Metadata

Metadata

Assignees

Labels

enhancementNew feature requestv2Issues and PRs for v2

Type

No type

Projects

No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions