MCP servers issues on macOS — page 3
Issues the maintainers labelled both platform:macos and area:mcp.
1,525 issues · 198 open · 1,327 resolved (87%) · first seen May 14, 2025
Is this getting better or worse?
This class of problem is converging. 339 new reports in the last 90 days vs 683 in the 90 before — -50%. The open backlog peaked at 322 in 2026-04 and sits at 198 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
819 of these reports name the Claude Code build they were running, spanning 172 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 31 days across 1,327 closures. Of the 1,327 closures with a recorded reason, 27% were closed as completed and 964 as not-planned or duplicate. The most recent completed fix landed in 2026-08.
Workarounds reported by the community
530 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 - 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] 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 - [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,525 matches; the statistics above cover all 1,525.
- --dangerously-load-development-channels does not register bare server: channels (inbound notifications silently dropped)
- [BUG] Managed MCP server tools permanently stuck in "Needs Approval" — users cannot approve unlisted tools, contradicting docs and UI
- [BUG] User-level MCP servers don't load in worktree sessions
- [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 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
- [BUG] Disabled marketplace plugins (nimble/wix/serena) still spawn MCP servers and open browser tabs without consent
- [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] MCP server deduplication ignores env vars and names - suppresses functionally different servers from plugins
- [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] 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
- [Bug] MCP allowlisted tools still trigger permission prompt on fresh session
- [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
- Meta Ads MCP OAuth fails: redirect_uri not registered
- [BUG] /MCP connector name not picked up for OAuth-protected servers — UUID used instead of `serverInfo.name` in Claude.ai — inconsistent behavior
- [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)
- 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.
- [BUG] Cross-session send_message shows the approval dialog in bypass/auto permission modes, then fails after clicking Approve
- Feature request: suppress the startup "N MCP servers need authentication" warning (lazy / on-demand OAuth re-auth)
- 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] claude.ai marketplace MCP server instructions inject into context on every session regardless of Tool Search
- [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
- [FEATURE] Propagate Cowork/Claude session trace context (prompt.id) into MCP tool calls via _meta (SEP-414)
- MCP elicitation form dialog clipped & not scrollable in fullscreen TUI - action buttons below viewport
- 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
- MCP server "ide" connection fails immediately on startup - IntelliJ IDEA plugin 0.1.14-beta
- [BUG] MCP client ignores MacOS keychain client secret, only uses value of MCP_CLIENT_SECRET environment variable
- 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] v2.1.105: ESC during MCP tool call kills MCP server process (regression from v2.1.104)
- MCP destructive tools silently denied without prompt in acceptEdits mode — misleading error message
- --chrome flag: MCP client never connects to Chrome native host socket
- [Bug] Notion MCP opens excessive authentication windows inconsistent with active sessions
- [BUG] MCP HTTP client fails to connect to Paper MCP server, falls back to auth prompt
- Excalidraw MCP diagrams not rendering in Claude Code (desktop app)
- Channel notifications: only first message delivered per session
- Chrome extension: MCP reports connected but never connects to native host socket
- Telegram plugin: inbound channel notifications not surfacing in conversation
- Disabled SDK MCP servers still injected into every session's --mcp-config
- Discord channel plugin: inbound notifications not delivered to conversation
- Plugin-bundled MCP servers (.mcp.json) silently ignored when allowedMcpServers is configured in managed-settings.json