如何將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密鑰無效,請確保配置正確。