MCP 图像任务怎样对应工具、输入与交付?
| 创作任务 | 调用与必要输入 | 参数或执行约束 | 交付核对 |
|---|---|---|---|
| 文生商品场景图 | generate_image:prompt;可选 model、size、quality、count | count 为 1–16;实际尺寸与档位以模型目录、报价为准 | 背景、构图、实际尺寸与原图格式 |
| 参考图局部修改 / 换背景 | derive_image:编辑要求 + referenceImages 或 parentTaskId | 多图父任务须指定 parentImageIndex;这是参考编辑,不是独立蒙版抠图接口 | 商品比例、Logo、未要求修改区域;透明交付检查 alpha |
| 多 SKU / 多图位 | batch_generate:一次预览完整 items,重复配置用 count | 整批预计积分与授权统一核对;由服务端按空闲并发补位 | 按任务 ID 关联 SKU 与图位,成功项不重生 |
| 商品细节放大 / 动漫增强 | upscale_image:一张 image + operation | x2、x4、anime、face;可用性由 processingOperations 返回 | 放大前后材质与边缘,面部修复须检查身份特征 |
| 中断后取回结果 | wait_images:照搬原回执 nextAction.arguments | 沿用原 requestId / batchId,不以下载失败为由重新预览 | 先展示已完成结果,保存原图后核对文件可打开 |
从客户端连接到第一份图像报价
- 登录 MCP Server 页面,查看 MCP 权益,在配置中创建或选择本人 Token,并检查需要的生成、模型与批量 Scope。
- 根据 Claude Code 或 Cursor 的配置格式连接 https://mcp.inkroom.ai,验证工具发现;此步骤不执行付费生图。
- 提交参考、提示词、图位和数量取得 preview,核对实际模型与预计积分;按已保存授权执行,需本次确认时再批准。
可复制的 MCP Server JSON 配置
服务使用 Streamable HTTP 与 Bearer MCP Token。两份示例分别对应官方客户端结构,不需要先调用公共 API,也不需要把 API Key 换成私有请求字段。
Claude Code · .mcp.json
{
"mcpServers": {
"inkroom": {
"type": "http",
"url": "https://mcp.inkroom.ai",
"headers": {
"Authorization": "Bearer YOUR_INKROOM_MCP_TOKEN",
"X-InkRoom-Continuation": "receipt-v1"
}
}
}
}Cursor · mcp.json
{
"mcpServers": {
"inkroom": {
"url": "https://mcp.inkroom.ai",
"headers": {
"Authorization": "Bearer YOUR_INKROOM_MCP_TOKEN",
"X-InkRoom-Continuation": "receipt-v1"
}
}
}
}Claude Code 在项目 .mcp.json 中使用 type:http;Cursor 在客户端的 mcp.json 中使用 url 与 headers。将 inkroom 条目合并到已有 mcpServers,保留其他连接。占位符替换为本人 MCP Token;不要把个人配置文件公开分享。X-InkRoom-Continuation 用于现有回执续取规则,属于 MCP 配置,不用于公共 API。
此配置适用于支持自定义 HTTP Header 的宿主。仅支持 OAuth 的网页连接器需要先核对兼容性;不能承诺 Claude 网页、Perplexity 或所有 AI 助手均可直接连接。
文字生图、参考编辑与增强的 Tool 列表
list_models— 查询模型、图片处理项与当前权限generate_image— 文字生图与费用预览derive_image— 参考图编辑与已有图片衍生upscale_image— 放大、动漫增强与面部修复batch_generate— 多项任务批量提交wait_images— 取回已完成图片与原图链接
局部修改与背景清除以 derive_image 提交原图和编辑要求;当前没有独立 remove_background 工具或专用 mask 字段。透明 PNG 需检查真实 alpha。upscale_image 的 x2/x4/anime/face 是独立处理项,不接收提示词或通用模型参数;先用 list_models 核对真实可用性。
MCP Token 与 API Key 的获取路径
MCP:登录 → MCP Server → 配置 → 创建或选择 MCP Token → 复制完整 Token。API:登录 → API 管理 → 创建或选择 API Key → 按 API 文档填写鉴权。两类凭据不能混用;注册、复制示例或完成安装都不会自动授予模型权限或提高费用额度。
相关场景与官方配置文档
客户端配置文档核对:
直接用这三个场景配方开始
打开只预填提示词;按要求添加参考图、查看预计积分并确认后再生成。
玻璃滴管瓶:只替换桌面背景
参考图要求:一张清晰正面商品原图,瓶身轮廓和标签可读;不要使用已压缩的聊天缩略图。
以参考图中的琥珀色玻璃滴管瓶为唯一商品。保持瓶身高度、肩部弧度、滴管盖、原标签文字和 Logo 的位置及比例,只把背景改为浅灰无缝影棚与哑光石材桌面。正面三分之四视角,柔和侧光,保留真实玻璃透光与自然接触阴影。画幅 1:1,商品完整入镜,不添加文字、道具或第二个瓶子。未要求修改的商品区域尽量保持;标签变形的结果不要用于发布。运动鞋新品:侧面主广告样图
参考图要求:同一双鞋的清晰侧面原图,鞋款、色号和鞋带方式一致。先验证单图;其他图位各自替换描述后交给 MCP 批量执行。
使用运动鞋参考图,为新品广告制作一张侧面主视觉样图。浅米色哑光地面与同色无缝背景,完整呈现一只鞋的侧面轮廓。保持参考的鞋面配色、商标、材料纹理、鞋型和缝线,使用柔和侧光并保留轻微接地阴影。横向 4:3,鞋尖朝右且完整入镜,左上方留出后期排版空间;不叠字、不加价格,不拼图、不新增另一只鞋。保温杯白底:清除环境干扰
参考图要求:一张杯身完整、杯盖轮廓清楚的原图;金属反光未过曝,保留产品标识。
将参考图中的保温杯整理为电商白底商品图。移除原场景背景和旁边道具,背景目标为纯白 RGB 255,255,255;保留杯盖、杯把、金属拉丝、杯身标识与真实比例。杯子竖直居中完整入镜,四周留出可裁切空间,无新增文字、边框或水印。保留轻微自然接触阴影,不把白底伪装成透明图;发布前单独核对背景像素、边缘和标识。发布前质检清单
- 连接后能发现所需 Tool;MCP Token 具有对应 Scope,模型与处理项处于可调用状态。
- 执行前报价包含实际模型、参数、数量和预计积分;使用已保存授权,超额时确认本次整单。
- 逐图核对 SKU、Logo、玻璃或金属边缘与要求保留区域;去背景需求另查纯白像素或 alpha。
- 用原任务回执确认成图归属;原图可打开、尺寸正确,保存失败只续取下载,不再次付费生图。
FAQ
Claude Code、Cursor 和 Claude 网页可以直接用同一段配置吗?
下方分别提供 Claude Code 的 type:http JSON 与 Cursor 的 url/headers JSON。InkRoom 使用 Streamable HTTP 和个人 Bearer MCP Token;Claude 网页、Perplexity 或其他宿主只有支持自定义远程地址和安全 Bearer Header 时才能使用。仅支持 OAuth 的连接器不能直接套用,不把目录上架视为客户端兼容证明。
去背景和局部重绘对应哪个 Tool?能保证透明 PNG 吗?
当前使用 derive_image 提交原图与局部修改或背景清除要求,需由所选模型支持。它不是独立的 remove_background Tool,也没有专用蒙版输入。PNG 格式不等于有透明通道;需要透明交付时必须检查原文件 alpha,标签、发丝、玻璃边缘仍需人工核对。
MCP Token 在哪里获取?可以填 API Key 吗?
登录后进入 MCP Server 配置页,创建或选择本人 MCP Token,再复制到客户端 Authorization: Bearer 占位处。公共 API Key 从 API 管理页获取,用于 /v1 或 /v1beta 的标准协议请求,不能代替 MCP Token;MCP 的费用预览和回执步骤也不作为公共 API 的前置要求。
参考资料
最后核验日期: