MCP servers issues on Linux — page 3
Issues the maintainers labelled both platform:linux and area:mcp.
385 issues · 41 open · 344 resolved (89%) · 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 86 in the 90 before — -40%. The open backlog peaked at 67 in 2025-12 and sits at 41 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
211 of these reports name the Claude Code build they were running, spanning 115 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.296
- Claude Code v2.1.161
- Claude Code v2.1.126
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
133 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 201–300
Ranked by community engagement (reactions weighted over comments). Listing the top 300 of 385 matches; the statistics above cover all 385.
- 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__*)
- streamable-http MCP transport ignored, falls back to SSE
- Google Workspace MCP OAuth fails with Error 400: invalid_scope
- [Bug] stdio MCP server stdin closed before initialize request on startup
- [Bug] Anthropic API Error: HTTP 500 Internal Server Error
- [Feature Request] Make MCP server call timeout configurable for long-running operations
- Feature Request: Better graphics/visual asset support for game development
- Serena MCP plugin fails to connect when running from VSCode Snap terminal
- [Bug] Custom rules and MCP memories lost after context summarization
- [BUG] Native plugin manager in the VS Code extension doesn't work with claudeProcessWrapper set
- Claude-in-Chrome MCP: First tool call always fails, second succeeds
- [BUG] Claude CLI did delete my ~/.claude.json file
- [Feature Request] MCP allow list should validate against WebHook/SSE/HTTP path, not just configured name
- Agent calls tools twice after permission approval, causing redundant executions
- [Bug] Excessive token consumption on repeated task failures
- [BUG] project scoped mcp servers not listed
- MCP read-only tools blocked in plan mode despite explicit configuration
- I don't see any bug report content to analyze. Please provide the bug report details so I can generate an appropriate GitHub issue title.
- [BUG] claude mcp list causes orphaned mcp server processes
- VSCode Extension: MCP tools not exposed to AI assistant despite successful connection
- [BUG] Issue with indexing. It shows successful but index is not available after reindex.
- [Bug] LLM Processing: Incorrect Pattern Matching and Context Misalignment
- [Bug] GitHub Plugin: Unintended Issue Number Hyperlinks in Code Review
- MCP Tools Not Available to AI Despite Connected Status
- [Bug] Anthropic API: Unexpected Behavior with Opus and Sonnet Models
- Bug Report
- Bug Report
- [Bug] Inconsistent Adherence to Specified Guidelines and Rules
- [Bug] MCP Server Detection Fails with --dangerously-skip-permissions
- [BUG] [Enterprise Security] mcp__* wildcard block is ineffective; Request for org-level MCP server control and allowlist
- [BUG] Claude Code MCP OAuth2 Requirement for http servers, even in local environments
- [BUG] `claude mcp remove <name>` does not remove mcp server
- [BUG] Claude does not respect cwd on startup
- MCP Servers Fail on Raspberry Pi ARM64
- Claude Code and mcp servers on ubuntu aren't working.
- [BUG]
- MCP stdio initialize handshake no longer completes as of 2.1.282 (regression from 2.1.281) — tool calls still work, proactive server push breaks silently
- MCP OAuth credentials persisted with expiresAt: 0 and no refreshToken, forcing re-auth every session (mcp.grafana.com, mcp.slack.com)
- [BUG] Streamable HTTP MCP tool call still times out ("The operation timed out") at ~6min despite per-server timeout, CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT=0, and a requestTimeout=0 server
- [BUG] MCP server reports hasTools: true on connect and a reference client confirms tools exist, but Claude Code's session gets zero — intermittently
- [Bug] `claude mcp remove` command incompatible with MCP naming convention used by other commands
- [BUG] MCP server reports `hasTools: true` on connect and a reference client confirms tools exist, but Claude Code's session gets zero — intermittently
- MCP reconnect fails with "MCP endpoint not found" for OAuth-protected remote HTTP servers (GitLab MCP)
- Claude in Chrome: native host healthy but CLI never dials into bridge socket (Ubuntu 26.04)
- MCP HTTP client fails to resolve $defs/$ref in tool schema ("can't resolve reference")
- Retracted
- [BUG] HTTP MCP with static header auth hangs for full 30s connect timeout
- [Bug] Chrome MCP server causes tab crash on copy-paste operations
- [Bug] MCP server integration triggers unexpected model switching
- [Bug] Google Calendar MCP authentication prompt persists despite connector disabled
- [Feature Request] Add MCP server improvement capabilities
- [BUG] The built-in Google Drive connection's download_file_content tool returns base64
- [Bug] GitHub MCP Server Connection Failed
- Connected HTTP MCP server's tools never appear in tool registry (ToolSearch) even after full app restart
- HTTP-transport MCP tool call hangs indefinitely (no client-side timeout)
- [BUG] claude_design MCP server injected dynamically but endpoint returns 404
- --channels: plugin channel not binding under non-root user (works as root)
- Uncaught ZodError in channel-notification handler kills the entire MCP STDIO connection (non-string meta value)
- [Bug] MCP Serena Integration Security Issue
- VSCode mcp.json gallery and settings.json mcpServers silently launch duplicate MCP server processes for the same name
- I need more details about the issue to generate an appropriate GitHub issue title. "MCP" alone doesn't provide enough information about the specific problem. Could you provide: - What specific MCP-related problem are you experiencing? - Is this a bug or f
- Plugin MCP reconnect fails: ${CLAUDE_PLUGIN_ROOT} not substituted after /model or session reconnect
- [Bug] MCP Server Configuration Failed During Setup
- [Bug] MCP Setup Issue Detected at Startup
- [Bug] Channels plugin (Telegram) not functioning on Linux - notifications not injected into session
- MCP `.mcp.json` project-trust modal re-fires on every launch in Linux docker container (v2.1.141 and v2.1.152)
- [Bug] MCP server authentication returns HTTP 431 error
- [BUG] preview_screenshot silently hangs the session when Preview server is not found — error is logged but never returned to tool caller
- [BUG] `claude mcp serve` Bash tool output is invisible in the MCP client's transcript
- HTTP MCP transport: hardcoded 5-attempt reconnect cap leaves transport permanently dead after upstream server restart (runtime, not startup)
- Notion MCP: Claude consistently misuses page icon — pastes emoji into title text instead of (or in addition to) the icon slot
- [Bug] Claude Code connects to wrong IDE instance when multiple IDEs running
- [Bug] Insufficient error context provided
- MCP connection cache race condition in clearServerCache causes 'Already connected to a transport' crash on session resume
- [BUG] HTTP MCP server behind basic auth: stale mcpOAuth entry in .credentials.json forces OAuth flow on every session
- [BUG] In 2.1.92 MCP tool names with "__" in them cause issues
- Crash: 'useMcpToggleEnabled must be used within MCPConnectionManager' when pressing arrow key in /plugins during active prompt
- Telegram channel plugin drops messages: mcp.notification() not awaited in handleInbound
- enabledPlugins: true silently fails to start MCP server for local symlink marketplace plugins
- [BUG] MCP plugin install floods all sessions with OAuth prompts; new sessions always re-authenticate
- mcp-proxy.anthropic.com returns 502 after initial handshake — tool calls never reach backend server
- [BUG]
- claude -p hangs permanently after mid-session MCP tool call returns fetch error
- Telegram plugin: inbound notifications stop working after new session