claude-code - 💡(How to fix) Fix [BUG] Plugin MCP tools not injected despite server showing "Connected" [3 comments, 3 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#49019Fetched 2026-04-17 08:53:07
View on GitHub
Comments
3
Participants
3
Timeline
14
Reactions
0
Author
Timeline (top)
labeled ×5cross-referenced ×4commented ×3mentioned ×1

Error Message

Error Messages/Logs

Error Messages/Logs: available. No error is surfaced — tools are silently missing.

Code Example

Error Messages/Logs:                                                          
                                                                                
  $ claude mcp list                                                             
                                                                                
  plugin:cortex:cortex: node                                                    
  ~/.claude/plugins/cache/cortex/cortex/2.1.2/dist/mcp-server.js -Connected
  codex-plugin-cc: npx @openai/codex-plugin-cc -Failed to connect
                                                                                
  Plugin MCP shows "Connected" but zero tools from it appear in the session's
  deferred tools list. No mcp__plugin_cortex_cortex__* or similar tool names are
   available. No error is surfaced — tools are silently missing.
                                                                                
  All non-plugin MCPs (9 servers via project .mcp.json) inject tools normally in
   the same session.                                                            

  Direct MCP handshake confirms server works:                                   
  $ echo '{"jsonrpc":"2.0","id":1,"method":"initialize",...}' | node
  dist/mcp-server.js                                                            
  {"jsonrpc":"2.0","id":1,"result":{"protocolVersion":"2024-11-05","capabilities
  ":{"tools":{}},"serverInfo":{"name":"cortex-memory","version":"2.0.3"}}}      
                                                                                
  No Claude Code debug logs found at ~/.claude/logs/ or ~/Library/Logs/.
RAW_BUFFERClick to expand / collapse

Preflight Checklist

  • I have searched existing issues and this hasn't been reported yet
  • This is a single bug report (please file separate reports for different bugs)
  • I am using the latest version of Claude Code

What's Wrong?

Plugin-registered MCP servers connect successfully but their tools never appear in sessions (not in deferred tools list, not callable). This affects all plugin MCPs — not just one specific plugin. Non-plugin MCPs (registered via project .mcp.json) work perfectly.

Diagnosis

The plugin framework correctly handles hooks, skills, and statusline — only the MCP tool injection pathway is broken. Since this affects multiple unrelated plugins while all non-plugin MCPs work fine, this appears to be a regression in the plugin → MCP tool injection mechanism.

Timeline

  • Worked correctly before ~April 14, 2026 (Claude Code ~2.1.109)
  • Broke during a session and has not recovered since
  • Persists across reinstalls, restarts, and config changes

What Should Happen?

Plugin MCP servers that show "✓ Connected" in claude mcp list should have their tools injected into the session's deferred tools list (e.g. mcp__plugin_cortex_cortex__cortex_recall), just like project .mcp.json servers do. Plugin hooks and skills already inject correctly — only MCP tool injection is broken.

Error Messages/Logs

Error Messages/Logs:                                                          
                                                                                
  $ claude mcp list                                                             
                                                                                
  plugin:cortex:cortex: node                                                    
  ~/.claude/plugins/cache/cortex/cortex/2.1.2/dist/mcp-server.js - ✓ Connected
  codex-plugin-cc: npx @openai/codex-plugin-cc - ✗ Failed to connect
                                                                                
  Plugin MCP shows "Connected" but zero tools from it appear in the session's
  deferred tools list. No mcp__plugin_cortex_cortex__* or similar tool names are
   available. No error is surfaced — tools are silently missing.
                                                                                
  All non-plugin MCPs (9 servers via project .mcp.json) inject tools normally in
   the same session.                                                            

  Direct MCP handshake confirms server works:                                   
  $ echo '{"jsonrpc":"2.0","id":1,"method":"initialize",...}' | node
  dist/mcp-server.js                                                            
  {"jsonrpc":"2.0","id":1,"result":{"protocolVersion":"2024-11-05","capabilities
  ":{"tools":{}},"serverInfo":{"name":"cortex-memory","version":"2.0.3"}}}      
                                                                                
  No Claude Code debug logs found at ~/.claude/logs/ or ~/Library/Logs/.

Steps to Reproduce

  1. Install any plugin that provides an MCP server (e.g. claude plugin install cortex)
  2. Verify plugin is enabled in ~/.claude/settings.json → enabledPlugins
  3. Restart Claude Code
  4. Run claude mcp list — plugin MCP shows "✓ Connected"
  5. In session, check deferred tools — zero tools from plugin MCP appear

Claude Model

Opus

Is this a regression?

Yes, this worked in a previous version

Last Working Version

~2.1.109 ~April 14, 2026

Claude Code Version

2.1.110

Platform

Other

Operating System

macOS

Terminal/Shell

Terminal.app (macOS)

Additional Information

What works

  • Plugin hooks fire correctly (SessionStart, PostToolUse, PreCompact)
  • Plugin skills appear and are invocable (/cortex-setup, /cortex-manage, etc.)
  • Plugin statusline works (configured via settings.json)
  • Plugin MCP server responds correctly to direct handshake: echo '{"jsonrpc":"2.0","id":1,"method":"initialize",...}' | node dist/mcp-server.js

Returns: protocolVersion, capabilities: {tools: {}}, serverInfo

  • tools/list returns all 11 tools correctly when called directly
  • All project .mcp.json MCPs (Python-based, 9 servers) inject tools normally

What doesn't work

  • Plugin MCP tools never appear in the deferred tools list
  • No mcp__plugin_cortex_cortex__* or mcp__cortex__* tools available
  • Same failure for codex-plugin-cc — shows "✗ Failed to connect"
  • Restarting Claude Code, terminal, full machine reboot — no change
  • Uninstalling and reinstalling the plugin — no change

Configuration verified

// ~/.claude/settings.json
{ "enabledPlugins": {
"cortex@cortex": true,
"codex@openai-codex": true
} }

// settings.local.json
{ "enableAllProjectMcpServers": true, "enabledMcpjsonServers": ["plugin_cortex_cortex", "cortex", ...]

extent analysis

TL;DR

The issue is likely due to a regression in the plugin → MCP tool injection mechanism, and downgrading to version ~2.1.109 may resolve the issue.

Guidance

  • Verify that the plugin MCP server is correctly configured and responding to direct handshakes.
  • Check the enabledPlugins setting in ~/.claude/settings.json to ensure the plugin is enabled.
  • Try downgrading to version ~2.1.109 to see if the issue is resolved.
  • Review the plugin's MCP server implementation to ensure it is correctly registering tools.

Example

No code snippet is provided as the issue is likely related to a version regression rather than a code implementation issue.

Notes

The issue appears to be specific to plugin-registered MCP servers and does not affect non-plugin MCPs. The fact that plugin hooks and skills are working correctly suggests that the issue is isolated to the MCP tool injection pathway.

Recommendation

Downgrade to version ~2.1.109, as this version is reported to have worked correctly in the past. This should resolve the issue until a fix is available for the current version.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING