05|MCP 是什么:Agent Harness 如何接入外部工具

简介: MCP(Model Context Protocol)是连接AI Agent与外部系统的开放标准,如“AI的USB-C接口”。它让Agent能安全调用Figma、Jira、数据库等真实工程系统中的工具、数据与工作流,突破代码仓库局限,实现跨平台协同。强调统一协议、分级权限与可审计控制。(239字)

ScreenShot_2026-05-28_233607_525.png

Agent Harness 如果只能读本地代码、跑本地命令,能力已经很强。但真实工程任务不只发生在代码仓库里。

需求在飞书或 Notion,设计稿在 Figma,任务在 Jira,接口文档在内部平台,线上数据在数据库,告警在监控系统。一个 Agent 如果不能接触这些系统,就只能看到工程现场的一部分。

MCP,也就是 Model Context Protocol,解决的就是这个连接问题。

官方对 MCP 的解释是:它是一个开放标准,用来把 AI 应用连接到外部系统,包括数据源、工具和工作流。很多人把它叫做“AI 应用的 USB-C 接口”,这个比喻很贴切。

为什么需要 MCP

没有 MCP 时,每个 Agent 工具都要单独适配每个外部系统。

比如你想让 Claude Code、Cursor、Codex 都能访问公司内部接口文档。传统做法是分别给三套工具写插件,维护三套认证、三套工具描述、三套调用逻辑。

MCP 的思路是:外部系统实现 MCP Server,Agent Harness 实现 MCP Client。只要协议一致,同一个 Server 就可以被多个 AI 工具使用。

image.png

这样,工具能力从“某个产品的插件”变成“可复用的协议服务”。

MCP Server 暴露什么

一个 MCP Server 通常可以暴露三类东西。

第一是 Tools。也就是模型可以调用的函数,比如:

search_docs(query)
get_ticket(id)
query_database(sql)
create_pr_comment(text)

第二是 Resources。也就是模型可以读取的结构化数据,比如某个文档、某张表的 schema、某个设计稿信息。

第三是 Prompts。也就是预定义工作流或提示模板,比如“生成发布说明”“分析事故复盘”“创建接口变更评审”。

实际使用中,Tools 最常见,因为它让 Agent 能采取行动。

MCP 在 Harness 里的位置

MCP 不是模型,也不是 Agent 本体。它是 Harness 的工具扩展层。

用户给任务后,模型判断需要外部信息,Harness 把可用 MCP 工具展示给模型,模型选择调用,MCP Server 执行并返回结果,结果再进入上下文。

image.png

这里的关键是:模型没有直接访问外部系统,访问发生在 Harness 和 MCP Server 的控制下。

真实场景

假设任务是:

根据设计稿实现新的订单详情页,并确认接口字段是否已经上线。

没有 MCP,Agent 只能看代码。它不知道设计稿长什么样,也不知道接口文档是否更新。

有 MCP 后,流程可以变成:

  1. 从 Figma MCP 读取设计稿信息;
  2. 从接口文档 MCP 查询订单详情字段;
  3. 从代码仓库读取现有页面;
  4. 修改 UI;
  5. 运行测试或截图验证;
  6. 输出字段差异和未确认项。

这就是 MCP 的价值:把 Agent 从代码仓库带到真实工程上下文里。

安全问题不能忽略

MCP 让 Agent 更强,也让风险变大。

一个能查文档的 MCP 风险不大;一个能写数据库、发工单、部署服务的 MCP 就必须严格控制。

建议按风险分级:

类型 示例 策略
只读数据 查询文档、读取 schema 可自动调用,记录日志
低风险写入 创建草稿、生成评论 可确认后执行
高风险操作 修改生产数据、部署、删除资源 禁止或强制审批

不要因为 MCP 是标准协议,就默认它安全。协议只负责连接,安全要靠 Harness、Server 和企业策略共同完成。

MCP Server 设计建议

第一,工具描述要清楚。模型是根据工具名称和描述选择工具的。不要叫 doThing,要叫 search_api_docs

第二,返回结果要结构化。不要返回一大段日志,最好返回 JSON、Markdown 摘要和关键字段。

第三,权限尽量后置到服务端。不要只相信 Agent Harness 的判断,MCP Server 自己也要校验用户身份和权限。

第四,默认只读。写操作要少、明确、可审计。

第五,避免工具过多。工具列表太长,模型选择会变差。可以按项目或角色拆分 Server。

总结

MCP 的意义,不是让 Agent 多几个花哨插件,而是让外部系统用统一方式进入 Agent Harness。

它解决的是工程上下文割裂问题:

代码在仓库
需求在工单
设计在 Figma
文档在知识库
数据在数据库
动作在各种内部系统

MCP 把这些系统接到 Agent 可调用的工具层里。真正落地时,重点不只是“能接”,更是“接得安全、可控、可审计”。

