MCP — 连接 AI 代理

Claude 等代理可直接操作此编辑器。

登录后，在 photovim.com 上也能使用。在下方获取连接码，然后在您自己的电脑上运行一行命令。连接码只在几分钟内有效，并且只连接到您的标签页。

有何不同

代理制作的内容会保留为可编辑的文档，而不是一张拼合的图片。

文字以文字图层形式出现，背景也是单独的图层，因此修改文案或颜色可以直接在原处完成。
代理执行的操作只占一步撤销。不满意时按 Ctrl+Z 即可撤回。
它在您正在查看的标签页中运行 — 同一文档、同一撤销记录。

获取连接码

保持编辑器标签页打开，获取连接码，然后将下面这行粘贴到您自己电脑的终端中。连接码几分钟后过期。

登录以获取连接码

免安装连接（远程）

和 Canva、Figma 一样，一个 URL 就够了，无需 Node。对于 Claude Code，下面一行即可；获取连接码后会自动填入相应位置。

claude mcp add --transport http photovim https://photovim.com/mcp --header "Authorization: Bearer 连接码"

其他客户端使用 URL https://photovim.com/mcp 并附带 Authorization: Bearer 连接码 请求头；如果无法发送请求头，则使用 https://photovim.com/mcp/连接码。远程时没有 open_file（它需要您电脑上的路径），export 只以图像形式返回 png/jpg/webp。

通过软件包连接 (npx)

将以下内容添加到客户端的 MCP 配置中。只需 Node 22 或更高版本 — 无需安装任何东西。在上方获取连接码后，连接码位置会自动填入。

{
  "mcpServers": {
    "photovim": {
      "command": "npx",
      "args": ["-y", "@photovim/mcp", "--url", "wss://photovim.com/cable", "--code", "连接码"]
    }
  }
}

各客户端

Claude Code: 放入工作文件夹中的 .mcp.json，或用 claude mcp add photovim -- npx -y @photovim/mcp --url … --code … 添加。
Claude Desktop · Cursor: 将其原样添加到 claude_desktop_config.json 的 mcpServers 下，然后重新启动 Claude Desktop。
Codex: 在 ~/.codex/config.toml 的 [mcp_servers.photovim] 下填写相同的 command 和 args。

如何确认已连接

查看编辑器菜单栏中“帮助”右侧的 MCP。按钮中的圆点表示当前状态。

绿色 — 已连接。代理执行操作时，也会显示其名称。
黄色 — 正在连接，或在连接中断后正在重新连接。
红色 — 无法加入。请检查令牌或服务器。

目前可用的功能

打开和存储文档、选区、创建/排列/变换/调整图层、添加和编辑文字、绘制画笔描边、去除背景、选择主体、AI 生成、撤销 — 共 34 个工具。

工具	作用	类型
连接
`list_tabs`	当前打开的编辑器标签页	读取
`attach`	连接到某个编辑器标签页 — 之后的工具都在该标签页中运行（同一文档、同一撤销记录）	选择
`get_capabilities`	此编辑器当前能做什么 — 格式、调整名称、模型	读取
文档
`open_file`	将图像、PSD、.photovim 或 TIFF 作为新标签页打开	更改（计入撤销）
`new_document`	创建空白文档	更改（计入撤销）
`list_documents`	打开的文档（标签页）	读取
`select_document`	选择文档（标签页）	选择
`export`	将文档存储为文件 (.png .jpg .webp .psd .photovim)	读取
查看
`get_state`	文档状态 — 大小、修订号、图层树、选区、撤销深度	读取
`list_layers`	图层列表和状态（与 get_state 相同）	读取
`screenshot`	当前合成结果 (PNG)	读取
选区
`rect_select`	矩形选区（文档坐标）	选择
`select_subject`	用浏览器内模型找到主体并将其选中（照片不会离开浏览器）	选择
`deselect`	取消选择	选择
`selection_to_mask`	将选区转换为当前图层的蒙版	更改（计入撤销）
图层
`select_layer`	将一个图层设为当前图层（按 id 或 index）	选择
`add_layer`	在顶部添加空图层	更改（计入撤销）
`set_layer_props`	图层名称、可见性、不透明度、混合模式	更改（计入撤销）
`move_layer`	移动图层（相对 dx/dy 或绝对 x/y）	更改（计入撤销）
`reorder_layer`	更改图层顺序	更改（计入撤销）
`transform_layer`	缩放或旋转图层（文字和智能对象图层保留其值）	更改（计入撤销）
像素与调整
`fill_selection`	用颜色填充选区（或整个图层）— 文字、形状和智能对象图层需要 rasterize: true 才会填充	更改（计入撤销）
`paint_strokes`	逐笔绘制画笔描边（点、颜色、大小、不透明度、硬度）— 可在编辑器中看到绘制过程	更改（计入撤销）
`apply_adjustment`	对当前图层应用调整（亮度、色阶、曲线、色相…）— 文字和形状图层需要 rasterize: true 才会先栅格化再应用；智能对象会作为智能滤镜添加	更改（计入撤销）
`remove_background`	用浏览器内模型去除背景	更改（计入撤销）
`resize_image`	调整图像大小（所有图层一起）	更改（计入撤销）
`crop`	将文档裁剪为矩形	更改（计入撤销）
文字
`add_text`	创建文字图层	更改（计入撤销）
`edit_text`	更改文字图层的内容、位置或格式	更改（计入撤销）
AI 生成
`list_ai_models`	可用于 AI 生成的模型、每次运行消耗的积分以及您的剩余积分	读取
`generate_image`	用 AI 编辑（选区或整个图像）、根据文字生成新图像或移除内容 — 结果放在新图层上。积分模型会消耗您的积分	更改（计入撤销）
`ai_job_status`	继续等待耗时较长的生成并获取结果（新图层、消耗的积分）	读取
批处理与撤销
`batch`	将多条命令作为一个整体运行 — 只占一步撤销。onError=rollback 时，一旦失败将还原整个批次	更改（计入撤销）
`undo`	撤销上一步操作	更改（计入撤销）

限额

限额按人计算。一条命令算一次调用；batch 按其中的每个步骤计数。读取和写入计数相同。超过限额时，该命令会立即收到“已达到频率限制”的回复。

	当前（所有人）
每分钟	300 次
每天	20,000 次
同时连接的代理	10

尚不支持：“帮我做一个横幅”这类一步到位的结果已在计划中。目前需要逐个调用这 34 个工具。

返回编辑器