Feature request: Support reading .mcp.json from .claude/ directory
Resolved 💬 2 comments Opened Apr 3, 2026 by yankikucuk Closed May 13, 2026
Feature Request
Summary
Allow Claude Code to read .mcp.json from the .claude/ subdirectory in addition to (or instead of) the project root.
Motivation
Claude Code already uses .claude/ as its dedicated configuration directory (e.g. CLAUDE.md, settings, memory). However, .mcp.json must currently live in the project root, which pollutes the root directory with tooling-specific config.
Moving .mcp.json into .claude/ would:
- Keep the project root clean
- Consolidate all Claude-related config in one place
- Make it easier to
.gitignoreor manage Claude-specific files separately
Proposed behavior
Claude Code should look for MCP configuration in the following order:
.claude/.mcp.json(preferred).mcp.json(project root, for backwards compatibility)
Alternatives considered
- Moving MCP config to
~/.claude/settings.json(global) — but this loses per-project scoping - Keeping
.mcp.jsonin the root — works, but clutters the project root
This is a small quality-of-life improvement that aligns with the existing .claude/ convention.
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