如何将MCP服务器连接到Claude(Claude桌面版和Claude Code)
本文详细介绍了如何将MCP(模型上下文协议)服务器连接到Claude桌面版和Claude Code,使Claude能够与外部工具、文件、数据库等交互。包括两种桌面版配置方法(一键扩展和JSON配置)以及Claude Code的CLI命令配置,还提供了常见错误修复和推荐服务器列表。
MCP(模型上下文协议)是Anthropic推出的一种通用连接层,旨在解决AI模型与外部工具集成时的“N×M问题”。通过MCP,您只需为每个外部工具构建一个MCP服务器,任何兼容MCP的AI客户端(如Claude Desktop、Claude Code、Cursor等)即可直接使用,无需为每个组合编写自定义集成代码。本文将详细介绍如何将MCP服务器连接到Claude Desktop和Claude Code。
MCP的工作原理
MCP架构由三个核心组件组成:主机(Host,如Claude Desktop)、客户端(Client,负责协议通信)和服务器(Server,提供工具资源)。当用户请求需要外部工具时,Claude通过客户端向MCP服务器发送JSON-RPC请求,服务器处理并返回数据,整个过程在一秒内完成。
Claude Desktop的MCP设置
Claude Desktop支持两种安装方式:
方法一:桌面扩展(一键安装) 2026年初推出的桌面扩展(.mcpb文件)无需编辑JSON。只需点击聊天输入栏左下角的“+”按钮,选择“连接器”,找到所需服务器并点击安装,重启Claude Desktop即可自动激活。
方法二:JSON配置(完全控制) 配置文件为claude_desktop_config.json,位置因操作系统和安装方式而异:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows(.exe安装):
%APPDATA%\Claude\claude_desktop_config.json - Windows(MSIX安装):
%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json
如果找不到文件,可通过Claude Desktop的“设置”→“开发者”→“编辑配置”创建。注意Windows路径中的反斜杠需转义为双反斜杠。
配置文件基本结构:mcpServers键下包含服务器条目,每个条目包含command(通常为npx)、args(参数)和env(环境变量)。例如文件系统服务器无需凭证,GitHub服务器需要个人访问令牌,Brave搜索需要API密钥。
Claude Code的MCP设置
Claude Code通过CLI命令claude mcp add添加服务器。本地服务器使用--transport stdio并指定命令,托管服务器使用--transport http并指定URL。例如添加PostgreSQL:
claude mcp add --transport stdio project-db -- npx -y @modelcontextprotocol/server-postgres postgresql://localhost:5432/mydb支持三种作用域:本地(默认)、项目(.mcp.json,团队共享)和用户(全局)。
推荐服务器及常见问题 建议首先安装文件系统、GitHub和Brave搜索等常见服务器。常见错误包括路径错误、权限不足或API密钥无效,请确保配置正确。