Project scope MCP servers not displayed in claude mcp list command

Found 3 possible duplicate issues:

1. https://github.com/anthropics/claude-code/issues/1955
2. https://github.com/anthropics/claude-code/issues/3826
3. https://github.com/anthropics/claude-code/issues/2156

This issue will be automatically closed as a duplicate in 3 days.

• If your issue is a duplicate, please close it and 👍 the existing issue instead
• To prevent auto-closure, add a comment or 👎 this comment

🤖 Generated with Claude Code

Hey there,

Just another user here, but wanted to chime in and say this is a really well-documented bug report. It's definitely confusing when the servers are clearly working (based on the approval prompt and in-session usage) but don't show up in the main list command.

It really does seem like a reporting bug in both claude mcp list and the /mcp slash command, rather than a functional issue. I was digging through the docs and the changelog, and everything confirms that project-scoped servers are a core feature (since v1.0.50 according to the changelog). The claude mcp list command was even updated in v1.0.58 to improve health status display, so it's strange that it's missing this scope.

Workaround

In the meantime, here's workarounds that might help you out:

1. For checking a specific server: As you noted, claude mcp get <server-name> works perfectly to confirm a single project-scoped server is configured correctly.

1. For listing all project servers: Since the info is right there in the .mcp.json file, you can use a quick shell command to list the server names directly. If you have jq installed, this works nicely:

``bash
# In your project root, run this to list the names of all configured project servers
jq -r '.mcpServers | keys[]' .mcp.json
``

It's not as good as the built-in command (no status info), but it at least gives you a quick list of what Claude should be seeing from the project config.

It's good that you referenced the other closed issues. Hopefully, with your detailed reproduction steps, the team can get this display issue patched up for good. Until then, hope the jq trick helps

same problem here: .mcp.json is not read anymore. What is happening?

EDIT: I ran claude --debug and saw an error with my permissions.allow config/array (in settings.local.json). This is the line that was the cause of not loading mcp's: "Bash(find *)". The error was:

[DEBUG] Invalid settings in localSettings source - key: permissions.allow.9, error: [
  {
    "code": "custom",
    "message": "Use \":*\" for prefix matching, not just \"*\". Change to \"Bash(find :*)\" for prefix matching. Examples: Bash(npm run:*), Bash(git:*)",
    "params": {
      "received": "Bash(find *)"
    },
    "path": [
      "permissions",
      "allow",
      9
    ]
  }
]

TLDR; Remove all permissions in settings.local.json and see if it is working again.

https://github.com/anthropics/claude-code/issues/5963#issuecomment-3243051224
This solution solved my problem!
I removed the invalid settings reported and restarted claude, and the mcp server start working. Thanks!

Facing the same issue:

I have configured several MCP-servers (Supabase, Clickup, Context7) via .mcp.json in many projects.

However, on a new project i started to add this file too in the root-folder and restarted CC, but the mcp list is still missing (message: No MCP servers configured)

Running /doctor provides no useful information:

 Diagnostics
 └ Currently running: npm-global (1.0.108)
 └ Path: /Users/xxx/.nvm/versions/node/v20.17.0/bin/node
 └ Invoked: /Users/xxxx/.nvm/versions/node/v20.17.0/bin/claude
 └ Config install method: unknown
 └ Auto-updates enabled: default (true)
 └ Update permissions: Yes
 └ Search: OK (vendor)

But when I make a mistake in the .mcp.json, like using an API-Key as shell-variable that is not provided, the /doctor command will tell me "invalid or unexpected ENV variable". Fixing it back to the original state, hides this error message but doesnt list any mcp config either.

Running the command jq -r '.mcpServers | keys[]' .mcp.json (as suggested by @coygeek) will even list all configured servers.