目录
相关文章
|
6小时前
|
人工智能 缓存 安全
03|编程 Agent 为什么会失控:上下文污染、工具误用和权限边界
编程Agent失控常因上下文污染、工具误用、权限模糊、目标不清及人过早退出循环。本文剖析五大根因,强调Harness设计比模型更重要:需清洁上下文、分层工具、分级权限、明确验证标准,并坚持“人机协同”闭环,实现安全高效的AI编程。(239字)
32 0
|
6小时前
|
JavaScript 定位技术 API
CodeGraph 爆火:编程 Agent 需要的不是更多上下文,而是一张提前画好的代码地图
CodeGraph 是一款爆火的本地代码智能工具,通过 tree-sitter 解析 AST 构建结构化知识图谱(存于 SQLite),为编程 Agent 提前生成“代码地图”。它显著降低 Agent 在中大型项目中的探索成本——实测工具调用减少71%、Token 降57%、速度提升46%,支持19+语言及主流框架路由识别,完全离线、无需 API Key。
288 1
CodeGraph 爆火:编程 Agent 需要的不是更多上下文,而是一张提前画好的代码地图
|
3月前
|
人工智能 Linux API
【最全】OpenClaw 阿里云/MacOS/Linux/Windows11本地部署流程+百炼API / SKill 接入及常见问题解答
OpenClaw(Clawdbot)作为开源的AI代理框架,凭借本地部署的隐私性、多端交互的灵活性以及可扩展的技能包体系,成为2026年AI工具生态中极具实用性的本地智能助手。与传统对话式AI不同,OpenClaw可通过技能包(Skills)实现浏览器操作、文件管理、办公自动化等实际工作流的落地,且能运行在MacOS、Linux、Windows11等主流系统,同时支持对接阿里云百炼等免费大模型资源,满足零基础用户的本地部署需求。本文将从多系统部署流程、阿里云百炼API配置、核心技能安装、常见问题解答四个维度,为新手提供完整的OpenClaw使用指南,全程无需专业代码基础,仅需跟随步骤执行命令即
842 3
|
3月前
|
人工智能 安全 网络安全
保姆级图文教程!OpenClaw(Clawdbot)阿里云/本地零基础部署:集成5700+必备 Skill,效率提升3-5倍
2026年初,OpenClaw(昵称“小龙虾”)以72小时狂揽60,000+ GitHub Stars的速度爆红,如今星标数已突破22万,不仅带动相关硬件热销,更重塑了人们对AI助手的认知。但很多用户部署后却陷入困惑:“工具看似强大,实际用起来却没发挥出预期价值”。
1081 1
|
6小时前
|
SQL Java 关系型数据库
【Spring全家桶】Spring Cloud 2023.0.x:分布式事务:Seata 四大模式(AT/TCC/SAGA/XA)、适用场景(附《思维导图》+《面试高频考点清单》)
本文系统梳理Spring Cloud 2023.0.x(Leyton)与Seata分布式事务的深度集成,涵盖AT/TCC/SAGA/XA四大模式原理、多维对比、场景选型及高可用实践,助力微服务数据一致性落地。
【Spring全家桶】Spring Cloud 2023.0.x:分布式事务:Seata 四大模式(AT/TCC/SAGA/XA)、适用场景(附《思维导图》+《面试高频考点清单》)
|
6小时前
|
测试技术 C++ Python
如何从零开发一个工业级的 SKILL
手把手教你搓个 Skill,亲测新手也能跑起来,实操党可以直接冲~
163 1
如何从零开发一个工业级的 SKILL
|
6小时前
|
人工智能 弹性计算 开发者
2026年阿里云618年中大促全攻略:AI加速季,年度低价云服务器推荐指南
本文将为大家详细解读2026年阿里云618的活动亮点,精选值得入手的高性价比便宜云服务器,助力大家低成本上云!
142 6
|
6小时前
|
机器学习/深度学习 人工智能 网络架构
深度解析:Transformer 的“灵魂”——QKV 变换的物理直觉
本文用图书馆检索等生活隐喻,从物理意义与认知科学角度解析Transformer中QKV设计的精妙本质:解耦查询(q)、键(k)、值(v)三重角色,实现语义分离、避免自注意力“自恋”,模拟人类动态信息路由的认知过程。(239字)
210 13
|
6小时前
|
人工智能 自然语言处理 API
阿里云Token Plan(团队版)ai模型订阅计划指南:Tokens按Credits计费,费用价格198元1个月起
阿里云百炼Token Plan团队版是面向企业/团队的AI大模型订阅服务,以Credits统一计费,支持Qwen3.6、GLM-5、Wan2.7等20+文本与图像模型,兼容OpenClaw、Qoder等主流工具;提供标准(198元/月)、高级(698元)、尊享(1398元)三档坐席,额度共享、预算可控、数据不用于训练。阿里云百炼官网:https://t.aliyun.com/U/fPVHqY
|
6小时前
|
SQL 人工智能 关系型数据库
AI Agent 混合检索选型:阿里云 AnalyticDB MySQL 向量+全文一站式方案
阿里云AnalyticDB MySQL版是面向AI Agent/RAG场景的一站式混合检索数据库,原生支持向量检索+全文搜索+结构化查询,单SQL实现三合一。延迟<10ms,成本降60%+,开发提效3倍,显著优于Milvus+Elasticsearch多组件架构。
140 6