MCP servers issues on Linux — page 2
Issues the maintainers labelled both platform:linux and area:mcp.
383 issues · 39 open · 344 resolved (90%) · first seen May 19, 2025
Is this getting better or worse?
This class of problem is converging. 52 new reports in the last 90 days vs 85 in the 90 before — -39%. The open backlog peaked at 67 in 2025-12 and sits at 39 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
209 of these reports name the Claude Code build they were running, spanning 114 releases. Heaviest reporters:
- Claude Code v2.0.76
- Claude Code v2.1.63
- Claude Code v2.1.119
- Claude Code v2.1.81
- 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 35 days across 344 closures. Of the 344 closures with a recorded reason, 25% were closed as completed and 259 as not-planned or duplicate. The most recent completed fix landed in 2026-10.
Workarounds reported by the community
131 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 383 matches; the statistics above cover all 383.
- [BUG] Undocumented breaking change in MCP tool output display (sometime between 2.0.10-2.0.22): structured content now prioritized over TextContent
- [BUG] Claude code does not obey values of MCP_TIMEOUT longer than 60 seconds
- GitHub Actions: Missing Commit for New Files in Claude Workflow
- [BUG] MCP tools/list and resources/list rejected as invalid when optional ttlMs/cacheScope cache hints are omitted (protocol 2026-07-28)
- `disabledMcpServers` in `~/.claude.json` project entry has no effect on user-scope MCP servers (still connect, tools + instructions loaded)
- [BUG] ZstdDecompressionError printed to TUI when ztsd compressed connection is disconnected.
- Chrome extension service worker never initiates MCP bridge connection (Linux/AUR)
- [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
- [BUG] Cloud routines (remote_trigger) never load MCP connector tools — all connectors enabledInChat:false on 2.1.199 (regression of #35899)
- [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
- Slack MCP plugin OAuth fails with "Please specify client_id" despite client_id being sent correctly
- 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
- [BUG] Valid MCP tool silently dropped: API schema validation rejects property names containing `[]`
- 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
- CC spawns project .mcp.json stdio server twice per launch (t+0 instance outside client-manager accounting) — single-connection backends lose their tools client
- 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
- [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
- [BUG] HTTP MCP session recovery runs two initializes concurrently, leaking sessions (and failing the retried call on servers that limit sessions)
- [BUG] Serena MCP tools (activate_project / list_memories) extremely slow or time out
- [Bug] Anthropic API Error: Invalid Tool Property Name Format
- [BUG] -p/--print: stdio MCP servers stay "pending" — tool snapshot races server startup and never refreshes (regression 2.1.143 → 2.1.162)
- telegram plugin: bun server.ts leaks at 100% CPU on every MCP disconnect
- [BUG] stdio MCP tool call hangs indefinitely under `claude -p` when the full MCP fleet is loaded — regression in 2.1.177, works under --strict-mcp-config
- 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
- MCP SSE server: tools/call fails with -32602 despite valid connection and correct schemas
- [Bug] MCP setup initialization fails with multiple connection errors
- [BUG] --callback-port not respected — OAuth listener not started when using /mcp authentication flow.
- [BUG] Claude Desktop and Claude Code CLI never re-register MCP tools after OAuth 2.1 handshake on a remote HTTP server
- [BUG] 2.1.153 silently discards tools/list response from rmcp 0.12.0 HTTP MCP server (works in 2.1.152, wire-identical handshake)
- MCP tools on page 2+ of paginated tools/list dropped after ToolListChangedNotification
- Plugin-registered MCP servers don't expose tools to the AI (tools visible in `claude mcp list` but not callable)
- 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)