快速开始
下面以本地 stdio 为例连接 KPainter MCP，并创建第一个结果。
1. 准备 API Key
- 登录 KPainter。
- 打开 API Key 页面。
- 激活并复制 Key。
- 将 Key 放入 MCP 客户端的安全配置。
2. 配置 stdio
如果环境中已安装 kp-mcp：
{ "mcpServers": { "kpainter": { "command": "kp-mcp", "args": ["--stdio"], "env": { "KGP_API_KEY": "<your_api_key>" } } }}从 kgp-service 源码运行时：
{ "mcpServers": { "kpainter": { "command": "python", "args": ["-m", "src.mcp_server", "--stdio"], "cwd": "/path/to/kgp-service", "env": { "KGP_API_KEY": "<your_api_key>" } } }}3. 读取能力
连接成功后，先调用 kp_capabilities。确认：
- 当前账号可用。
- products 中包含想创建的类型。
- 文件、视频、图片或应用参数来自最新响应。
4. 创建第一个结果
调用 kp_create：
{ "type": "video", "prompt": "面向新员工解释客户问题升级流程", "max_credits": 300, "video": { "duration_seconds": 120, "aspect_ratio": "16:9", "language": "zh" }}如果有附件，先使用 kp_upload_file，并把返回的 file_id 放入 input_file_ids。
5. 查询和获取结果
- 定期调用 kp_get。
- planning 或 producing 时继续等待。
- ready 后调用 kp_outputs。
- paused 时读取 available_actions，不要直接创建重复任务。
- failed 时向用户展示简明原因和可以采取的下一步。
6. 继续修改视频
{ "creation_id": "creation_xxx", "content": "保留其他部分，把第二个场景讲得更简单", "idempotency_key": "video-edit-20260901-001"}把上面参数传给 kp_message，然后继续用 kp_get 查询同一个 creation。