用 MCP 把 KPainter 接进兼容的 Agent
如果你要把 KPainter 接进兼容 MCP 的 client、IDE 或 agent host，MCP 就是更合适的入口。
KPainter MCP 是 public OpenAPI 的一层薄适配，继续沿用同一套正式内容类型、校验规则和异步创建流程。
什么时候优先用 MCP
| 接口 | 更适合 | 不是主场景 |
|---|---|---|
Skills |
最终用户直接在支持 Agent Skills 的 agent 里发起创作 | 自己做产品集成 |
OpenAPI |
你的产品直接走 REST 风格创建、轮询、列表和详情 | MCP 原生 agent 工具接入 |
MCP |
agent host、IDE、模型工具调用平台 | 替代主站浏览器接口 |
如果你在做 KPainter 主站页面，继续走 /kp-app-api/v1/*。
如果你在做自己的产品集成，默认还是优先看 OpenAPI。
如果你要把 KPainter 接到外部 MCP client，就从这里开始。
MCP 当前覆盖什么
当前 MCP 覆盖的是最小 public 创作链路：
- 校验用户 API Key
- 读取当前 catalog 和限制
- 发起创建
- 查看创作列表
- 读取创作详情
- 轮询异步任务状态
- 对支持的内容做单场景编辑
当前不覆盖：
- 注册或登录
- API Key 激活、重置、删除
- 支付和订阅
- 评论、聊天、点赞、浏览
- restart
- 更重的白盒编辑
支持的内容类型
MCP 里继续使用和 OpenAPI 一样的正式类型名：
explainer_videoslides_videovector_animationslide_deckimageinteractive_lesson
knowledge_video、web_app 这类旧别名在部分输入上可能仍兼容，但 MCP 的 resources、prompts 和 catalog 驱动工作流都应使用上面这组正式名。
不要在 MCP 里自行发明别名类型。
推荐工作流
- 先调
kp_me校验 key。 - 再调
kp_get_catalog，然后再决定type、voice_id、style_id、duration_seconds、scene_count等参数。 - 调
kp_create_creation。 - 轮询
kp_get_job_status。 - 调
kp_get_creation读取最终 URL、附件和 scenes。 - 如果要改单场景，先看
editable_actions和scenes，再调kp_edit_scene。
Tools、Resources、Prompts
当前 MCP 暴露了：
- 8 个
tools - 3 个
resources - 2 个
prompts
真正的集成主入口还是 tools。
resources 和 prompts 更适合做发现和引导。有些 resources 会依赖服务端默认 key，因此不要把它们当成显式用户鉴权的替代品。