MCP servers issues on Linux
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 1–100
Ranked by community engagement (reactions weighted over comments). Listing the top 300 of 353 matches; the statistics above cover all 353.
- Implement Agent-Scoped MCP Configuration with Strict Isolation
- Claude Code cannot connect to GitHub's remote MCP server using OAuth authentication
- Claude.ai MCP servers auto-injected into Claude Code without opt-in — causes OOM crashes on resource-constrained systems
- MCP servers in .claude/.mcp.json not loading properly
- [BUG] OAuth redirect_uri uses localhost instead of 127.0.0.1, violating RFC 8252 Section 7.3
- [BUG] OAuth Authentication Succeeds but MCP Reconnection Fails - Requires Restart
- [BUG] --channels mode stops processing incoming messages after first response
- [BUG] Agents Don't Inherit MCP Tool Access Despite Connected MCP Servers
- [BUG] Claude code does not obey values of MCP_TIMEOUT longer than 60 seconds
- [BUG] VSCode Extension missing MCP IDE Diagnostics tool and /bug command
- [BUG] [regression] MCP tool results invisible in 2.1.88 — outputSchema safeParse guard returns null on schema mismatch
- [BUG] Claude Code fails to expose MCP tools to AI sessions when running a local Playwright MCP server
- Task tool fails with 'Tool names must be unique' error when MCP servers are enabled
- [BUG] Claude Code CLI Isn't Detecting Project Scoped MCP Server
- [BUG] Claude.ai MCPs not showing up on Claude code
- [FEATURE] `--permission-prompt-tool ` needs minimal, working example and documentation for MCP integration with Claude Code CLI
- [BUG] MCP resources not available for subagents
- [BUG] deniedMcpServers serverName regex rejects plugin MCP server names
- Having multiple MCP servers running Eats into Context Window
- Bug: HTTP MCP client ignores no_proxy environment variable
- [BUG] `claude mcp add` command fails when options are placed before required arguments
- [BUG] HTTP/SSE MCP Transport Ignores Authentication Headers
- [BUG] `CallToolResult.structuredContent` is ignored
- Bug Report
- [BUG] Critical Bug: Claude Code Drops HTTP-Based MCP Tool Connections Mid-Session — Breaks Agent Access Despite Active Servers
- Tool Duplication in MCP SSE Server Connections Across Projects
- Systematic Service Failures - $440 Refund Request After Month of Critical Bugs (WSL2)
- [BUG] MCP server authorization prompt doesn't appear in VSCode integrated mode, only in terminal mode
- [BUG] MCP prompt not working with title
- [BUG] Claude Code sends SIGTERM to all healthy stdio MCP servers after 10-60s — root cause analysis with strace evidence
- MCP server configuration stored in ~/.claude.json is undocumented and confusing
- [BUG] Plugin marketplace UI shows plugins as disabled but their tools remain available
- [BUG] Playwright MCP Server Issue on Arch Linux
- [BUG] Built-in mcp__ide__executeCode asks for permission in VS Code pop-up for every notebook cell even if already allowed
- Request too large (max 20MB) after MCP screenshot - session becomes unusable
- [BUG] Docker-based MCP server containers not stopped when session ends
- [BUG] Remote Control: MCP permission prompts for non-read tools never surface in claude.ai/code web UI
- [BUG] --mcp-config freezes claude command with or without existing MCP config file
- [BUG] Feature flag tengu_claudeai_mcp_connectors pushed server-side without consent
- [BUG] MCP need logo_uri, client_uri, tos_uri must be parsable
- [Bug] MCP server "claude-vscode" fails with "Method not found" causing tool use concurrency 400 errors
- [BUG] MCP HTTP client doesn't re-initialize session after "Server not initialized" error
- [Bug] Playwright Screenshot: Persistent API Error for Large Image Dimensions
- [BUG] MCP tool calls hang indefinitely with no way to cancel byt itself
- [BUG] Misleading error message in /doctor when project-level .mcp.json doesn't exist
- [BUG] Global MCP config in ~./claude.json empties routinely
- Hosted Microsoft 365 MCP server OAuth fails: duplicate prompt param + unregistered redirect URIs
- Truncated MCP Tool Responses Limit Collaborative Functionality
- [BUG] ELOOP: .mcpb-cache created as self-referencing symlink in cowork plugin sessions
- [CRITICAL] Plugin-MCP Configuration Mismatch Causes Misleading 'Request Timed Out' Errors
- [BUG] Inconsistent Behavior Between CLI and VS Code Extension with Enterprise MCP Configuration
- Unhelpful error message when MCP server configuration was invalid
- [BUG] "X plugins failed to install" on first launch due to race condition with marketplace auto-install
- [BUG] When Claude Code receives HTTP 404 with a session ID error from an MCP server it should start a new session but it doesn'ty.
- [BUG] Claude Code crashes with SIGABRT during shutdown due to MCP server termination failure
- [FEATURE] Better Monorepo Support
- Command Execution Failure: MCP Command Returns Blank Response
- claude_design built-in MCP server always 404s: /v1/design/mcp uses login-OAT, not the designOauth token from /design login (v2.1.181)
- Team-spawned agents: agent frontmatter hooks don't fire, MCP servers not inherited, agent_type missing from hook payloads
- v2.1.12 regression: UI freezes after work completes or on session resume (message rendering fix broke state recovery)
- [BUG] "Anthropic marketplace requires git · Install git and restart" false positive when git already installed
- [BUG] Project-level MCP servers (.mcp.json) fail to connect starting from v2.0.71
- ENXIO error when using --mcp-config or --settings flags in VS Code/Cursor terminal
- [BUG] MCP Server Timeout Configuration Ignored in Streamable SSE HTTP Connections
- [BUG] Subagent deployment fails with "Tool names must be unique" error when using VS Code extension
- [BUG] Plugin marketplace paths hardcoded as absolute paths, breaking devcontainer usage
- MCP Tools Appearing Duplicated in Claude Code Interface
- MCP OAuth SDK sends empty User-Agent, causing 403 from WAF/Cloudflare-protected servers
- [BUG] MCP tools not available in VS Code extension due to tool search experiment (tengu_tst_kx7)
- [BUG] External MCP Servers Not Loading in Claude Code
- [BUG] Asked to authenticate gmail server by /mcp but that option is not listed
- Telegram channel plugin MCP server not spawned with --channels in v2.1.101
- [CRITICAL] MCP Server Causes 16+ Hour Hang - No Timeout or Stuck Detection
- [Feature Request] Improve Flatpak Chrome integration to support automatic detection and configuration
- Unhandled MCP Connection Closed Error in Claude Code CLI
- MCP tool calls silently drop parameters emitted after a long parameter value (v2.1.195)
- [BUG] `/mcp` menu appears to use the `Confirmation` keybindings context
- headersHelper does not expand ${CLAUDE_PLUGIN_ROOT} or set it as env var
- Channels feature silently disabled by tengu_harbor flag — breaks Telegram plugin for Max subscribers
- [BUG] MCP Tool Discovery Fails for Streamable-HTTP Transport (AgentCore)
- [BUG] Official Greptile plugin fails with "Cannot POST /register" error
- [Bug] Incorrect Atlassian MCP setup command in documentation
- [BUG] Bug: --mcp-config flag broken in v1.0.73 - treats all arguments as config files and fails schema validation
- [BUG] MCP reconnection fails with different patterns for direct command vs interactive menu
- [BUG] "parent" are double-stringified in Notion-MCP tool calls → server throws “Expected object, received string”
- [BUG] tool_use ids were found without tool_result blocks
- [BUG] Sub-agent dispatched via Agent tool stalls silently on MCP permission gate — no surface to parent CLI UI
- telegram plugin: infinite CPU loop on EPIPE (broken pipe causes uncaughtException storm)
- [Perf/Cost] Tool catalog (~24k tokens) sent uncached on every API request — cache_control breakpoint missing
- MCP stdio servers reported as 'failed' on exit despite clean shutdown
- [Bug] Footer context counter misaligned with plugin status bars causing excessive whitespace
- [BUG] MCPSearch returns "Unsupported content type: tool_reference" for MCP server tools
- Bug: disabledMcpServers setting not enforced at session startup
- [BUG] Race Condition: Folders Created with Literal Variable Names Before Expansion
- [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
- Forged `<system-reminder>` markup in subagent output is relayed unsanitized to the parent agent, impersonating a genuine system-reminder
- [BUG] Streaming partial-JSON parser silently produces empty MCP tool arguments (accumulator shear)
- [BUG] ZstdDecompressionError printed to TUI when ztsd compressed connection is disconnected.