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 .gitignore or manage Claude-specific files separately

Proposed behavior

Claude Code should look for MCP configuration in the following order:

  1. .claude/.mcp.json (preferred)
  2. .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.json in the root — works, but clutters the project root

This is a small quality-of-life improvement that aligns with the existing .claude/ convention.

View original on GitHub ↗

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