附录 A MCP：为智能体接入外部能力

面向经管学生、研究者与从业者的 AI 智能体设计教材

作者

李学恒、林建浩、严翊歆、张一帆

最后更新

2026-06-01

Claude Code 启动后，智能体默认能做三件事：读写本地文件、执行 Shell 命令、调用内置工具。这个能力边界覆盖了大多数开发任务，但在经济金融场景中，你可能还需要用浏览器抓取公司公告、从 Zotero 文献库检索研究报告、或者连接数据库查询财务数据。

MCP（Model Context Protocol，模型上下文协议）解决的就是这个问题。它是 Anthropic 推出的开源协议标准，定义了 AI 应用与外部系统之间的统一通信接口。有了 MCP，智能体可以通过同一套方式接入各种外部能力，不需要为每个数据源单独开发对接方案。

MCP 是什么，和 Skill 有什么区别

MCP 和 Skill 解决不同层面的问题。MCP 是工具层——让智能体”能做”某件事；Skill 是知识层——告诉智能体”怎么做”和”做成什么样”。

维度	MCP	Skill
解决的问题	接入外部系统的能力	领域知识和工作流编排
配置方式	安装 MCP 服务器	编写 `SKILL.md` 文件
典型场景	连接数据库、操作浏览器	财报摘要流程、研报写作规范

以金融舆情监测为例：配置 Playwright MCP 后，智能体能打开网页但不知道该看什么；写一个舆情扫描 Skill，智能体知道该访问哪些信息源、怎么提取内容、按什么格式输出，但没有浏览器访问能力。两者配合才是完整方案。

MCP 与 Skill 的分工

MCP 提供工具能力，Skill 叠加领域知识。判断用哪个：需要与外部系统保持连接的用 MCP，需要定义工作流和输出规范的用 Skill。

向 Claude Code 和 Opencode 添加 MCP

Claude Code

最简单的方式是直接告诉 Claude Code 你要添加什么：

▶ Claude Code

帮我添加 Playwright MCP，用于浏览器自动化操作

Claude Code 会自动找到正确的包、执行安装、写入配置。如果已经知道包名，用命令行更快：

claude mcp add playwright -- npx @playwright/mcp@latest

部分 MCP 服务器需要 API 密钥。用 --env 参数传入，密钥以环境变量形式存储，不会出现在项目文件中：

claude mcp add -s user zai-mcp-server \
  --env Z_AI_API_KEY=your_api_key \
  -- npx -y "@z_ai/mcp-server"

选项	说明
`-s user`	用户级配置，所有项目共享
`-s project`	项目级配置，只对当前项目生效
`--env KEY=VALUE`	传入 API 密钥等环境变量

添加完成后，在对话中输入 /mcp 查看已加载的服务器和工具状态。

Opencode

Opencode 同样支持 MCP，可以直接告诉它添加：

▶ Claude Code

帮我在 Opencode 配置中添加 Playwright MCP，包名是 @playwright/mcp@latest

Opencode 会将 MCP 配置写入项目根目录的 opencode.json。两个工具的 MCP 配置格式略有不同，但核心信息一致：服务器名称、启动命令、环境变量。

实用 MCP 推荐

Playwright MCP：浏览器自动化，适合从网站抓取公告、截取图表
Zotero MCP：文献管理，适合检索文献、提取笔记和标注
Token Plan MCP：MiniMax、Z.AI 等模型提供商的 MCP 服务器，可调用其他模型的特色能力

在 mcp.so 或 GitHub 搜索 awesome-mcp-servers 可以发现更多服务器。按需添加，不要同时挂载太多——挂载过多会影响智能体的工具选择效率。

用 /mcp-builder 创建自定义 MCP 工具

当现有 MCP 服务器无法满足需求时，可以自己创建。/mcp-builder 是一个开源技能，从 GitHub 获取后安装到 Claude Code，通过对话描述需求就能生成 MCP 服务器代码并自动完成配置。

▶ Claude Code

/mcp-builder 帮我创建一个 MCP 工具，能够查询 CoinGecko API 获取加密货币的实时价格和市值排名

Claude Code 会根据描述设计工具接口、生成服务器代码、完成安装和配置。创建完成后，直接在对话中使用：

▶ Claude Code

查询比特币和以太坊的当前价格，以及 24 小时涨跌幅

经济金融场景中，自定义 MCP 特别适合以下情况：

公司内部数据平台——这些 API 不会有公开的 MCP 服务器
Wind、同花顺等金融数据终端的数据接口
企业 OA 系统的审批和查询功能

什么时候该自定义

需要在多次对话中反复使用同一个外部接口 → 做成 MCP。只需执行一次的数据处理 → 让 Claude Code 直接写脚本。需要复杂多步流程和领域知识 → 做成 Skill，Skill 中调用 MCP。

