Harness AI 实战指南⑤:MCP Server,让 Claude Code 直接读取你的 CI/CD 数据
2026-08-28
·
入门教程
·
有封面图
你在 Claude Code 里写代码,突然想知道:上次的部署为什么失败了?
正常情况下,你要打开 Harness 的 Web 界面,登录,找 pipeline,翻日志。
Harness 的 MCP Server 想让这一步消失:你直接在 Claude Code 里问,它去 Harness 查,然后告诉你答案。
它是什么
MCP Server 是 Model Context Protocol 的服务器实现。Harness 把它的 CI/CD 数据——pipeline 状态、部署历史、Secret、执行日志——通过 MCP 协议暴露出来,让支持 MCP 的外部 AI 工具(Claude Code、Cursor、Gemini CLI、VS Code)能直接读取。
不是让 AI 控制你的 Harness,是让 AI 能"看见"你的 Harness 里发生了什么。
具体有多少数据
根据官方文档,Harness MCP Server 提供:
- **11 个 consolidated 工具**:执行查询、读取状态、触发特定操作
- **139 种 resource 类型**:pipeline、stage、artifact、secret、connector 等对象的详细数据
- **MCP v2 预览版**:10 个工具 + 119+ 资源类型 + 26 个内置 prompt 模板(提示词模板帮你省去写查询语句的麻烦)
安装很简单,一条命令:
```
npx harness-mcp-v2
```
装完之后,在你的 AI 工具配置文件里加上 Harness 的 MCP 地址和账号令牌,就能用了。
支持哪些工具
官方列出支持:VS Code、Cursor、Claude Desktop、Gemini CLI。
基本上主流的 AI 编程工具都覆盖到了。只要那款工具支持 MCP 协议,就能接。
一个真实场景
你在 Claude Code 里重构一个服务,改完之后跑测试失败了。
你不需要切出去看 CI。直接在对话框里问:
> "刚才那个 PR 的 pipeline 为什么失败了?"
Claude Code 通过 Harness MCP Server 拉取 pipeline 状态,告诉你:"第 3 阶段 unit test 失败,错误是 import 路径写错了,具体在 src/utils/format.py 第 12 行。"
你直接在 Claude Code 里改,再提交。
整个过程你没有离开编辑器。
它和前面几篇的关系
- Code Agent(②):在编辑器里帮你写代码
- DevOps Agent(③):在 Harness Web 里帮你写 pipeline YAML
- Worker Agents(④):在 pipeline 里自动跑任务
- **MCP Server(⑤):让外部 AI 工具能读取 Harness 的数据**
前三篇是 Harness 自己提供 AI 能力,这一篇是把 Harness 的数据开放给别的 AI 工具。方向反过来了。
限制
- 需要 Harness 账号授权,MCP v2 目前还是预览版(API 可能变)
- 它提供的是"读"能力,不推荐通过 MCP 直接触发部署等写操作(安全风险)
- 数据范围取决于你的账号权限,看不到的你依然看不到
下期预告
Harness 和 Copilot、Cursor、Claude Code 比,到底独特在哪?下期做一个横向对比,帮你看清什么场景该用哪个。
---
参考:Harness 官方文档(developer.harness.io)
评论区