[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

  1. Create a file .mcp.json in your repository root
{
  "mcpServers": {
    "microsoft-docs": {
      "type": "http",
      "url": "https://learn.microsoft.com/api/mcp"
    }
  }
}
  1. Start Claude Code claude
  2. Run \mcp and 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
  1. Run \doctor and 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_

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