如果你用过 AI 编程助手,你大概撞过这样一堵墙:它会说类似 "我看不到你的数据库" 或 "把问题详情粘贴到这里" 之类的话。这个助手很聪明,但它被关在盒子里——它只知道你文件里的内容和你输入的东西。Model Context Protocol(MCP)就是你推倒这堵墙、让助手接触到你真实工具的方式:数据库、GitHub、监控面板、设计文件。
本指南会解释 MCP 是什么,并带你把第一个服务器连接到 Claude Code,同样的思路也适用于 Cursor 和 Copilot。
MCP 究竟是什么
MCP 是一个开放标准——你可以把它想象成 AI 助手和你已经在用的系统之间的万能转接头。与其让每个工具各自发明一套与每个助手对话的方式,不如让工具只发布一个 MCP 服务器,任何支持 MCP 的助手(Claude、Cursor、Copilot)都能连上它。这就是为什么 2026 年你到处都能看到 "MCP":它是让助手真正干活、而不只是空谈的管道。
一条好用的经验法则:每当你发现自己在从另一个工具往聊天里复制数据时,就该连一个服务器了。如果你总是在粘贴来自 Sentry 的错误日志或来自 Jira 的工单详情,那就是一个信号——一个 MCP 服务器能帮你省掉这趟往返。
两类服务器
你会遇到两种类型:
- 远程(HTTP)服务器运行在云端,你通过网络连接——Notion、GitHub 以及大多数 SaaS 工具都是这样工作的。这是推荐的默认选择。
- 本地(stdio)服务器作为一个进程运行在你自己的机器上——适用于需要直接访问系统的场景,比如本地数据库驱动。
添加你的第一个服务器
核心命令是 claude mcp add。下面是连接一个远程 HTTP 服务器的基本形式:
claude mcp add --transport http <name> <url>
一个具体的例子——连接 Notion,让你的助手可以读取和更新页面:
claude mcp add --transport http notion https://mcp.notion.com/mcp
如果服务器需要身份验证,就通过一个 header 传入 token:
claude mcp add --transport http secure-api https://api.example.com/mcp \
--header "Authorization: Bearer your-token"
对于本地服务器,-- 之后的所有内容都是用来启动它的命令:
claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
-- npx -y airtable-mcp-server
那个 -- 很重要:它把 Claude 自己的标志和启动服务器的命令分隔开,这样一个本该传给服务器的 --port 就不会被当作 Claude 的选项来解析。
添加完成后,检查一下你都接了些什么:
claude mcp list # 查看所有服务器及其状态
claude mcp get notion # 查看某一个服务器的详情
在 Claude Code 会话中,/mcp 命令会显示实时连接状态,并且对于使用 OAuth 的服务器,还能让你登录。
选择合适的作用域
添加服务器时,用 --scope 标志来决定谁应该看到它:
local(默认)——只有你自己,只在这个项目里。project——通过一个纳入版本管理的.mcp.json文件与你的整个团队共享。这对新人上手很有帮助:一个新队友克隆下仓库,助手就已经知道团队用的工具了。user——在你机器上的每一个项目里都可用。
对于团队的数据库或问题追踪器,project 作用域通常正是你想要的。对于个人 API 密钥,就保持 local 或 user,这样它永远不会进到仓库里。
安全地去做
MCP 的强大恰恰在于它给了助手真实的触及能力——所以稍加谨慎会很值得:
- 在连接之前先信任这个服务器。 一个会抓取外部内容的服务器可能让你面临提示词注入风险,即被抓取数据中的恶意文本试图操纵你的助手。请坚持使用你认得的厂商提供的官方服务器。
- 严格限定凭据权限。 当任务只需要读取时,给服务器一个只读或最小权限的密钥。这正是 Microsoft 在其企业级 Dataverse 插件中所贯彻的原则——助手只能看到它被授予的角色所允许的内容。
- 别把密钥放进共享配置里。 把 token 放在环境变量或
local作用域里,绝不要放进会被提交的project作用域.mcp.json中。 - 审查它能做什么。 连接之后,打开
/mcp并浏览一下这个服务器暴露出来的工具,这样就不会有意外。
回报
一旦服务器连接好,你工作方式的改变是立竿见影的。你不再需要说 "这是我粘贴过来的 schema",而是可以直接问:"找出我们 Postgres 数据库里最近的 10 位注册用户,并为每一位起草一封反馈会邀请邮件。" 助手会查询数据库、读取结果、起草邮件——全部在一个流程里完成,因为它终于能触及你的工作真正所在的系统了。
先从你最常粘贴数据的那个工具开始连接一个服务器。这一个连接通常能比读再多相关文章都更快地让价值显而易见。
SOURCES
Auto-generated by Vibe Coding Academy on July 8, 2026, grounded in the real sources linked above. We review for accuracy, but please verify time-sensitive details against the primary sources.
Build Blueprint · Creator
有想法?获取你的 AI 智能体可直接据此构建的规格说明。
描述任意产品,即可获得完整的构建蓝图——技术栈、数据模型、界面、API,以及可直接粘贴到 Claude Code 或 Cursor 的提示词。可导出为 PDF。
打开 Blueprint ▸