Claude MCP 服务器完整指南：从零到连接一切

核心洞察

没有 MCP，Claude 是「聪明的实习生，但无法访问你的文件」。

有了 MCP，Claude 是「你指挥的 AI 操作员」——区别是 agency（自主性）。

什么是 MCP

MCP（Model Context Protocol）：Anthropic 开发的开放标准，定义 AI 模型如何连接外部数据源和工具。

简单理解：MCP 是 Claude 智能与真实世界数据和工具之间的桥梁。

没有 MCP	有 MCP
只知道当前对话中你告诉它的	知道代码库、数据库、邮件、日历、项目管理工具、CRM
建议你应该做什么	直接执行
每次会话从零开始	上下文持久，可重新读取相同来源

架构模型

Claude → 发送标准化请求 → MCP Server → 连接工具/数据源 → 返回结果

MCP Server：小型程序，向 Claude 暴露特定能力
Server 处理：与工具或数据源的连接
Claude 视角：在使用一个工具
你的视角：Claude 直接在你的实际系统中操作

配置文件

文件位置

系统	路径
Mac	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`

基本结构

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@package/server-name"],
      "env": {
        "API_KEY": "your-key-here"
      }
    }
  }
}

三个必需项：名称、启动命令、环境变量（如 API key）。

编辑后必须重启 Claude Desktop。

验证连接：问 Claude "What tools do you have available?"

10 个最高价值 MCP 服务器

1. Filesystem MCP

功能：直接读写本地文件和文件夹。

重要性：Obsidian vault 操作系统、多 Agent 内容架构的基础。

"filesystem": {
  "command": "npx",
  "args": [
    "-y",
    "@modelcontextprotocol/server-filesystem",
    "/path/to/your/directory"
  ]
}

首次 prompt：

List all files in the directory you have access to. Identify the 5 most recently modified files and summarize what each one contains.

2. GitHub MCP

功能：连接 GitHub 仓库，读代码、创建 PR、审查变更、管理 issue、更新文档。

重要性：把 Claude Code 从代码生成器变成完整仓库操作员。

"github": {
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-github"],
  "env": {
    "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token"
  }
}

首次 prompt：

Read the main README file in my repository [REPO NAME]. Identify anything outdated or missing based on current codebase structure. Generate an updated version and create a PR.

3. Notion MCP

功能：连接 Notion workspace，读页面、更新数据库、创建内容、管理项目追踪器。

重要性：把 Claude 变成 Notion 操作员——更新项目状态、创建客户简报、管理内容日历。

"notion": {
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-notion"],
  "env": {
    "NOTION_API_KEY": "your-integration-token"
  }
}

4. Supabase MCP

功能：连接 Supabase 数据库，查询表、插入记录、更新数据、运行迁移。

重要性：把 Claude 变成数据库操作员——客户支持分析、数据探索、自动报告。

"supabase": {
  "command": "npx",
  "args": ["-y", "@supabase/mcp-server-supabase"],
  "env": {
    "SUPABASE_URL": "your-project-url",
    "SUPABASE_SERVICE_KEY": "your-service-key"
  }
}

5. Google Drive MCP

功能：连接 Google Drive，读文档、表格、演示文稿，搜索 Drive，提取文件内容。

重要性：商业知识（合同、提案、研究、会议记录）全部可用，无需手动复制。

6. Slack MCP

功能：连接 Slack workspace，读频道历史、发送消息、搜索对话、监控提及。

重要性：Slack 中的沟通上下文对 Claude 原本不可见，连接后 Claude 可读决策 shaped 的对话历史。

7. PostgreSQL MCP

功能：直接连接 PostgreSQL 数据库，查询数据、分析 schema、运行报告。

重要性：整个数据层对自然语言分析开放，无需 SQL。

8. Brave Search MCP

功能：通过 Brave Search API 访问实时网页搜索结果。

重要性：Claude 知识有训练截止日期，Web search 提供当前信息——研究、竞品监控、新闻分析全自主化。

"brave-search": {
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-brave-search"],
  "env": {
    "BRAVE_API_KEY": "your-api-key"
  }
}

9. Linear MCP

功能：连接 Linear 项目管理 workspace，读 issue、创建 ticket、更新状态、管理 sprint。

重要性：工程师花大量时间在 ticket 管理上，MCP 让 Claude 从规格创建 issue、从 commit message 更新状态、自动生成 sprint 总结。

10. Custom HTTP/API MCP

功能：通过可配置 HTTP 服务器连接任何 REST API 或 webhook-enabled 服务。

重要性：通用连接器，填补缺口——任何有 API 的服务都可以构建轻量级 MCP server 暴露给 Claude。

完整多服务器配置示例

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/yourname/Documents/vault",
        "/Users/yourname/Projects"
      ]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token" }
    },
    "notion": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-notion"],
      "env": { "NOTION_API_KEY": "your-token" }
    },
    "slack": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "your-token",
        "SLACK_TEAM_ID": "your-team-id"
      }
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": { "BRAVE_API_KEY": "your-key" }
    },
    "linear": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-linear"],
      "env": { "LINEAR_API_KEY": "your-key" }
    }
  }
}

建议：从 3 个服务器开始，按需添加。

CLAUDE.md：多服务器设置的力量倍增器

连接 MCP 服务器给 Claude 工具访问权。 CLAUDE.md 告诉 Claude 如何为你的特定场景智能使用它们。

模板示例

# MCP Configuration — CLAUDE.md

## Connected Systems
- Filesystem: Obsidian vault at [PATH] and projects at [PATH]
- GitHub: Primary repo is [REPO NAME], main branch is [BRANCH]
- Notion: Business workspace, client database is [DATABASE NAME]
- Supabase: Production database, read-only access
- Slack: [WORKSPACE NAME], primary channel is [CHANNEL]
- Linear: [TEAM NAME], my username is [USERNAME]

## How to Use These Tools Together
When I ask about a project: read GitHub for code status, 
Linear for task status, and Notion for project overview.

When I ask about a client: read Notion client database, 
Slack for recent communications, and filesystem for local files.

When I need to research: use Brave Search first, 
then cross-reference with filesystem vault knowledge.

## Default Behaviors
- Always read CLAUDE.md before starting any multi-step task
- Always log significant actions to filesystem logs folder
- Always confirm before writing to Supabase or sending Slack messages
- Never delete files or records without explicit confirmation

## Current Context
[UPDATE WEEKLY: current priorities, active projects, what matters most]

首个多工具工作流：早晨情报简报

使用 5 个服务器同时运行：

1. Brave Search: 找 [MY INDUSTRY] 过去 24 小时重大新闻
2. GitHub: 检查夜间新 PR/issue
3. Linear: 列出昨天以来逾期任务
4. Notion: 检查 48 小时内是否有客户 deadline
5. Slack: 总结过去 12 小时需回复的消息

→ 合成结构化简报：
   - 今日 Top 3 优先级
   - 需立即关注的紧急事项
   - 夜间活动摘要
   - 中午前应做的决策

→ 保存到文件系统: [PATH]/daily-notes/[DATE]-morning-brief.md

时间对比：

自动运行：< 3 分钟
手动操作：20-30 分钟

故障排查

问题	原因	修复
Server 未出现在 Claude	JSON 语法错误	用 jsonlint.com 验证
文件系统权限错误	路径不存在或无读取权限	验证路径，Mac 需在系统设置中授予 Claude 完全磁盘访问
API 认证失败	Token 过期或权限不足	重新生成 token，确保正确 scope
Server 启动但 Claude 无法使用	MCP server 安装不正确	终端直接运行 npx 命令看错误，清理 npm cache 重试
多服务器响应慢	Claude 同时查询多个服务器	预期行为，指定具体服务器的查询会更快

分周搭建计划

周次	添加服务器	目标
第 1 周	Filesystem	Obsidian vault 智能层，建立 3 个文件操作工作流
第 2 周	GitHub 或 Notion	结合文件系统建立 2 个组合工作流
第 3 周	Supabase/Postgres	建立 1 个数据库读取+vault 报告工作流
第 4 周	Slack	建立早晨情报工作流
第 5 周	Brave Search	实时信息访问，无需手动提供来源
第 6 周	填补缺口	识别仍需手动在工具间移动信息的步骤

第 6 周结束时：Claude 已连接整个工具栈，每周消耗数小时的行政协调工作自主运行。

连接一切后的变化

不是生产力提升，是品类改变。

单工具 Claude	全连接 Claude
AI 助手，你咨询它	AI 操作员，你指挥它
等待输入	读取系统
响应问题	理解上下文
建议行动	在预授权边界内执行
报告建议	报告完成事项

真正价值：不是 Claude 能读你的文件，而是 Claude 能作为有完整上下文了解你具体情况的连贯操作员，跨整个栈行动。

资源

作者：CyrilXBT (@cyrilXBT)
原文：https://x.com/cyrilXBT/status/2055833066640121921
MCP 官方文档：https://modelcontextprotocol.io
Brave Search API：https://brave.com/search/api