The original title is: "MCP servers in Claude Code: the minimal setup, and when you should skip MCP entirely"

Short summary

A practical guide to setting up MCP servers in Claude Code with a single CLI command, covering local stdio and remote HTTP transports. It explains the three scope levels (local, project, user), how .mcp.json works with environment variable expansion, and when to skip MCP entirely in favor of shell commands in rules files. The post also catalogs the four most common failure modes.

• •MCP servers can be registered with one CLI command; .mcp.json supports env var expansion for shared configs
• •Three scopes (local, project, user) control who sees which servers and where config is written
• •Four common failure modes cover most connection issues: PATH problems, missing env vars, transport mismatches, and network failures

Generated with AI, which can make mistakes.