[BUG] doctor shows schema error in .mcp.json but MCP server are loaded: mcpServers: Does not adhere to MCP server configuration schema
Resolved 💬 2 comments Opened Mar 17, 2026 by habakuk008 Closed Apr 14, 2026
Preflight Checklist
- [x] I have searched existing issues and this hasn't been reported yet
- [x] This is a single bug report (please file separate reports for different bugs)
- [x] I am using the latest version of Claude Code
What's Wrong?
When I have an .mcp.json file with mcp servers defined \doctor and \mcp tell me there is an error: mcpServers: Does not adhere to MCP server configuration schema, but mcp servers are loaded.
What Should Happen?
No error message or a specific error message (what is eactly wrong, which schema is used, ....).
Error Messages/Logs
[Failed to parse] Project config (shared via .mcp.json)
Location: C:\Users\xxx\Documents\Sourcecode\produktiv\aaa\.mcp.json
└ [Error] mcpServers: Does not adhere to MCP server configuration schema
Steps to Reproduce
- Create a file
.mcp.jsonin your repository root
{
"mcpServers": {
"microsoft-docs": {
"type": "http",
"url": "https://learn.microsoft.com/api/mcp"
}
}
}
- Start Claude Code
claude - Run
\mcpand you will get an error
> /mcp
MCP Config Diagnostics
For help configuring MCP servers, see: https://code.claude.com/docs/en/mcp
[Failed to parse] Project config (shared via .mcp.json)
Location: C:\Users\xxx\Documents\Sourcecode\produktiv\aaa\.mcp.json
└ [Error] mcpServers: Does not adhere to MCP server configuration schema
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Manage MCP servers
1 server
Project MCPs (C:\Users\xxx\Documents\Sourcecode\produktiv\aaa\.mcp.json)
> microsoft-docs · √ connected
https://code.claude.com/docs/en/mcp for help
- Run
\doctorand you will get an error:
> /doctor
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Diagnostics
└ Currently running: native (2.1.77)
└ Path: C:\Users\xxx\.local\bin\claude.exe
└ Invoked: C:\Users\xxx\.local\bin\claude.exe
└ Config install method: native
└ Search: OK (bundled)
Updates
└ Auto-updates: enabled
└ Auto-update channel: latest
└ Stable version: 2.1.58
└ Latest version: 2.1.77
MCP Config Diagnostics
For help configuring MCP servers, see: https://code.claude.com/docs/en/mcp
[Failed to parse] Project config (shared via .mcp.json)
Location: C:\Users\xxx\Documents\Sourcecode\produktiv\aaa\.mcp.json
└ [Error] mcpServers: Does not adhere to MCP server configuration schema
Version Locks
└ No active version locks
Claude Model
Sonnet (default)
Is this a regression?
I don't know
Last Working Version
_No response_
Claude Code Version
2.1.77
Platform
Anthropic API
Operating System
Windows
Terminal/Shell
PowerShell
Additional Information
_No response_
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