create_workitem_attachment
Upload any file as an attachment to a work item in Alibaba Cloud DevOps, returning a temporary download URL and permanent embed URLs for images.
Instructions
[Project Management] Upload a file as an attachment to a work item via multipart/form-data. Supports any file type (单文件 ≤ 10MB,云效不支持 svg/tiff)。 文件来源二选一:
远程(streamable HTTP)部署:传 fileContent(文件内容的 base64 编码)+ fileName(含扩展名)。此时 server 与调用方通常不同机,server 读不到调用方本地文件,必须走 base64 内联。
同机 / stdio 本地运行:传 filePath(绝对路径),server 直接读该文件;fileName 可省略(默认取路径 basename)。⚠️ 远程部署下 filePath 已被禁用(指向服务器文件系统,存在任意文件读取风险),只能用 fileContent。 返回 WorkitemFile 含以下关键字段:
id/name/size/suffix:文件基础信息url:OSS 临时下载地址,约 30 秒过期。⚠️ 仅用于下载,不要嵌入工作项描述/评论embedUrl:永久代理 URL,适用于在工作项描述/评论中嵌入图片embedMarkdown:预拼好的 Markdown 图片标签,formatType=MARKDOWN 时拼接进 description 即可embedHtml:预拼好的 HTML 标签,formatType=RICHTEXT 时拼接进 description 即可 在工作项描述中插入图片的标准三步法:① 创建工作项(如已有则跳过);② 调本工具上传图片、读出 embedMarkdown / embedHtml;③ 调 update_work_item,在 updateWorkItemFields.description 中拼入该 embed* 字段,同时设置 updateWorkItemFields.formatType 为 "MARKDOWN" 或 "RICHTEXT"。 应用 token 场景必传 operatorId,个人 token 必传可省略。
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fileName | No | 文件名(含扩展名,如 design.png)。提供 fileContent 时必填;提供 filePath 时可省略,默认取路径的 basename | |
| filePath | No | 本地文件的绝对路径,MCP Server 将读取该文件。仅适用于 server 与调用方同机的场景(如 stdio 本地运行)。⚠️ 远程(streamable HTTP)部署下本参数已被禁用(filePath 指向服务器文件系统,存在任意文件读取的安全风险),此时请改用 fileContent | |
| operatorId | No | 操作者的userId,个人token时该参数无效 | |
| workItemId | Yes | 工作项唯一标识 | |
| fileContent | No | 文件内容的 base64 编码。远程部署上传附件时使用,需配合 fileName。单文件 ≤ 10MB(base64 编码后约 13.5MB) | |
| organizationId | Yes | Organization ID, can be found in the basic information page of the organization admin console |