> ## Documentation Index
> Fetch the complete documentation index at: https://comfyart.org/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP 服务器

> 让内置 Agent 或任何本地 MCP 客户端查看并编辑画布。

ComfyArt 通过 HTTP 提供一个 [MCP](https://modelcontextprotocol.io) 服务器。内置 [Agent](/zh/guides/agent) 用的就是它，你也可以接上其他本地 MCP 客户端，比如终端里的 Claude Code 或 Codex。

## 启用

在 Agent 设置里勾选 **启用 MCP**。接口地址是：

```
POST http://127.0.0.1:8188/comfyart/mcp?project=<项目 id>
```

项目 id 就是 ComfyArt 网址里的 `project` 参数。画布工具由该项目打开着的 ComfyArt 标签页执行，请保持它开着。

以 Claude Code 为例：

```bash theme={null}
claude mcp add --transport http comfyart "http://127.0.0.1:8188/comfyart/mcp?project=<项目 id>"
```

## 工具

| 分类 | 工具 |
| - | - |
| 查看 | `server_info`、`get_canvas`、`view_canvas`、`focus`、`list_models`、`brand_kits` |
| 生成 | `generate_image`、`generate_video`、`wait_generation` |
| 编辑图片 | `edit_image`、`replace_text`、`upscale_image`、`remove_background`、`expand_image`、`split_layers`、`change_angle`、`animate_image` |
| 视频 | `extend_video` |
| 排版 | `add_text`、`add_shape`、`create_frame`、`update_shapes`、`delete_shapes`、`place_html`、`create_slides` |
| 记忆与技能 | `memory`、`skill` |

`generate_image` 和 `generate_video` 会立刻返回 id，再用这些 id 调 `wait_generation` 拿结果。用 `list_models` 可以查看哪些已安装的模型支持参考图。在内置 Agent 的对话里，Agent 还多一个工具，可以用选择题向你提问。

<Note>
  MCP 服务器是你本地 ComfyUI 的一部分，自己没有登录机制。能访问你 ComfyUI 端口的人都能用它，所以开启 MCP 时，请让 ComfyUI 只监听本机或可信的局域网。
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.