After running doctor --debug (as mentioned here https://github.com/anthropics/claude-code/issues/5963#issuecomment-3243051224) it suddenly detected my mcp-config in the local file .mcp.json.
Now it sees the mcp-config even without running the debug-mode.

Regarding the broken settings.json, which obviously causes CC to load local MCP configs, I asked Claude Code to write a script for fixing the settings accordingly: https://github.com/itinance/cc-settings-fixer

Feel free to automate!

adding "enableAllProjectMcpServers": true to my settings.local.json or your global settings.json fixed it for me.

Project-scoped MCP servers not listed due to invalid settings; fixed by permission pattern changes

Summary: Project-scoped MCP servers defined in .mcp.json were not showing up and /mcp initially reported none. The root cause was invalid Bash permission patterns in .claude/settings.json, which caused project settings (including enabledMcpjsonServers) to be ignored. After fixing the patterns to use :* suffix matching and removing unsupported mid-command wildcards, claude mcp list and /mcp both showed connected servers, and everything worked as expected.

Environment

• Node.js: v20.19.5
• Claude Code v1.0.117
• MCP servers:
• Context7 via bunx -y @upstash/context7-mcp@latest
• Claude Flow via claude-flow mcp start

Symptoms

• claude mcp list returned “No MCP servers configured” even after adding entries with --scope project.
• /mcp inside a Claude Code session showed no servers and a notice about invalid settings.
• claude --debug repeatedly logged “Invalid settings in projectSettings source” pointing to permissions.allow and permissions.deny.

Key debug output (excerpt)

[DEBUG] Invalid settings in projectSettings source - key: permissions.allow.0, error: 
  Use ":*" for prefix matching, not just "*". Change to "Bash(claude-flow :*)"
...
[DEBUG] Invalid settings ...
  Wildcards in the middle of commands are not supported. 
  Received: "Bash(curl * | bash)" and "Bash(wget * | sh)"

Root cause

• Bash permission patterns in .claude/settings.json used bare * (e.g., Bash(git log *)) and unsupported mid-command wildcards (e.g., Bash(curl * | bash)), which invalidated the entire settings file.
• Because settings were invalid, enabledMcpjsonServers was not applied, so project .mcp.json servers were effectively blocked.

Fix

• Replaced every Bash(<prefix> *) with Bash(<prefix> :*) (prefix matching with :* only at the end).
• Removed mid-command wildcards and normalized denies to prefix patterns.

Before (invalid examples):

"Bash(claude-flow *)",
"Bash(bun test *)",
"Bash(git diff *)",
"Bash(curl * | bash)",
"Bash(wget * | sh)",
"Bash(eval *)"

After (valid examples):

"Bash(claude-flow :*)",
"Bash(bun test :*)",
"Bash(git diff :*)",
"Bash(bash:*)",
"Bash(sh:*)",
"Bash(eval :*)"

Result

• claude mcp list now shows:
• context7: bunx -y @upstash/context7-mcp ... - ✓ Connected
• claude-flow: claude-flow mcp start - ✓ Connected
• /mcp UI shows “Status: connected” with the expected tools and capabilities for both servers.

Suggestion for UX/docs

• When settings are invalid, surface a clear banner in /mcp and claude mcp list indicating that project servers are blocked due to settings validation errors, and point to the exact invalid keys.
• Optionally highlight that project-scoped servers require valid settings for approval (enabledMcpjsonServers or enableAllProjectMcpServers) to avoid the “No servers configured” confusion when .mcp.json is otherwise correct.

Can confirm this issue when using official project-scope methods, but it's resolved by the workaround from #9189.

Test without workaround (both official methods tried):

• Method 1: Used claude mcp add --scope project to add servers via CLI
• Method 2: Manually created .mcp.json with three MCP server configurations
• Result with both methods: claude mcp list output: "No MCP servers configured"

Test with workaround from #9189:

• Added .claude/settings.local.json with minimal configuration
• Result: claude mcp list correctly shows all three project-scoped servers

Conclusion:
This issue appears to be a symptom of #9189. When project-scoped servers fail to load (due to missing approval flow), they also don't appear in claude mcp list. Once the workaround from #9189 is applied and servers load correctly, claude mcp list works as expected.

Suggest this issue may be auto-resolved once #9189 is fixed.

Environment: macOS 26.0.1, Claude Code v2.0.27

Can confirm this issue is still present in Claude Code v2.0.37 on macOS (Darwin 24.6.0).

Issue still exists in CC v2.0.55

I has the same problem in Claude Code 2.0.60.

+1

 Diagnostics
 └ Currently running: npm-global (2.0.62)
 └ Path: /Users/dkrom/.nvm/versions/node/v24.11.0/bin/node
 └ Invoked: /Users/dkrom/.nvm/versions/node/v24.11.0/bin/claude
 └ Config install method: global
 └ Auto-updates: default (true)
 └ Update permissions: Yes
 └ Search: OK (vendor)

This issue has been inactive for 30 days. If the issue is still occurring, please comment to let us know. Otherwise, this issue will be automatically closed in 30 days for housekeeping purposes.

+1

Closing for now — inactive for too long. Please open a new issue if this is still relevant.

This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.