Skip to content

fix(claude): restore native MCP OAuth login - #95

Merged
lxcong merged 1 commit into
chainbase-labs:mainfrom
zzAllenn:codex/fix-claude-code-oauth
Aug 13, 2026
Merged

fix(claude): restore native MCP OAuth login#95
lxcong merged 1 commit into
chainbase-labs:mainfrom
zzAllenn:codex/fix-claude-code-oauth

Conversation

@zzAllenn

Copy link
Copy Markdown
Contributor

Summary

  • remove the Claude Code plugin API-key userConfig prompt and static Authorization header
  • let Claude Code follow the AgentKey server's 401/RFC 9728 metadata into native MCP OAuth
  • document both the /mcp Authenticate action and claude mcp login plugin:agentkey:agentkey
  • add Claude-specific regression coverage and include the Claude MCP files in the scripts test workflow paths

Root cause

Claude Code treats any configured Authorization header as an explicit choice of header authentication. When the interpolated API key is empty, the server returns 401, but Claude Code does not offer or fall back to OAuth because the header is present. Removing the header and its userConfig source restores native MCP OAuth discovery.

Impact

The runtime authentication change is limited to the Claude Code plugin path (.claude-plugin/plugin.json + root .mcp.json). The Skills CLI/API-key setup path and the Codex, Cursor, Kimi, Gemini, and Antigravity MCP configurations are unchanged.

Shared documentation and CI path filters are updated to describe and protect this Claude-specific behavior.

Validation

  • bats tests/ — 29 tests passed
  • claude plugin validate --strict . — passed
  • isolated Claude Code 2.1.228 plugin load reported Needs authentication
  • claude mcp login plugin:agentkey:agentkey --no-browser generated the AgentKey OAuth authorization URL
  • git diff --check origin/main...fork/codex/fix-claude-code-oauth — passed

@lxcong
lxcong merged commit efc2809 into chainbase-labs:main Aug 13, 2026
4 checks passed
lxcong added a commit that referenced this pull request Aug 22, 2026
🤖 I have created a release *beep* *boop*
---


##
[1.14.0](v1.13.1...v1.14.0)
(2026-08-22)


### Features

* add Cursor, Gemini CLI, and Antigravity plugin support
([#91](#91))
([49a015b](49a015b))
* add DeepSeek Harness and Kimi MCP routing
([#96](#96))
([97e3ab2](97e3ab2))


### Bug Fixes

* **claude:** restore native MCP OAuth login
([#95](#95))
([efc2809](efc2809))
* **plugins:** package Gemini releases and improve OAuth
([#94](#94))
([fbec683](fbec683))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).
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.

2 participants