Skip to main content
云效这条线适合接研发流程：工作项、Codeup 仓库、MR、流水线、Packages 制品。当前官方主路径是云效 MCP；本地如果有非常高频、固定字段的工作项流程，可以再包一层脚本或 Skill。

​
能做什么

本地 DataPipe 的可复用经验是：业务侧 SDK 放在独立 Codeup 仓库维护，通过云效 Packages PyPI 分发；消费侧固定版本安装，不再用 sibling path 或源码压缩包联调。

​
官方 MCP

前提条件：
  • Node.js >= 16
  • 云效个人访问令牌，按实际需要授予组织管理、项目协作、代码管理、流水线、制品仓库等权限
  • MCP 客户端，例如通义灵码、Cursor、Claude Code、Codex 或其他支持 MCP 的工具
NPX 配置示例：
Docker 配置示例：

​
使用顺序

接好 MCP 后，优先让 Agent 做读操作：
  1. 搜索项目和工作项，读取需求描述、字段、评论。
  2. 查询 Codeup 仓库、分支、文件树、MR。
  3. 查看流水线、运行记录、任务日志。
  4. 查看 Packages 仓库和制品版本。
写操作要收紧权限和动作边界：
  • 创建/更新文件、分支、MR 前先让 Agent 明确仓库、分支和目标文件。
  • 运行流水线前先确认 pipeline、环境和变量。
  • 更新工作项状态前先确认目标状态，避免跨工作流误改。
  • 不把访问令牌、私有仓库 URL、制品源 token 写进回复或仓库文档。

​
本地经验：工作项脚本 + Packages

更稳的模式是：把“读取工作项、提炼需求、交付评论”这种固定动作包成脚本或 Skill，把云效 MCP 用在更宽的探索场景。 推荐分层： Packages 的使用原则是：业务侧固定版本安装制品，不通过 sibling path 或源码压缩包联调。Python SDK 可以写成：
实际项目里把 <org>、<repo>、包名和 token 都放到私有配置或 CI secret，不写进文档正文和仓库。

​
Agent 工作流模板

适合从云效工作项驱动一次开发：
  1. 读取工作项标题、描述、评论、字段和验收条件。
  2. 用一句话复述范围，列出不做什么。
  3. 在本地仓库实现并运行最贴近的测试。
  4. 创建 MR 或交付 diff。
  5. 在云效工作项写一条短评论，说明已完成内容和验证命令。
交付评论保持短：
不要把长日志、密钥、私有路径或内部推理粘到云效评论里。

​
官方文档入口