name: "canva"
description: >-
Create and edit Canva designs, generate images, remove backgrounds, recover
editable layers, and work with Canva libraries. Use for branded presentations
and slide decks, campaign artwork, flyers and banners, applying saved brand kits
and templates, and resizing designs for social posts and stories through Canva's
official MCP server.
icon: "canva"
metadata: { "includeInPrompt": false }

Canva / Canva

Use the installed canva CLI. Start with canva status. If it reports
not_connected, run canva authorize-url and share only the returned
connect_url. If the CLI reports outdated OAuth settings, have the user
disconnect Canva in Settings and reconnect. Never request tokens in chat.

使用已安装的 canva CLI。先运行 canva status。若报告 not_connected，运行 canva authorize-url 并只分享其返回的 connect_url。若 CLI 报告 OAuth 设置过时，让用户在设置中断开 Canva 再重新连接。绝不在聊天中索要令牌。

Run canva list-tools for live schemas and use only tools returned there.
Follow their input schemas exactly and include a concise user_intent.
hatch_permission_overrides identifies argument-dependent permissions;
opening an editing transaction is a write and deleting pages is a delete.
Some tools require Canva Pro, Enterprise, or available AI credits.

运行 canva list-tools 获取实时 schema，且只使用其中返回的工具。严格遵循其输入 schema，并附上简洁的 user_intent。hatch_permission_overrides 标识依赖参数的权限；打开编辑事务算写入，删除页面算删除。部分工具需要 Canva Pro、Enterprise 或可用的 AI 额度。

Save each raw response before parsing. Check result.isError, then read
result.structuredContent when present or parse the JSON text block in
result.content. Both response forms are valid. A local parsing failure does
not mean a mutation failed: recover its response or inspect saved state before
continuing. Never repeat a copy, creation, or commit just to obtain its output.

解析前先保存每份原始响应。检查 result.isError，若存在 result.structuredContent 则读取之，否则解析 result.content 中的 JSON 文本块。两种响应形式均有效。本地解析失败不代表变更失败：先恢复其响应或检查已保存的状态再继续。绝不为拿回输出而重复执行复制、创建或提交。

canva search-designs [--query <keywords>] [--continuation <token>]
canva get-design-content --design-id <id>
canva get-design-pages --design-id <id>
canva list-tools
canva call-tool --name <tool-name> --arguments-json '<JSON object>'

Create designs and images / 创建设计与图片

Use create-design for a new editable layout: social post, infographic,
poster, flyer, presentation, document, or sheet. Put all necessary source
facts and requested wording in brief; the tool does not inherit chat or
connected-source context. Fetch the user-selected source first. For an exact
size, state dimensions and orientation in the brief. If supplying format,
include the orientation; an ambiguous format may resolve to a square.
Pass outline only for a presentation outline the user supplied or approved.

新建可编辑版面用 create-design：社交帖子、信息图、海报、传单、演示文稿、文档或表格。把所有必要的源事实和要求的措辞放进 brief；该工具不继承聊天或已连接来源的上下文。先抓取用户选定的来源。需要精确尺寸时，在 brief 中写明尺寸与方向。若提供 format，须包含方向；含糊的格式可能被解析为正方形。仅当演示大纲由用户提供或经其批准时才传 outline。

Use generate-image for an explicitly requested standalone image, photo,
illustration, artwork, or image of an infographic. Use one MEDIA reference
per uploaded source image. This generates an image rather than an editable
page layout. Use its returned media_id when editing a generated image again.

generate-image 用于用户明确要求的独立图片、照片、插画、艺术作品或信息图的图像。每个上传的源图对应一个 MEDIA 引用。它生成的是图片而非可编辑的页面版面。再次编辑生成的图片时使用其返回的 media_id。

create-design cannot apply brand kits or brand templates. For an explicitly
on-brand request, use the available legacy generate-design,
get-design-candidates, and create-design-from-candidate flow, showing
candidates for the user's choice. These tools are otherwise deprecated when
create-design is listed; failure of create-design is not permission to
fall back. generate-design does not support presentations despite its enum.
The legacy outline-review widget and structured presentation generator are
not exposed by this CLI. Do not substitute a non-branded generation when a
brand-specific presentation workflow is unavailable. A selected brand template
can still be copied with create-design-from-brand-template or autofilled.

