MCP servers issues on macOS — page 3
Issues the maintainers labelled both platform:macos and area:mcp.
1,689 issues · 199 open · 1,490 resolved (88%) · first seen May 14, 2025
Is this getting better or worse?
This class of problem is converging. 280 new reports in the last 90 days vs 495 in the 90 before — -43%. The open backlog peaked at 322 in 2026-04 and sits at 199 today.
Derived by counting each matching issue from its creation date until it closed. First-party
computation over the anthropics/claude-code tracker — the trend is not published
anywhere upstream.
Which builds report this
944 of these reports name the Claude Code build they were running, spanning 210 releases. Heaviest reporters:
- Claude Code v2.1.81
- Claude Code v2.1.119
- Claude Code v2.1.87
- Claude Code v2.0.76
- Claude Code v2.1.92
- Claude Code v2.1.19
- Claude Code v2.1.126
- Claude Code v2.1.104
Report volume, not a defect count: an issue can mention a build without that build having caused the failure. Versions come from the version string in the bug-report template, matched against real published tags.
Do these get fixed?
Median time to close is 32 days across 1,490 closures. Of the 1,490 closures with a recorded reason, 26% were closed as completed and 1,101 as not-planned or duplicate. The most recent completed fix landed in 2026-10.
Workarounds reported by the community
595 of these issues post a workaround someone says worked. The highest-engagement ones:
- Allow hiding/removing unused cloud connectors (Gmail, Google Calendar, etc.)
- …only supports true/false globally — no per-server control. Workaround Applied Set ENABLE CLAUDEAI MCP SERVERS=false in both account settings files (~/.claude-private/settings.json and ~/.claude-neo/settings.json). This…
Found in the thread of #29368 · resolved - [BUG] Claude Code does not work with MCP servers that does not implement Dynamic Client Registration
- Did you find a workaround to this problem? I am facing the same thing.
Found in the thread of #3273 · resolved - [BUG] plugin:github:github MCP fails with HTTP 400 — malformed JSON-RPC payload missing version tag
- …, so unset it explicitly: Add the token to in : This is the workaround @ph7jack posted, and the A/B above may explain why the shell-export half of it works for some people and not others: only the entry is guaranteed to…
Found in the thread of #64654 · still open - MCP OAuth regression: client metadata document redirect_uris missing port causes auth failure for providers supporting CIMD
- …tly allow wildcards for ports in callback urls. The current workaround I've found on our end is actually patching a client/application after creation (either using a random port assigned or by using the [param]( you've p…
Found in the thread of #37747 · resolved - [Bug] Jira Authentication Fails: Persistent Reconnection and Session Issues
- …nnection immediately fails due to protocol incompatibility. Workaround: Downgrade to version 2.0.9. Then restart Claude Code. The Atlassian MCP will connect successfully. Timeline: - Version 2.0.9 (released Oct 7): Works…
Found in the thread of #9127 · resolved
Excerpts are quoted from the linked issue so you can judge relevance before opening it. Threads that only ask for a workaround, or report that there is none, are excluded. These are community suggestions, not official guidance from Anthropic — read the full thread before applying one.
Matching issues 201–300
Ranked by community engagement (reactions weighted over comments). Listing the top 300 of 1,689 matches; the statistics above cover all 1,689.
- CRITICAL: Claude Code regression — model now consistently fails basic tasks and hallucinates in code analysis
- [BUG] OAuth MCP reconnection fails after successful authentication. "Authentication successful, but server reconnection failed" Version: 2.1.71
- [BUG] claude.ai Remote MCP servers not syncing to Claude Code 2.1.29
- [BUG] Tool search fails when MCP tool names exceed 64 chars
- [BUG] MCPSearch not activating despite meeting 10% threshold (40k/200k tokens, 20%)
- [BUG] Intellij Idea IDE integration fails with an exception for ktor dependency
- [BUG] MCP OAuth discovery fails with path-based routing - strips application path from discovery URLs
- [BUG] MCP server broken on 1.0.120 release
- [CRITICAL] JavaScript heap out of memory crash during MCP operations
- [FEATURE] Propagate Cowork/Claude session trace context (prompt.id) into MCP tool calls via _meta (SEP-414)
- [Bug] MCP allowlisted tools still trigger permission prompt on fresh session
- [BUG] MCP OAuth tokens not refreshed for claude.ai proxy connections (mcp-proxy.anthropic.com)
- Telegram channel plugin: MCP connection silently drops, zombie processes pile up
- [BUG] MCP tool calls collapsed by default in v2.1.81 — hides parameters and results
- [BUG] Claude Code CLI MCP connection issue
- [BUG] MCP server deduplication ignores env vars and names - suppresses functionally different servers from plugins
- [BUG] claude mcp add doesn't work with environment variables for stdio transport
- [BUG] "Jupyter notebook detected" Connect button injects mcp__jupyter tool reference, but tool is not available
- [Bug] MCP/Connector configurations disappeared from Claude Code
- Browser extension not connected - all tools return connection error
- [BUG] Claude Code doesn't use scope from WWW-Authenticate during step-up authorization
- Project-scoped MCP servers don't trigger approval prompt
- MCP Server Initialization Fails on First Run with Skip Permissions Flag
- MCP error -32000: Connection closed - Node.js uncaught exception
- macOS: concurrent claude processes zero MCP OAuth entries in shared Keychain blob despite valid refresh tokens
- [BUG] MCP Tools with draft-07 are rejected
- [BUG] Claude Code Desktop eager loading MCPs while Claude Code CLI lazy loading
- [BUG] form-mode MCP elicitation auto-declines in interactive TUI — server-initiated form is treated as "print mode"
- Channels: notifications/claude/channel delivered after a tool-only turn lands in the prompt buffer instead of starting a new turn
- [BUG] Disabled marketplace plugins (nimble/wix/serena) still spawn MCP servers and open browser tabs without consent
- [BUG] /MCP connector name not picked up for OAuth-protected servers — UUID used instead of `serverInfo.name` in Claude.ai — inconsistent behavior
- [BUG] Live Artifacts (CoworkArtifacts.callMcpTool) reject local stdio MCP servers on cold start — claude.ai relay rejects server name as non-UUID
- Sustained 502 Bad Gateway from mcp-proxy.anthropic.com (Gmail MCP)
- Telegram plugin: MCP channel notifications not delivered to conversation
- [BUG] Local stdio MCP server tools never registered as deferred tools despite successful connection (v2.1.81)
- [BUG] Figma Desktop MCP HTTP connection fails with "No session found for sessionId"
- [BUG] Single session startup triggers 429 rate limit on client_data endpoint, causing false "1 MCP server failed" status
- [BUG] MCP servers configured via CLI don't load in VSCode extension
- [BUG] Todoist MCP loses session with "No transport found for sessionId" error
- Chrome extension conflict: Claude Desktop and Claude Code CLI compete for same extension
- [BUG] `claude mcp add` expands environment variable placeholders and writes resolved values to .mcp.json
- [BUG] Inline `mcpServers` in plugin.json ignored - field dropped during manifest parsing
- [BUG] MCP Oauth - using wrong redirect_uri for remote mcp with oauth2.1
- MCP servers persist in /mcp command despite removal via `claude mcp remove`
- [BUG] claude mcp add test-mcp http://localhost:8888/endpoint -t sse -H "Authorization: Basic [base64]" ignores the -H header
- OAuth Callback Failure: Localhost Port Unreachable on Safari
- MCP elicitation form dialog clipped & not scrollable in fullscreen TUI - action buttons below viewport
- [BUG] Cross-session send_message shows the approval dialog in bypass/auto permission modes, then fails after clicking Approve
- Meta Ads MCP OAuth fails: redirect_uri not registered
- [BUG]: /mcp modal becomes unresponsive to all keys (arrows, Enter, Esc, Ctrl-C) — regression in 2.1.118/2.1.119
- Claude Code 2.1.116 freezes with main thread in V8/JSC tight loop (100% CPU, all Anthropic API connections lost, no recovery)
- computer-use MCP returns "permission(s) not yet granted" on macOS 26.5 despite comprehensive TCC grants — orphaned per-version helper at ~/Library/Application Support/Claude/claude-code/<ver>/
- [BUG] claude.ai marketplace MCP server instructions inject into context on every session regardless of Tool Search
- MCP tool calls display generic 'Called <server>' instead of tool name and params since ~2.1.105
- [BUG] Gmail connector: thread search and message reading fail despite correct OAuth scopes (read works for labels/drafts, not messages
- MCP servers from mcp.json not loaded when CLAUDE_CONFIG_DIR is set
- Skills with context: fork still inject all MCP tool definitions into subagent, ignoring allowed-tools
- Elicitation hooks not triggered with --input-format stream-json
- Claude Code enters unrecoverable CPU spin after MCP tool response
- [BUG] API Error: MCP tools cannot have both defer_loading=true and cache_control set
- [Bug] mcp-registry connector persists with invalid server ID format in Claude Desktop
- Claude Desktop hangs on quit (Cmd+Q) - requires force quit
- [BUG] MCPSearch usage breaks Haiku
- [BUG] Can't run /compact command
- [BUG] /mcp command reports 'No MCP servers configured' despite valid configuration files in ~/.claude/
- [BUG] Image format mismatch error with Playwright MCP screenshot tool
- [BUG] Figma returns PNG, but CC API expect JPG resulting in ERROR 400.
- Clear Authentication on MCP
- [Bug] MCP Authentication Fails with 404 Error for GitHub and Figma Integrations
- [BUG] Unable to disable MCP servers at system level for Claude-code (via /etc/claude-code/managed-settings.json or /Library/Application Support/ClaudeCode/managed-settings.json)
- [BUG] Claude Project MCP config should be accessible in the .claude folder
- Invalid output with error "JSON schema is invalid. It must match JSON Schema draft 2020-12"
- [BUG] --allowed-tools flag doesn't filter tools in initialization message, causing unauthorized tool access attempts
- Asana MCP Integration: 400 error, Property keys should match pattern.
- Remote MCP OAuth: shared user-scope refresh token breaks against IdPs with single-use refresh-token rotation (ODC)
- Feature request: suppress the startup "N MCP servers need authentication" warning (lazy / on-demand OAuth re-auth)
- MCP server "ide" connection fails immediately on startup - IntelliJ IDEA plugin 0.1.14-beta
- Claude in Chrome MCP returns "not connected" despite all plumbing healthy (Claude Desktop on macOS)
- [BUG] Notion MCP OAuth: complete_authentication fails when mcp.notion.com relay returns callback instead of localhost
- MCP: Silent failures make server integration opaque and hard to debug
- [BUG] HTTP MCP server without auth triggers OAuth probe in VS Code extension, fails with 404
- [BUG] HTTP OAuth MCP servers silently fail in Claude Code inside Claude Desktop — no error, no guidance
- Background subagents cannot access OAuth-authenticated MCP servers
- [BUG] authServerMetadataUrl is ignored when MCP server discovery succeeds — should override, not fallback
- You're out of extra usage · resets 4pm (America/New_York)
- claude mcp list shows 'Connected' for MCPs that are not authenticated
- Chrome integration: Claude Code never connects to native bridge socket (macOS)
- [BUG] Claude Code 2.1.69 breaks all MCP tool calls with defer_loading + cache_control conflict
- [Bug] Context compaction fails with multiple subagents
- [FEATURE] Enhanced Device Emulation for Chrome MCP
- [BUG] MCP tool streaming output causes scroll jumping/flickering with long conversation context
- Compaction error: orphaned tool_result in messages array despite valid conversation history
- [Bug] Anthropic API Error: Duplicate tool names during compaction
- Tool Name Length Exceeds 64 Character Limit in API Request
- MCP tool-result widgets render as empty boxes (Claude Code Desktop)
- Telegram plugin MCP connection drops after each conversation turn
- [BUG] Slack tools return empty `Text:` for bot messages using legacy `attachments[]` field
- meta-ads MCP OAuth fails: "redirect_uris are not registered for this client"
- VSCode Extension v2.1.141: 'Unhandled case: [object Object]' notification with no actionable details
- [BUG] MCP client ignores MacOS keychain client secret, only uses value of MCP_CLIENT_SECRET environment variable