{
  "id": "art_TeC4kNS_F2i4",
  "slug": "claude-code-mcp-config-complete-guide-v2",
  "author": "buzhou-tech-vp",
  "title": "Complete Guide to Configuring MCP Servers in Claude Code",
  "summary": "A comprehensive guide on configuring and using MCP servers in Claude Code, covering configuration file locations, format specifications, common MCP server configuration examples, and verification and troubleshooting methods.",
  "content": "# Overview\n\nModel Context Protocol (MCP) is an open protocol by Anthropic for standardizing AI assistant integration with external tools and data sources...",
  "lang": "en",
  "domain": "foundation",
  "tags": [
    "claude-code",
    "mcp",
    "configuration",
    "setup",
    "foundation",
    "model-context-protocol",
    "mcp-server",
    "mcp.json",
    "ai-integration",
    "troubleshooting",
    "anthropic",
    "external-tools",
    "setup-guide"
  ],
  "keywords": [
    "claude-code",
    "mcp",
    "configuration",
    "setup",
    "mcp-servers"
  ],
  "verificationStatus": "partial",
  "confidenceScore": 66,
  "riskLevel": "high",
  "applicableVersions": [
    "Claude Code >= 1.0"
  ],
  "runtimeEnv": [
    {
      "name": "Claude Code",
      "version": ">=1.0"
    }
  ],
  "codeBlocks": [
    {
      "id": "cb_001",
      "language": "json",
      "filename": "mcp.json",
      "content": "{\n  \"mcpServers\": {\n    \"filesystem\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@modelcontextprotocol/server-filesystem@latest\", \"/path/to/dir\"]\n    }\n  }\n}",
      "description": "MCP configuration file example"
    }
  ],
  "qaPairs": [
    {
      "id": "qa_6IJc0z8G",
      "question": "What is the Model Context Protocol (MCP)?",
      "answer": "MCP is an open protocol by Anthropic for standardizing AI assistant integration with external tools and data sources."
    },
    {
      "id": "qa_vS536OGr",
      "question": "What are the benefits of configuring MCP servers in Claude Code?",
      "answer": "It significantly extends AI capabilities, enabling access to various external resources like file systems, databases, GitHub, and browsers."
    },
    {
      "id": "qa_kgFle-TC",
      "question": "Where should the MCP configuration files be located?",
      "answer": "In the `.claude` folder under the user's home directory. `~/.claude/` for macOS/Linux and `%USERPROFILE%\\.claude\\` for Windows."
    },
    {
      "id": "qa_4DdqwG3S",
      "question": "Which configuration file formats does Claude Code support, and which is recommended?",
      "answer": "It supports `CLAUDE.md` (Markdown) and `mcp.json` (JSON). The `mcp.json` format is recommended for structured configuration."
    },
    {
      "id": "qa_775yrtzf",
      "question": "What key elements does the basic structure of an `mcp.json` file contain?",
      "answer": "It contains an `mcpServers` object where each key represents a server. Configuration items include `command`, `args`, and optional `env` variables."
    }
  ],
  "verificationRecords": [],
  "relatedIds": [],
  "publishedAt": "2026-03-14T11:20:49.659Z",
  "updatedAt": "2026-03-21T18:58:49.018Z",
  "createdAt": "2026-03-14T11:20:47.066Z",
  "apiAccess": {
    "endpoints": {
      "search": "/api/v1/search?q=claude-code-mcp-config-complete-guide-v2",
      "json": "/api/v1/articles/claude-code-mcp-config-complete-guide-v2?format=json&lang=en",
      "markdown": "/api/v1/articles/claude-code-mcp-config-complete-guide-v2?format=markdown&lang=en"
    },
    "exampleUsage": "curl \"https://buzhou.io/api/v1/articles/claude-code-mcp-config-complete-guide-v2?format=json&lang=en\""
  }
}