create-design 不能应用品牌套件或品牌模板。对明确要求符合品牌风格的请求，使用可用的旧版 generate-design、get-design-candidates 与 create-design-from-candidate 流程，展示候选供用户选择。当 create-design 在列时，这些工具属于弃用状态；create-design 失败并不构成回退许可。尽管枚举里有，generate-design 并不支持演示文稿。旧版大纲审查组件与结构化演示生成器未由此 CLI 暴露。品牌专属演示工作流不可用时，不要用非品牌生成来替代。选定的品牌模板仍可用 create-design-from-brand-template 复制或自动填充。

Creation and layer separation return asynchronous jobs. When no Canva widget
is shown (including CLI use), poll the corresponding get-create-design-async-job,
get-generate-image-job, or get-separate-image-layers-job. Honor every
returned wait interval and updated continuation token. Never start a replacement
write because a job is pending. Stop on terminal failure; respect quota and
moderation failures. Show completed results using the preview workflow below.
For generated images,
include the returned Canva upload link with the text Open generated image.

创建与图层分离返回异步作业。当没有展示 Canva 组件时（包括使用 CLI），轮询对应的 get-create-design-async-job、get-generate-image-job 或 get-separate-image-layers-job。遵守每个返回的等待间隔和更新后的续传令牌。绝不因作业仍在进行而发起替代性写入。终态失败即停止；尊重配额与审核失败。用下文的预览工作流展示已完成的结果。对生成的图片，附上返回的 Canva 上传链接，文字为 Open generated image。

Upload and transform images / 上传与转换图片

For attachments, local files, or generated files up to 256 MiB, use
canva upload-file --file <path> --user-intent '<purpose>'. Its approval shows
the selected file and an image preview for workspace images. The CLI obtains
a single-use upload URL and sends the raw bytes after approval; use the returned
resource IDs in later calls. Do not repeat an upload whose outcome is unknown.
The low-level create-upload-url flow remains available for larger files: one
raw-byte POST with Content-Type: application/octet-stream, no multipart,
JSON, or base64. Never retry a consumed upload URL.

对最大 256 MiB 的附件、本地文件或生成的文件，使用 canva upload-file --file <path> --user-intent '<purpose>'。其审批会显示所选文件，工作区图片还带图片预览。CLI 获取一次性上传 URL 并在批准后发送原始字节；后续调用使用返回的资源 ID。结果未知的上传不要重复执行。底层 create-upload-url 流程仍可用于更大的文件：一次原始字节 POST，Content-Type: application/octet-stream，不用 multipart、JSON 或 base64。绝不重试已消费的上传 URL。

upload-asset-from-url and import-design-from-url accept already-public
HTTPS sources only. Do not publish local or private files to use those tools.
Uploading media does not place it into a design. create-design has no asset
input parameter: when exact supplied media must appear, use the editing flow
to insert or replace media with its verified Canva ID, then inspect the result.

upload-asset-from-url 与 import-design-from-url 只接受已经是公开的 HTTPS 来源。不要为使用这些工具而发布本地或私有文件。上传媒体并不会把它放进设计。create-design 没有素材输入参数：当指定的媒体必须出现时，使用编辑流程以其经验证的 Canva ID 插入或替换媒体，然后检查结果。

Use remove-background with an already-uploaded MEDIA reference to produce
a new image with transparent alpha. It does not replace the scene or crop the
subject. Use separate-image-layers with an uploaded image's asset_id to turn
a flat graphic into a new editable design; the original stays unchanged.
Verify editable elements with read-design, not appearance alone.

remove-background 配合已上传的 MEDIA 引用，生成带透明 alpha 的新图片。它不替换场景，也不裁剪主体。separate-image-layers 配合已上传图片的 asset_id，把平面图形变成新的可编辑设计；原图保持不变。用 read-design 验证可编辑元素，而不是只看外观。

Read, edit, and organize / 读取、编辑与整理

Use read-design for metadata, text, page metadata, thumbnails, and presenter
notes. The old MCP names get-design, get-design-content,
get-presenter-notes, and get-design-thumbnail are removed. The CLI
get-design-content convenience command now calls read-design.
get-design-pages remains available for saved page previews.

read-design 用于元数据、文本、页面元数据、缩略图和演讲者备注。旧 MCP 名称 get-design、get-design-content、get-presenter-notes 与 get-design-thumbnail 已移除。CLI 的 get-design-content 便捷命令现在调用 read-design。get-design-pages 仍可用于已保存页面的预览。

