Skip to content

Commit 81eebfe

Browse files
JoshuaRamirezclaude
andcommitted
docs: Add Claude Code OAuth plugin warning and troubleshooting
The built-in `github@claude-plugins-official` plugin in Claude Code fails with "Incompatible auth server: does not support dynamic client registration" due to Claude Code's OAuth implementation not supporting servers without dynamic client registration (anthropics/claude-code#3273). This commit: - Adds prominent warning at top of Claude Code section explaining the issue - Adds troubleshooting section with steps to disable the conflicting plugin - Links to the relevant issue for tracking The PAT-based manual setup works reliably and should be the recommended approach until the OAuth compatibility issue is resolved. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 7c053f1 commit 81eebfe

File tree

1 file changed

+16
-0
lines changed

1 file changed

+16
-0
lines changed

docs/installation-guides/install-claude.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,8 @@
22

33
## Claude Code CLI
44

5+
> ⚠️ **Important**: Claude Code includes a built-in `github@claude-plugins-official` plugin that attempts OAuth authentication. This plugin currently fails with "Incompatible auth server: does not support dynamic client registration" due to a compatibility issue between Claude Code's OAuth implementation and GitHub's MCP server ([anthropics/claude-code#3273](https://github.com/anthropics/claude-code/issues/3273)). **Use the PAT-based setup below instead**, which bypasses OAuth entirely and works reliably.
6+
57
### Prerequisites
68
- Claude Code CLI installed
79
- [GitHub Personal Access Token](https://github.com/settings/personal-access-tokens/new)
@@ -155,6 +157,20 @@ Add this codeblock to your `claude_desktop_config.json`:
155157

156158
## Troubleshooting
157159

160+
**Built-in Plugin OAuth Errors:**
161+
162+
If you see "Incompatible auth server: does not support dynamic client registration" when running `/mcp` in Claude Code, the built-in `github@claude-plugins-official` plugin is conflicting with the manual setup. To resolve:
163+
164+
1. Disable the built-in plugin:
165+
```bash
166+
claude plugins disable github@claude-plugins-official
167+
```
168+
Or in `~/.claude/settings.json`, set `"github@claude-plugins-official": false` under `enabledPlugins`.
169+
170+
2. Use the PAT-based setup described above instead.
171+
172+
3. Verify with `claude mcp list` — you should see `github: ✓ Connected` (the manual config) and the plugin entry should no longer appear.
173+
158174
**Authentication Failed:**
159175
- Verify PAT has `repo` scope
160176
- Check token hasn't expired

0 commit comments

Comments
 (0)