用途:通过 Composio 的 Canva 工具包,经 Rube MCP 自动化 Canva 设计相关操作,适合批量查找、创建、导出设计,整理文件夹,或用品牌模板批量生成设计。
前置条件:Rube MCP 必须已连接(提供 RUBE_SEARCH_TOOLS);需通过 RUBE_MANAGE_CONNECTIONS 以 toolkit canva 建立有效 Canva 连接。设置方式为在客户端 MCP 配置中添加 https://rube.app/mcp,无需 API key。连接未激活时按返回的授权链接完成 Canva OAuth,确认状态为 ACTIVE 后再执行工作流。执行前始终先调用 RUBE_SEARCH_TOOLS 获取最新工具模式。
主要能力:
- 列出与浏览设计:CANVA_LIST_USER_DESIGNS,支持 query、continuation、ownership、sort_by;结果为分页,需跟进 continuation,搜索为子串匹配。
- 创建设计:可先浏览品牌模板,再用 CANVA_CREATE_CANVA_DESIGN_WITH_OPTIONAL_ASSET,参数含 design_type、title、asset_id、width/height;设计类型须与 Canva 预定义类型完全一致,资源须先上传。
- 上传资源:CANVA_CREATE_ASSET_UPLOAD_JOB 发起,CANVA_FETCH_ASSET_UPLOAD_JOB_STATUS 轮询 job_id 直至 success;异步,支持 PNG、JPG、SVG、MP4、GIF 等,有文件大小限制。
- 导出设计:CANVA_CREATE_CANVA_DESIGN_EXPORT_JOB,再 CANVA_GET_DESIGN_EXPORT_JOB_RESULT 轮询获取下载 URL;格式含 pdf、png、jpg、svg、mp4、gif、pptx,可指定 pages、quality;异步且下载链接会过期,建议每 2-3 秒轮询。
- 文件夹管理:CANVA_POST_FOLDERS 建文件夹,CANVA_MOVE_ITEM_TO_SPECIFIED_FOLDER 移动条目;同一父文件夹下名称需唯一。
- 品牌模板自动填充:CANVA_ACCESS_USER_SPECIFIC_BRAND_TEMPLATES_LIST 列出模板,CANVA_INITIATE_CANVA_DESIGN_AUTOFILL_JOB 用 brand_template_id 与 data 键值生成;占位符须精确匹配,仅品牌模板支持,异步需轮询。
常见模式:先发起作业获取 job_id,再每 2-3 秒轮询状态,成功时提取 asset_id、download_url 或 design_id;通过名称查询解析设计 ID 或模板 ID;分页需传递 continuation。
限制与注意事项:上传、导出、自动填充均为异步,不可假设立即完成;资源须先上传成功;Canva API 有速率限制,批量操作应用指数退避并尽量批处理;响应数据可能嵌套在 data 键下,需防御式解析;具体格式限制与配额以 Canva 文档为准。收费、价格与平台信息暂未提供。