如何把你的第一个 MCP server 连接到 Claude Code 或 Cursor

如果你和 AI 编码助手打过一段时间交道，你大概遇到过这样的时刻：它能把代码写得很漂亮，却完全不知道你的数据库、你的 issue 跟踪器或你的设计文件里有什么。你只好一遍又一遍把上下文复制粘贴进对话框。Model Context Protocol（MCP）的存在就是为了终结这个复制粘贴的循环。本指南将讲清楚 MCP 是什么，并带你连接你的第一个 server。

MCP 到底是什么

MCP 是一个由 Anthropic 引入的开放标准，用于把 AI 工具连接到外部数据和服务。常见的类比是，MCP 是 "AI 的 USB-C 接口"：与其让每个工具发明自己的定制集成，AI agent 可以用一个通用协议插入任何兼容 MCP 的 server。

最大的实际收益是可移植性。因为 Cursor 和 Claude Code 说的是同一套协议，你在一个里配好的 server，通常在另一个里也能用——而且截至 WWDC 2026，连 Apple 的 Xcode 27 都加入了 MCP 插件支持。学一次，处处复用。

MCP server 其实就是一个小程序，它暴露工具（AI 能执行的动作）和资源（它能读取的数据）。已经有为 GitHub、PostgreSQL、Slack、Google Drive、Puppeteer 以及更多服务预建好的 server。

你会遇到的两种 server

作为初学者，值得了解两种传输方式：

• 本地（stdio）server 作为一个进程运行在你自己的机器上——很适合文件系统或本地数据库这类东西。它们以 npx 或 python 之类的命令启动。
• 远程（HTTP/SSE）server 由供应商托管在某个 URL 上，通常需要经过 OAuth 登录——例如 Notion、Asana 或 Sentry。

在 Claude Code 中连接一个 server

Claude Code 用单条 claude mcp add 命令。对于远程 server，把它指向一个 URL：

claude mcp add --transport http notion https://mcp.notion.com/mcp

对于本地 server，-- 之后的一切就是 Claude 用来启动它的命令：

claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable -- npx -y airtable-mcp-server

-- 这个分隔符很重要：它告诉 Claude Code 它自己的参数到哪里为止、server 的启动命令从哪里开始。随后你可以用 claude mcp list 列出已连接的内容，确认握手成功。

Claude Code 还支持作用域（scope），用来决定谁能看到这个 server。local 作用域把它限定在这台机器上的你自己；project 作用域把配置写进一个共享的 .mcp.json 文件，你整个团队都能提交到 git；user 作用域则让它在你所有项目中都可用。对任何你的队友也需要的东西，project 作用域通常是正确的选择。

在 Cursor 中连接一个 server

Cursor 通过它的 UI 暴露同样的能力。打开 Cursor Settings，进入 Features > MCP，点击 "+ Add New MCP Server"，然后粘贴启动命令（本地 server）或 URL（远程 server）。在底层，Cursor 把它存为一个 JSON 配置，所以你也可以手动编辑。2026 年的一个不错的改进：Cursor 的 agent 现在按需加载工具描述，而不是把每个 server 的工具都塞进提示里，这让你即使连了好几个 server 也能保持流畅。

一个具体的第一个项目

如果你想要一个五分钟的小胜利，连一个 GitHub MCP server，然后问你的助手一个它以前永远答不上来的问题：

"看看这个仓库里最近关闭的三个 issue，总结一下改了什么。"

没有 MCP，助手只能瞎猜或让你把 issue 粘贴进来。连上 server 后，它直接调用 GitHub 工具，读取真实的 issue，并根据实时数据作答。这就是 MCP 的全部意义，浓缩在一个例子里：模型不再只是一个聪明的文本框，而开始成为一个能伸进你实际工作的系统里的 agent。

放飞之前的安全须知

MCP 让 AI 真正接触到真实的系统，所以要像对待任何其他依赖一样对待新的 server。优先选择官方或口碑良好的 server，在连接前读清楚一个 server 暴露了哪些工具，把 API 密钥的权限收到最小，对能写入或删除数据的 server 保持谨慎。从只读的用例开始——查询你的数据库 schema、读取 issue、搜索文档——等你信任这套设置之后，再升级到写操作。

一旦复制粘贴的循环消失，就很难回头了。从一个能解决你工作流中真实烦恼的 server 开始，再由此生长。