开放接口
MCP 接入指南
把 夸创 AI 的画布接进你自己的 AI Agent（Claude Code、Codex、千问等）。Agent 通过 MCP 协议操作你的画布：创建工作流、连线、运行生成、读取结果——像在网页里一样，但由你熟悉的 Agent 驱动。
三步接入
- 生成配对码：登录后进 「个人中心 → MCP 连接」，生成一个配对码（形如
mkp_xxxx...）。 明文只显示一次，请立即复制保存。 - 在 Agent 里添加 MCP 服务器：按下面你的 Agent 对应的配置片段， 服务器地址填
https://aigc.makur.top/api/mcp，鉴权填你的配对码。 - 开始对话：直接用自然语言让 Agent 搭建或运行工作流， 例如「列出我的画布工作流」「新建一个文生图工作流：赛博朋克城市夜景，运行它」。
各客户端配置
Claude Code
终端运行（把 mkp_你的配对码 换成实际配对码）：
claude mcp add --transport http makur-canvas https://aigc.makur.top/api/mcp \ --header "Authorization: Bearer mkp_你的配对码"
也可以在项目根目录 .mcp.json 里配置（支持环境变量）：
{
"mcpServers": {
"makur-canvas": {
"type": "http",
"url": "https://aigc.makur.top/api/mcp",
"headers": { "Authorization": "Bearer ${MAKUR_MCP_TOKEN}" }
}
}
}OpenAI Codex CLI
编辑 ~/.codex/config.toml：
[mcp_servers.makur-canvas]
url = "https://aigc.makur.top/api/mcp"
http_headers = { Authorization = "Bearer mkp_你的配对码" }千问 Qwen Code
终端运行：
qwen mcp add --transport http makur-canvas https://aigc.makur.top/api/mcp \ --header "Authorization: Bearer mkp_你的配对码"
豆包 / 其他客户端
任何支持「远程 MCP 服务器（Streamable HTTP）+ 自定义请求头」的客户端都可以接入： 服务器 URL 填 https://aigc.makur.top/api/mcp，请求头Authorization: Bearer mkp_你的配对码。豆包桌面版是否已开放 MCP 入口以其官方更新为准。
Agent 可用的工具
| 工具 | 作用 |
|---|---|
| list_node_types | 列出全部画布节点类型与端口定义（搭建前必读） |
| list_models | 列出可用 AI 模型与积分单价 |
| list_workflows | 列出我的工作流（摘要） |
| get_workflow | 读取工作流内容（摘要 / 完整 JSON） |
| create_workflow | 创建新工作流（整包写入） |
| update_workflow | 更新工作流（整包覆盖，支持乐观锁） |
| run_workflow | 运行工作流，同步返回各节点输出（按模型扣积分，失败自动退款） |
| get_run | 查询运行状态与结果 |
| cancel_run | 取消运行（未消耗积分自动退还） |
安全说明
- 配对码等同画布操作权限：只通过 HTTPS 传输、只存哈希、可随时在个人中心撤销。
- Agent 只能操作你自己的工作流与运行记录，无法访问其他用户数据。
- 运行工作流按平台模型定价扣你的积分；生成失败自动退还未消耗部分。
- 不用或怀疑泄露时，请立即到个人中心撤销配对码，撤销即时生效。