To edit, call read-design with open_transaction: true and include
thumbnails in filter.fields for a before preview. Use its transaction ID,
element locators, and page flags in edit-design with finalize: keep_open.
Read that transaction to inspect unsaved changes. Show the preview and obtain
explicit approval before edit-design with finalize: commit and no
operations. Use finalize: cancel to discard edits. These replace
start-editing-transaction, perform-editing-operations,
commit-editing-transaction, and cancel-editing-transaction, even when
older server descriptions still mention those names. Cancel stale
transactions and open a fresh one.

编辑时，以 open_transaction: true 调用 read-design，并在 filter.fields 中包含 thumbnails 以获得编辑前预览。将其事务 ID、元素定位符和页面标志用于 edit-design，设 finalize: keep_open。读取该事务以检查未保存的更改。展示预览并获得明确批准后，才以 finalize: commit 且不带操作的方式调用 edit-design。用 finalize: cancel 丢弃编辑。这些取代 start-editing-transaction、perform-editing-operations、commit-editing-transaction 与 cancel-editing-transaction，即使较旧的服务器描述仍提及那些名称。取消过期事务并开启新事务。

merge-designs combines or reorders whole pages. Obtain explicit approval of
the exact operations before each call; deleting pages is permanent.
copy-design and resize-design create new designs and preserve their source.
Before autofill-design, inspect get-design-dataset or
get-brand-template-dataset and match its field names/types. Set
update_in_place only when the user requested overwriting that design.

merge-designs 合并或重排整页。每次调用前先获得对确切操作的明确批准；删除页面是永久的。copy-design 与 resize-design 创建新设计并保留其源设计。autofill-design 之前，先检查 get-design-dataset 或 get-brand-template-dataset 并匹配其字段名/类型。仅当用户要求覆盖该设计时才设 update_in_place。

For brand-template updates, start with create-brand-template-draft, edit and
save its design through the current transaction flow, then use
publish-brand-template only when the user requested organization-wide
publication. Publishing affects a reusable shared template.

品牌模板更新从 create-brand-template-draft 开始，经当前事务流程编辑并保存其设计，然后仅当用户要求组织范围发布时才用 publish-brand-template。发布影响的是一个可复用的共享模板。

Resolve Canva shortlinks before using designs. Confirm get-export-formats
before export-design. Use help for current Canva product support questions,
not to describe this CLI's capabilities.

使用设计前先解析 Canva 短链接。export-design 之前先确认 get-export-formats。help 用于当前的 Canva 产品支持问题，而不是用来描述本 CLI 的能力。

Show results / 展示结果

Show a visual preview in chat alongside the returned Canva link when delivering
designs or images. Save returned image content, or download a returned thumbnail
URL with curl, to a file under workspace/. Inspect it with read, then attach
it on its own line as ![Preview](sandbox://workspace/path/to/image.png).
Preview each design in a small set; for a long deck, show representative pages
and label their page numbers. Local attachments remain useful after signed
preview URLs expire.

交付设计或图片时，在聊天中随返回的 Canva 链接一并展示视觉预览。把返回的图片内容，或用 curl 下载返回的缩略图 URL，保存到 workspace/ 下的文件。用 read 检查，然后单独一行附上 ![Preview](sandbox://workspace/path/to/image.png)。小集合中每个设计都预览；长幻灯片则展示代表性页面并标注其页码。签名预览 URL 过期后，本地附件仍然有用。

Check that the image shows the expected content; HTTP success alone does not
rule out a blank or stale thumbnail. If needed, request a fresh thumbnail or
export the saved design in a supported image format. Never commit unsaved
edits just to obtain a preview, or present a saved export as an unsaved draft.
If a usable preview is unavailable, explain that and keep the Canva link;
do not repeat creation or editing to repair a preview.

检查图片是否显示了预期内容；仅凭 HTTP 成功不能排除空白或过期的缩略图。必要时请求新缩略图，或以受支持的图片格式导出已保存的设计。绝不为获得预览而提交未保存的编辑，也不把已保存的导出当作未保存的草稿展示。若无法获得可用预览，如实说明并保留 Canva 链接；不要为修复预览而重复创建或编辑。

When asked to list designs, omit --query and follow continuation tokens.
This does not authorize background crawling or bulk indexing. Comments and
replies are visible to collaborators; post only when the user requested them.

被要求列出设计时，省略 --query 并跟随续传令牌。这不授权后台爬取或批量索引。评论与回复对协作者可见；仅在用户要求时发布。