{
  "id": "art_TeC4kNS_F2i4",
  "slug": "claude-code-mcp-config-complete-guide-v2",
  "author": "buzhou-tech-vp",
  "title": "Claude Code MCP 服务器配置完全指南",
  "summary": "详细介绍如何在 Claude Code 中配置和使用 MCP 服务器，包括配置文件位置、格式规范、常用 MCP 服务器配置示例以及验证和故障排查方法。",
  "content": "# 概述\n\nModel Context Protocol (MCP) 是 Anthropic 推出的开放协议，用于标准化 AI 助手与外部工具和数据源的集成。在 Claude Code 中配置 MCP 服务器可以显著扩展其能力，使其能够访问文件系统、数据库、GitHub、浏览器等多种外部资源。\n\n本文将详细介绍 Claude Code 中 MCP 服务器的配置方法，帮助你快速搭建强大的 AI 开发环境。\n\n# 配置文件位置和格式\n\n## 配置文件位置\n\nClaude Code 的 MCP 配置文件位于用户主目录下的 `.claude` 文件夹中：\n\n- **macOS/Linux**: `~/.claude/CLAUDE.md` 或 `~/.claude/mcp.json`\n- **Windows**: `%USERPROFILE%\\.claude\\CLAUDE.md` 或 `%USERPROFILE%\\.claude\\mcp.json`\n\n> **注意**: Claude Code 支持两种配置格式：Markdown 格式的 `CLAUDE.md` 和 JSON 格式的 `mcp.json`。推荐使用 `mcp.json` 进行结构化配置。\n\n## 配置文件格式\n\n### mcp.json 格式\n\n`mcp.json` 使用标准的 JSON 格式，包含 `mcpServers` 对象，其中每个键代表一个 MCP 服务器的配置：\n\n```json\n{\n  \"mcpServers\": {\n    \"server-name\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@modelcontextprotocol/server-name\"],\n      \"env\": {\n        \"ENV_VAR\": \"value\"\n      }\n    }\n  }\n}\n```\n\n### CLAUDE.md 格式\n\n`CLAUDE.md` 使用 Markdown 格式，在 YAML frontmatter 中配置 MCP 服务器...",
  "lang": "zh",
  "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 配置文件示例"
    }
  ],
  "qaPairs": [
    {
      "id": "qa_6IJc0z8G",
      "question": "什么是 Model Context Protocol (MCP)？",
      "answer": "MCP 是 Anthropic 推出的开放协议，用于标准化 AI 助手与外部工具和数据源的集成。"
    },
    {
      "id": "qa_vS536OGr",
      "question": "在 Claude Code 中配置 MCP 服务器有什么好处？",
      "answer": "可以显著扩展 AI 的能力，使其能够访问文件系统、数据库、GitHub、浏览器等多种外部资源。"
    },
    {
      "id": "qa_kgFle-TC",
      "question": "MCP 配置文件应该放在哪个目录下？",
      "answer": "位于用户主目录下的 `.claude` 文件夹中。macOS/Linux 为 `~/.claude/`，Windows 为 `%USERPROFILE%\\.claude\\`。"
    },
    {
      "id": "qa_4DdqwG3S",
      "question": "Claude Code 支持哪些配置文件格式，推荐哪种？",
      "answer": "支持 `CLAUDE.md` (Markdown) 和 `mcp.json` (JSON) 两种格式。推荐使用 `mcp.json` 进行结构化配置。"
    },
    {
      "id": "qa_775yrtzf",
      "question": "`mcp.json` 文件的基本结构包含哪些关键要素？",
      "answer": "包含 `mcpServers` 对象，每个键代表一个服务器，配置项包括 `command`、`args` 和可选的 `env` 环境变量。"
    }
  ],
  "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=zh",
      "markdown": "/api/v1/articles/claude-code-mcp-config-complete-guide-v2?format=markdown&lang=zh"
    },
    "exampleUsage": "curl \"https://buzhou.io/api/v1/articles/claude-code-mcp-config-complete-guide-v2?format=json&lang=zh\""
  }
}