MCP servers issues on Linux — page 2
Issues the maintainers labelled both platform:linux and area:mcp.
353 issues · 30 open · 323 resolved (92%) · first seen May 19, 2025
Is this getting better or worse?
This class of problem is converging. 67 new reports in the last 90 days vs 120 in the 90 before — -44%. The open backlog peaked at 67 in 2025-12 and sits at 30 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
183 of these reports name the Claude Code build they were running, spanning 98 releases. Heaviest reporters:
- Claude Code v2.0.76
- Claude Code v2.1.63
- Claude Code v2.1.81
- Claude Code v2.1.119
- Claude Code v2.1.87
- Claude Code v2.1.161
- Claude Code v2.1.126
- Claude Code v2.1.80
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 36 days across 323 closures. Of the 323 closures with a recorded reason, 26% were closed as completed and 240 as not-planned or duplicate. The most recent completed fix landed in 2026-08.
Workarounds reported by the community
114 of these issues post a workaround someone says worked. The highest-engagement ones:
- Implement Agent-Scoped MCP Configuration with Strict Isolation
- …ent files appears to be silently ignored. --- Bug 2: Forced workaround defeats the purpose of scoping Because agent-level config doesn't work, the only option right now is to add the MCP server to at the plugin level. Bu…
Found in the thread of #4476 · resolved - Claude Code cannot connect to GitHub's remote MCP server using OAuth authentication
- Current workaround for me was using a Personal Access Token and adding the MCP as follows:
Found in the thread of #3433 · still open - Claude.ai MCP servers auto-injected into Claude Code without opt-in — causes OOM crashes on resource-constrained systems
- …r's Claude.ai account and load them into every CLI session. Workaround Manually editing to set: However, this is a cached flag and may be overwritten on next update/startup. Expected Behavior 1. This should be opt-in, no…
Found in the description of #20412 · resolved - MCP servers in .claude/.mcp.json not loading properly
- …h resolution issue when loading servers from this location. Workaround Move to the root directory of the project.
Found in the description of #5037 · resolved - [BUG] OAuth redirect_uri uses localhost instead of 127.0.0.1, violating RFC 8252 Section 7.3
- …ganization using an RFC-compliant authorization server. The workaround is to register redirect URIs for every possible port, which is not practical. Additional Context - Previous issue 14079 reported the same problem but…
Found in the description of #42765 · still open
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 101–200
Ranked by community engagement (reactions weighted over comments). Listing the top 300 of 353 matches; the statistics above cover all 353.
- Chrome extension service worker never initiates MCP bridge connection (Linux/AUR)
- [MODEL] MCP tool use regression — model ignores custom MCP tools despite explicit CLAUDE.md rules and enforcement hooks
- [BUG] Cowork MCP tools broken on Fedora 42 — config silently wiped, Chrome bridge fails, local MCPs invisible
- MCP tool with invalid JSON Schema property key breaks entire session irrecoverably
- Claude-in-Chrome: MCP server ignores working native sockets, fails on WebSocket bridge auth
- [BUG] /doctor falsely reports valid .mcp.json as 'not a valid JSON'
- I'll focus on the technical issue in the error report: "V8 ToLocalChecked Empty MaybeLocal Error Causing Node.js Runtime Crash" This title: - Identifies the specific V8 JavaScript engine error - Indicates it's causing a runtime crash - Uses technical ter
- [BUG] WS client disconnected
- User Cloud Settings Persistently Resetting Unexpectedly
- Connection Failure: Sentry MCP Network Communication Error
- `disabledMcpServers` in `~/.claude.json` project entry has no effect on user-scope MCP servers (still connect, tools + instructions loaded)
- [BUG] Subagents stall waiting for MCP servers to be approved when merged into worktrees
- [BUG] MCP tool parameters using $ref enum types are serialized as null
- [BUG] MCP OAuth fails: Protected Resource domain mismatch when server uses different public URL vs internal resource URL (Asana MCP V2)
- [BUG] Pro login loads 2.9M tokens in "System tools" — makes Claude Code unusable
- Channels (Telegram) silently disabled by tengu_harbor feature flag — paying Max subscriber locked out
- MCP Streamable HTTP: ~20% intermittent timeout on tool calls taking 300-500ms
- [BUG] Claude Code intermittent crashes on Linux with IVPN — DNS resolution, MCP auth spam, and server-side instability
- [BUG] MCP servers fail on startup due to race condition — connections dropped before REPL mounts (AlmaLinux 8 / RHEL 8)
- [BUG] MCPs Failing every time, but found a quirky workaround
- Claude.ai MCP connectors feature flag disabled after update
- VS Code Extension: MCP server claude-vscode error and terminal relaunch requests cause extension to freeze
- [BUG] SSE MCP connection fails with "Could not convert argument of type symbol to string"
- [BUG] Chrome native host dies when extension service worker goes idle, breaking browser tools after initial success
- [Bug] Anthropic API Error: tool_reference blocks unsupported on claude-haiku-4-5-20251001
- [BUG] API Error: Request was aborted
- Sub-agents dispatched via Task tool have empty MCP tool registry — parent's MCP server connections don't propagate to sub-agent process
- Agent SDK: query() stream hangs 15-30 min after last tool call before emitting ResultMessage
- [BUG] MCP tool output not rendered in terminal when using native TextContent (fastmcp 3.x)
- [Bug] GitHub authentication token not recognized by Claude Code
- [BUG] HTTP MCP servers (e.g., Atlassian MCP) with pre-configured auth headers fall back to OAuth in GitHub Actions (headless CI)
- Channel notification handler stops surfacing inbound messages after ~2-3h (Docker/Linux)
- Telegram plugin: zombie bun processes cause 409 Conflict — process.ppid cached in bun runtime
- Telegram plugin: Channel notifications not waking Claude Code from idle state
- - /mcp reconnect mid-session → ❌ doesn't re-deliver env to the subprocess
- PreToolUse hook permissionDecision 'deny' not enforced for MCP server tool calls
- [BUG] Claude Code HTTP MCP Transport - Connection Failure
- [BUG] "mcp list" and "mcp get" ignore any servers provided by --mcp-config on the command line
- [BUG] Task collects data but never writes file, CPU spikes to 100%
- [Bug] Project-level MCP server not loading after v2.0.0
- [BUG] MCP tools with empty parameter schemas display without tool name/args header
- [BUG] Claude Code MCP Protocol Violation: Incorrect Resource Content Validation
- [BUG] Claude Code killing other Claude Code sessions without authorization
- MCP Connection Closed Unexpectedly During IDE Interaction
- Slack MCP plugin OAuth fails with "Please specify client_id" despite client_id being sent correctly
- [BUG] v2.1.147 regression: HTTP MCP servers without optional GET listening stream - 404 misinterpreted as session expiry, transport torn down
- [BUG] --strict-mcp-config with empty --mcp-config still fetches MCP registry and attempts user-configured servers
- v2.1.142 disconnects on remote-SSH after extension update — claude binary accumulation + MCP server flapping
- [BUG] disabledMcpjsonServers disabled when listing incorrect mcp value
- Subagent tools field does not support MCP wildcards or server-prefix shortcuts (re-opens #17928)
- [BUG] Playwright MCP (stdio) hangs/timeouts on Linux after 2.1.113+ native-binary spawn rewrite
- After my session was suspended last night due to rate...
- [BUG] v2.1.105 breaks all stdio MCP servers - stdin pipe closed immediately on spawn
- [Bug] MCP server tool registration fails silently with "required": null in inputSchema
- Telegram channel plugin: inbound notifications/claude/channel ignored by Claude Code
- MCP channel notifications silently dropped when session is idle
- MCP stdio server silently disconnects mid-session; child process orphaned to systemd
- [BUG] Cloud MCPs not loaded in `claude -p` (print/non-interactive) mode
- Telegram plugin: MCP connection drops after first inbound message
- Plan mode hangs with pause on SteamOS (Konsole) with multiple MCP servers
- [BUG] Subagents do not receive MCP server instructions
- [BUG] claude mcp serve tools not displayed in MCP clients due to missing type field in outputSchema
- [BUG] Claude in Chrome: Native messaging bridge socket never created on Linux — extension side panel works but CLI cannot connect (ENOENT)
- [BUG] Claude Code MCP client doesn't follow tools/list pagination cursors
- [BUG] Claude Desktop: Chat rollbacks/disappearing responses when using MCP tools
- [Bug] MCP Client Corrupts Base64-Encoded Binary Data in Tool Results
- [BUG] Chrome native host enters zombie state without socket, blocking all browser automation
- [Bug Report: Unable to process empty issue submission]
- [BUG] `mcp add` replaces env var names with actual env var value
- [BUG] MCP Prompts are not visible to Claude in conversation context
- [BUG] HTTP MCP transport doesn't resolve $ref in parameter schemas, causing JSON string parameters to not be parsed as objects
- SendMessage (cross-session/teammate) silently discards queued messages to a busy session: `queue-operation: remove` instead of `dequeue`
- HTTP-transport MCP server tools unreachable ("No such tool available") despite /mcp showing connected + listing tools, persists across full app restart
- MCP HTTP client sends reconnect GET missing Accept: text/event-stream, breaking tools/call after successful tools/list (406)
- [BUG] Claude Code remote HTTP MCP OAuth is not viable for plugin-installed MCP servers on remote/SSH machines, especially with Google OAuth redirect constraints
- Write/Edit tool hangs 2–4 min (ep_poll, no network/CPU) when a stdio MCP server is connected
- /mcp reconnect after config-hash-stale spawns literal unexpanded ${CLAUDE_PLUGIN_ROOT} → -32000
- [Bug] MCP setup initialization fails with multiple connection errors
- [BUG] Claude Desktop and Claude Code CLI never re-register MCP tools after OAuth 2.1 handshake on a remote HTTP server
- MCP tools on page 2+ of paginated tools/list dropped after ToolListChangedNotification
- Project-scope .mcp.json silently skipped during startup in 2.1.141 (native, Linux)
- Browser MCP tools disappear mid-session (mcp__browsermcp__* become unavailable)
- [BUG] v2.1.132: notifications/claude/channel rendered to prompt but not auto-submitted (TUI idle never starts a turn)
- Interactive mode does not spawn stdio MCP servers from project-scope .mcp.json (v2.1.131)
- [BUG] workingDirectory not updated on "! cd <dir>"
- [BUG] Re-authenticate menu crashes with JSON parse error on bearer-only MCP servers in v2.1.120 (not covered by #52158 fix)
- [Bug] Team agents crash without Opus model in auto mode
- [BUG] Cowork dispatches macOS-only extensions to Linux remote → retry loop causes remote OOM and local renderer leak
- [BUG] Two HTTP MCP servers with identical URL but different headers — only one registers (silent dedup)
- [BUG] Web-connected Gmail account overrides local Gmail MCP server configuration
- [BUG] Ctrl+O (collapse toggle) on MCP tool calls from disconnected server removes them from display
- MCP servers fail with EAGAIN when spawning inside Docker containers
- Telegram plugin: inbound channel notifications not delivered to session
- [BUG] disabledMcpServers with stdio plugin server causes silent exit(0)
- [bug] Discord MCP plugin intermittently loses gateway connection, reply fails with 'not allowlisted'
- Telegram plugin: notifications/claude/channel not delivered to client (node/npx tsx runtime)
- [BUG] MCP channel notifications not delivered to session (Discord/Telegram plugins)
- [BUG] MCP servers silently absent from /mcp when configured via mcp.json or settings.json — wrong config store
- Telegram MCP plugin: channel notifications not surfaced in conversation
- [BUG] External plugins registered twice — duplicate MCP tool namespaces (mcp__github__* and mcp__plugin_github_github__*)