Blog · Oct 9, 2026 · 3 min read

MCP 入门：让智能体直接使用你的工具

MCP 是连接智能体和外部工具的开放协议。本文讲清它解决什么问题、本地和远程两种连接方式，以及在 Claude Code、Codex、Cursor 里怎么添加一个 MCP Server。

Related agents: Claude Code OpenAI Codex Cursor

智能体能读写代码、跑命令，但它看不到你的工单系统、数据库和设计稿。于是我们常常在两个窗口之间复制粘贴：把报错从监控面板贴进对话，把需求从工单里贴进对话。

Model Context Protocol（MCP）解决的就是这件事：把外部系统包装成智能体能直接调用的工具。 连上之后，智能体自己去查、去操作，而不是基于你粘贴的片段工作。

MCP 是怎么工作的

MCP 里有两个角色：

MCP Server：一个小程序，把某个系统的能力暴露成一组工具，比如「查询工单」「执行 SQL」「读取设计稿」
客户端：Claude Code、Codex、Cursor 这样的智能体，连接 Server，把它的工具交给大模型使用

协议是开放的，同一个 MCP Server 可以接到任何支持 MCP 的智能体上。

两种连接方式

方式	运行在哪	适合
本地 stdio	你电脑上的一个进程，智能体启动它并通过标准输入输出通信	需要访问本机文件、命令行工具、本地数据库
远程 HTTP	服务商部署好的地址，智能体通过网络连接	SaaS 服务（如 Notion、GitHub），通常用 OAuth 登录

远程服务器早期常用 SSE 传输，Claude Code 文档已标为弃用，新服务器优先用 HTTP（Streamable HTTP）。

在三个智能体里添加

以文档查询服务器 Context7 为例（一个本地 stdio 服务器）。

Claude Code 用命令行添加，-- 之后是启动服务器的命令：

claude mcp add context7 -- npx -y @upstash/context7-mcp

远程服务器指定 --transport http：

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

默认只对当前项目生效且不共享；加 --scope project 写进项目根目录的 .mcp.json，提交后团队都能用；加 --scope user 对你所有项目生效。用 claude mcp list 查看状态，会话里输入 /mcp 管理。

Codex 同样有命令行，配置存在 ~/.codex/config.toml：

codex mcp add context7 -- npx -y @upstash/context7-mcp

也可以直接编辑 config.toml：

~/.codex/config.toml

[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]

Cursor 在设置的 Customize 页面安装，或编辑 ~/.cursor/mcp.json（项目级是 .cursor/mcp.json）：

.cursor/mcp.json

{
  "mcpServers": {
    "context7": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

更多选项（环境变量、请求头、OAuth、工具过滤）见 Claude Code：MCP、Codex：MCP 和 Cursor：MCP。

使用前要注意的三件事

1. 只连你信任的服务器。 本地服务器以你的权限运行；会抓取网页、读取外部内容的服务器，可能把恶意指令带进对话（提示注入）。

2. 密钥不要写进共享配置。 提交进仓库的 .mcp.json、.cursor/mcp.json 里不要放 token，用环境变量传入。三家都支持从环境变量读取：Claude Code 的 .mcp.json 写 ${VAR}，Cursor 写 ${env:VAR}，Codex 用 env_vars、bearer_token_env_var 等字段。

3. 工具不是越多越好。 每个服务器的工具描述都会占用上下文，工具太多还会让大模型选错。只开当前项目用得上的，其余的按项目关掉。

MCP 和 Skill 的区别

两者经常一起出现，但解决的问题不同：

	MCP	Skill
提供什么	新的能力：访问原本够不到的系统	做事的方法：指令、流程、参考资料
形式	一个运行中的服务	一个包含 `SKILL.md` 的目录
例子	查询数据库、读取 Figma	按团队约定写提交信息

一个 Skill 可以教智能体怎样组合使用某个 MCP Server 的工具。Skill 的写法见 Agent Skills 入门。

从哪里找 MCP Server

本站的 MCP 目录汇集了官方 Registry 和 GitHub 上的 MCP Server，官方页列出厂商自己维护的服务器，每个详情页都给出了 Claude Code、Codex、Cursor 的配置。也可以用命令行直接添加：

npx funcoding-cli mcp find "postgres"
npx funcoding-cli mcp add <id> --agent=cursor