用途:通过 Rube MCP 调用 Composio 的 Canva 工具包,自动化 Canva 的设计、素材、导出、文件夹与品牌模板操作。工具包文档见 composio.dev/toolkits/canva。
前提:Rube MCP 已连接(RUBE_SEARCH_TOOLS 可用);通过 RUBE_MANAGE_CONNECTIONS 以 toolkit canva 建立有效 Canva 连接;每次先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema。
设置:在客户端配置中添加 MCP 服务器 https://rube.app/mcp,无需 API 密钥;确认 RUBE_SEARCH_TOOLS 有响应;调用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit canva;若连接非 ACTIVE,按返回的授权链接完成 Canva OAuth;确认状态为 ACTIVE 后再运行工作流。
主要能力与用法:
- 浏览设计:CANVA_LIST_USER_DESIGNS,支持 query、continuation、ownership、sort_by;结果分页,需跟随 continuation,搜索为子串匹配。
- 创建设计:可选 CANVA_ACCESS_USER_SPECIFIC_BRAND_TEMPLATES_LIST,再用 CANVA_CREATE_CANVA_DESIGN_WITH_OPTIONAL_ASSET,参数含 design_type、title、asset_id、width/height;设计类型须精确匹配,素材需先上传。
- 上传素材:CANVA_CREATE_ASSET_UPLOAD_JOB 发起,CANVA_FETCH_ASSET_UPLOAD_JOB_STATUS 轮询;异步,状态为 in_progress、success、failed;支持 PNG、JPG、SVG、MP4、GIF 等。
- 导出设计:CANVA_CREATE_CANVA_DESIGN_EXPORT_JOB 发起,CANVA_GET_DESIGN_EXPORT_JOB_RESULT 轮询获取下载链接;格式含 pdf、png、jpg、svg、mp4、gif、pptx;异步,下载链接会过期,建议每 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、title、data 填充;占位符区分大小写,仅品牌模板支持,异步需轮询。
通用模式:异步任务先发起拿 job_id,再轮询至 success 或 failed;名称转 ID 需先列表再匹配;分页用 continuation。注意 API 速率限制,批量操作应实现指数退避并尽量批处理;响应数据可能嵌套在 data 键下,需防御性解析。
限制:具体文件大小上限、速率限制数值、自定义尺寸范围等未在资料中给出,需查阅 Canva 官方文档确认。