Skip to content

docs: Add Claude Code OAuth plugin warning and troubleshooting #1833

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
JoshuaRamirez wants to merge 1 commit into
base: main
Choose a base branch
from
+16 −0
Open

docs: Add Claude Code OAuth plugin warning and troubleshooting #1833

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions docs/installation-guides/install-claude.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@

## Claude Code CLI

> ⚠️ **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.
Copy link

Copilot AI Jan 16, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The warning message is very long (over 60 words in a single sentence). Consider breaking it into multiple sentences or bullet points for better readability. For example: Start with the problem statement, then explain the cause, and finally provide the solution in separate sentences.

Suggested change
> ⚠️ **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.
> ⚠️ **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.** It bypasses OAuth entirely and works reliably.

Copilot uses AI. Check for mistakes.

### Prerequisites
- Claude Code CLI installed
- [GitHub Personal Access Token](https://github.com/settings/personal-access-tokens/new)
Expand Down Expand Up @@ -155,6 +157,20 @@ Add this codeblock to your `claude_desktop_config.json`:

## Troubleshooting

**Built-in Plugin OAuth Errors:**

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:

1. Disable the built-in plugin:
Copy link

Copilot AI Jan 16, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The troubleshooting step mentions setting the value in settings.json under enabledPlugins but doesn't explain the exact JSON structure. Consider adding a brief example showing the complete JSON path, such as: {\"enabledPlugins\": {\"github@claude-plugins-official\": false}} to make it clearer for users unfamiliar with the file format.

Copilot uses AI. Check for mistakes.
```bash
claude plugins disable github@claude-plugins-official
```
Or in `~/.claude/settings.json`, set `"github@claude-plugins-official": false` under `enabledPlugins`.

2. Use the PAT-based setup described above instead.

3. Verify with `claude mcp list` — you should see `github: ✓ Connected` (the manual config) and the plugin entry should no longer appear.

**Authentication Failed:**
- Verify PAT has `repo` scope
- Check token hasn't expired
Expand Down
Loading