Claude Desktop MCP 配置Guides - 配置文件位置、JSON 示例与排错清单

配置文件位置

macos：~/Library/Application Support/Claude/claude_desktop_config.json
windows：%APPDATA%\Claude\claude_desktop_config.json

配置步骤

找到或创建配置文件（路径见上方）。
在文件中添加 mcpServers 字段。
填入 MCP Server 的 command、args 和 env。
完全退出 Claude Desktop 后重新打开
打开对话，输入'你有哪些工具可用'，确认 MCP 工具出现在列表中

Configuration Example

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/you/Documents"
      ]
    }
  }
}

支持的 MCP Server（56 个）

Tool	Category	Risk
Filesystem	File & Local System	Medium Risk
GitHub	Git & Dev Workflow	Medium Risk
SQLite	Database & Data Query	Medium Risk
PostgreSQL	Database & Data Query	Medium Risk
Brave Search	Search & Knowledge Base	Medium Risk
Puppeteer	Browser & Web Automation	Medium Risk
Memory	File & Local System	Low Risk
Fetch	Search & Knowledge Base	Low Risk
Git	Git & Dev Workflow	Low Risk
Sequential Thinking	Search & Knowledge Base	Low Risk
Playwright	Browser & Web Automation	Medium Risk
Everything	File & Local System	Low Risk
Slack	Design & Product Collaboration	High Risk
Google Maps	Search & Knowledge Base	Medium Risk
Cloudflare	Deploy & Operations	High Risk
Docker	Deploy & Operations	High Risk
Linear	Design & Product Collaboration	Medium Risk
Notion	Design & Product Collaboration	Medium Risk
Sentry	Deploy & Operations	Low Risk
Exa	Search & Knowledge Base	Low Risk
MySQL	Database & Data Query	High Risk
Tavily Search	Search & Knowledge Base	Low Risk
Figma	Design & Product Collaboration	Low Risk
Vercel	Deploy & Operations	High Risk
Redis	Database & Data Query	Medium Risk
Time	File & Local System	Low Risk
GitHub Models	Search & Knowledge Base	Medium Risk
Shell / Terminal	Deploy & Operations	High Risk
Obsidian	Search & Knowledge Base	Medium Risk
Perplexity	Search & Knowledge Base	Low Risk
Context7	Search & Knowledge Base	Low Risk
Firecrawl	Browser & Web Automation	Medium Risk
Playwright (Official)	Browser & Web Automation	Medium Risk
DuckDB	Database & Data Query	Medium Risk
MongoDB	Database & Data Query	High Risk
Neon	Database & Data Query	High Risk
Supabase	Database & Data Query	High Risk
Airtable	Database & Data Query	Medium Risk
Qdrant	Database & Data Query	Medium Risk
Kagi Search	Search & Knowledge Base	Medium Risk
ArXiv	Search & Knowledge Base	Low Risk
Google Drive	Search & Knowledge Base	Medium Risk
YouTube Transcript	Search & Knowledge Base	Low Risk
Bright Data	Browser & Web Automation	Medium Risk
Apify	Browser & Web Automation	Medium Risk
Atlassian (Jira + Confluence)	Design & Product Collaboration	Medium Risk
Todoist	Design & Product Collaboration	Medium Risk
Google Calendar	Design & Product Collaboration	Medium Risk
Kubernetes	Deploy & Operations	High Risk
AWS	Deploy & Operations	High Risk
Datadog	Deploy & Operations	Medium Risk
Windows CLI	File & Local System	High Risk
E2B Code Sandbox	File & Local System	Medium Risk
Gmail	Design & Product Collaboration	High Risk
Stripe	Search & Knowledge Base	High Risk
Bluesky	Search & Knowledge Base	Medium Risk

FAQ

配置文件不存在怎么办？: 手动创建该文件，内容为 {"mcpServers": {}}，然后添加你Required的 Server。
修改配置后不生效？: 完全退出 Claude Desktop 后重新打开
怎么确认 MCP 已连接？: 打开对话，输入'你有哪些工具可用'，确认 MCP 工具出现在列表中

安全Important Notes

不要把包含 API Key 的配置文件提交到公开仓库。
建议将配置文件加入 .gitignore。
使用High Risk MCP 前确认权限范围。