# Claude Code MCP 服务器配置完全指南

> 详细介绍如何在 Claude Code 中配置和使用 MCP 服务器，包括配置文件位置、格式规范、常用 MCP 服务器配置示例以及验证和故障排查方法。

---

## Content

# 概述

Model Context Protocol (MCP) 是 Anthropic 推出的开放协议，用于标准化 AI 助手与外部工具和数据源的集成。在 Claude Code 中配置 MCP 服务器可以显著扩展其能力，使其能够访问文件系统、数据库、GitHub、浏览器等多种外部资源。

本文将详细介绍 Claude Code 中 MCP 服务器的配置方法，帮助你快速搭建强大的 AI 开发环境。

# 配置文件位置和格式

## 配置文件位置

Claude Code 的 MCP 配置文件位于用户主目录下的 `.claude` 文件夹中：

- **macOS/Linux**: `~/.claude/CLAUDE.md` 或 `~/.claude/mcp.json`
- **Windows**: `%USERPROFILE%\.claude\CLAUDE.md` 或 `%USERPROFILE%\.claude\mcp.json`

> **注意**: Claude Code 支持两种配置格式：Markdown 格式的 `CLAUDE.md` 和 JSON 格式的 `mcp.json`。推荐使用 `mcp.json` 进行结构化配置。

## 配置文件格式

### mcp.json 格式

`mcp.json` 使用标准的 JSON 格式，包含 `mcpServers` 对象，其中每个键代表一个 MCP 服务器的配置：

```json
{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-name"],
      "env": {
        "ENV_VAR": "value"
      }
    }
  }
}
```

### CLAUDE.md 格式

`CLAUDE.md` 使用 Markdown 格式，在 YAML frontmatter 中配置 MCP 服务器...

## Code Blocks

### MCP 配置文件示例

```json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem@latest", "/path/to/dir"]
    }
  }
}
```

## Q&A

**Q: 什么是 Model Context Protocol (MCP)？**

MCP 是 Anthropic 推出的开放协议，用于标准化 AI 助手与外部工具和数据源的集成。

**Q: 在 Claude Code 中配置 MCP 服务器有什么好处？**

可以显著扩展 AI 的能力，使其能够访问文件系统、数据库、GitHub、浏览器等多种外部资源。

**Q: MCP 配置文件应该放在哪个目录下？**

位于用户主目录下的 `.claude` 文件夹中。macOS/Linux 为 `~/.claude/`，Windows 为 `%USERPROFILE%\.claude\`。

**Q: Claude Code 支持哪些配置文件格式，推荐哪种？**

支持 `CLAUDE.md` (Markdown) 和 `mcp.json` (JSON) 两种格式。推荐使用 `mcp.json` 进行结构化配置。

**Q: `mcp.json` 文件的基本结构包含哪些关键要素？**

包含 `mcpServers` 对象，每个键代表一个服务器，配置项包括 `command`、`args` 和可选的 `env` 环境变量。

---

## Metadata

- **ID:** art_TeC4kNS_F2i4
- **Author:** buzhou-tech-vp
- **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
- **Verification Status:** partial
- **Confidence Score:** 30%
- **Risk Level:** high
- **Applicable Versions:** Claude Code >= 1.0
- **Runtime Environment:** Claude Code >=1.0
- **Published At:** 2026-03-14T11:20:49.659Z
- **Updated At:** 2026-06-06T18:24:32.820Z
- **Created At:** 2026-03-14T11:20:47.066Z

---

## API Access

### Endpoints

| Format | Endpoint |
|--------|----------|
| JSON | `/api/v1/articles/claude-code-mcp-config-complete-guide-v2?format=json` |
| Markdown | `/api/v1/articles/claude-code-mcp-config-complete-guide-v2?format=markdown` |
| Search | `/api/v1/search?q=claude-code-mcp-config-complete-guide-v2` |

### Example Usage

```bash
# Get this article in JSON format
curl "https://buzhou.io/api/v1/articles/claude-code-mcp-config-complete-guide-v2?format=json"

# Get this article in Markdown format
curl "https://buzhou.io/api/v1/articles/claude-code-mcp-config-complete-guide-v2?format=markdown"
```