--- title: "附录 A MCP：为智能体接入外部能力" --- ![附录 A 总览图](images/img_00_mcp_overview.webp) Claude Code 启动后，智能体默认能做三件事：读写本地文件、执行 Shell 命令、调用内置工具。这个能力边界覆盖了大多数开发任务，但在经济金融场景中，你可能还需要用浏览器抓取公司公告、从 Zotero 文献库检索研究报告、或者连接数据库查询财务数据。 MCP（Model Context Protocol，模型上下文协议）解决的就是这个问题。它是 Anthropic 推出的开源协议标准，定义了 AI 应用与外部系统之间的统一通信接口。有了 MCP，智能体可以通过同一套方式接入各种外部能力，不需要为每个数据源单独开发对接方案。 ## MCP 是什么，和 Skill 有什么区别 MCP 和 Skill 解决不同层面的问题。MCP 是工具层——让智能体"能做"某件事；Skill 是知识层——告诉智能体"怎么做"和"做成什么样"。 | 维度 | MCP | Skill | |:---|:---|:---| | 解决的问题 | 接入外部系统的能力 | 领域知识和工作流编排 | | 配置方式 | 安装 MCP 服务器 | 编写 `SKILL.md` 文件 | | 典型场景 | 连接数据库、操作浏览器 | 财报摘要流程、研报写作规范 | 以金融舆情监测为例：配置 Playwright MCP 后，智能体能打开网页但不知道该看什么；写一个舆情扫描 Skill，智能体知道该访问哪些信息源、怎么提取内容、按什么格式输出，但没有浏览器访问能力。两者配合才是完整方案。 ::: {.callout-important} ## MCP 与 Skill 的分工 MCP 提供工具能力，Skill 叠加领域知识。判断用哪个：需要与外部系统保持连接的用 MCP，需要定义工作流和输出规范的用 Skill。 ::: ## 向 Claude Code 和 Opencode 添加 MCP ### Claude Code 最简单的方式是直接告诉 Claude Code 你要添加什么： ```opencode 帮我添加 Playwright MCP，用于浏览器自动化操作 ``` Claude Code 会自动找到正确的包、执行安装、写入配置。如果已经知道包名，用命令行更快： ```bash claude mcp add playwright -- npx @playwright/mcp@latest ``` 部分 MCP 服务器需要 API 密钥。用 `--env` 参数传入，密钥以环境变量形式存储，不会出现在项目文件中： ```bash claude mcp add -s user zai-mcp-server \ --env Z_AI_API_KEY=your_api_key \ -- npx -y "@z_ai/mcp-server" ``` | 选项 | 说明 | |:---|:---| | `-s user` | 用户级配置，所有项目共享 | | `-s project` | 项目级配置，只对当前项目生效 | | `--env KEY=VALUE` | 传入 API 密钥等环境变量 | 添加完成后，在对话中输入 `/mcp` 查看已加载的服务器和工具状态。 ### Opencode Opencode 同样支持 MCP，可以直接告诉它添加： ```opencode 帮我在 Opencode 配置中添加 Playwright MCP，包名是 @playwright/mcp@latest ``` Opencode 会将 MCP 配置写入项目根目录的 `opencode.json`。两个工具的 MCP 配置格式略有不同，但核心信息一致：服务器名称、启动命令、环境变量。 ::: {.callout-tip} ## 实用 MCP 推荐 - **Playwright MCP**：浏览器自动化，适合从网站抓取公告、截取图表 - **Zotero MCP**：文献管理，适合检索文献、提取笔记和标注 - **Token Plan MCP**：MiniMax、Z.AI 等模型提供商的 MCP 服务器，可调用其他模型的特色能力在 mcp.so 或 GitHub 搜索 awesome-mcp-servers 可以发现更多服务器。按需添加，不要同时挂载太多——挂载过多会影响智能体的工具选择效率。 ::: ## 用 /mcp-builder 创建自定义 MCP 工具当现有 MCP 服务器无法满足需求时，可以自己创建。`/mcp-builder` 是一个开源技能，从 GitHub 获取后安装到 Claude Code，通过对话描述需求就能生成 MCP 服务器代码并自动完成配置。 ```opencode /mcp-builder 帮我创建一个 MCP 工具，能够查询 CoinGecko API 获取加密货币的实时价格和市值排名 ``` Claude Code 会根据描述设计工具接口、生成服务器代码、完成安装和配置。创建完成后，直接在对话中使用： ```opencode 查询比特币和以太坊的当前价格，以及 24 小时涨跌幅 ``` 经济金融场景中，自定义 MCP 特别适合以下情况： - 公司内部数据平台——这些 API 不会有公开的 MCP 服务器 - Wind、同花顺等金融数据终端的数据接口 - 企业 OA 系统的审批和查询功能 ::: {.callout-note} ## 什么时候该自定义需要在多次对话中反复使用同一个外部接口 → 做成 MCP。只需执行一次的数据处理 → 让 Claude Code 直接写脚本。需要复杂多步流程和领域知识 → 做成 Skill，Skill 中调用 MCP。 :::