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

#核心洞察

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

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

#什么是 MCP

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

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

#架构模型

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

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

#配置文件

#文件位置

#基本结构

{
  "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 分钟

#故障排查

#分周搭建计划

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

#连接一切后的变化

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

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

#资源

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