MCP local configuration (.mcp.json) not being read on Windows

Resolved 💬 4 comments Opened Oct 13, 2025 by scopweb Closed Oct 13, 2025

Issue Description

Claude Code does not read or load MCP server configurations from local .mcp.json files on Windows systems.

Environment

  • OS: Windows
  • Claude Code Version: Latest
  • Reporter: scopweb

Expected Behavior

When a .mcp.json file exists in the project root, Claude Code should automatically read and load the MCP server configurations defined in it.

Actual Behavior

The .mcp.json configuration file is completely ignored. Running claude mcp list shows "No MCP servers configured" even though a valid .mcp.json file exists in the project directory with properly configured MCP servers.

Steps to Reproduce

  1. Create a .mcp.json file in the project root:
{
  "mcpServers": {
    "mysql-server": {
      "command": "C:\tools\mcp-servers\mysql-mcp.exe",
      "args": [],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "dbuser",
        "MYSQL_PASSWORD": "dbpass",
        "MYSQL_DATABASE": "mydb"
      }
    }
  }
}
  1. Open Claude Code in that project directory
  2. Run claude mcp list
  3. Result: "No MCP servers configured"

Workaround

Must manually add servers using CLI:

claude mcp add mysql-server "C:\tools\mcp-servers\mysql-mcp.exe" --env MYSQL_HOST=localhost ...

Impact

Users cannot use project-specific MCP configurations on Windows, forcing them to configure servers globally or manually each session.

Request

Please fix the .mcp.json file reading functionality on Windows so that local MCP configurations work as expected.

---
Reported by: scopweb

View original on GitHub ↗

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