怎样让 AI 工具使用 Cocona？
从首页「API 接入」进入接入页面，登录后生成接入码，再在支持工具调用的客户端中完成配置。
配置后通过客户端实际读取一次 Mod 目录，才能确认连通。保存了配置文件不代表连接已启用；命令和格式以接入页、官方指南为准。
| 客户端实际能力 | 连接方式 |
|---|---|
| 远程 MCP，支持认证请求头 | 按接入页提供的远程 MCP 配置 |
| 本地 MCP | 使用官方 Python 桥接器与本地 MCP 配置 |
| 能运行 Python 或 HTTP | Python 客户端或 REST API |
| 仅聊天，不能配置或调用工具 | 先确认客户端有无合适的扩展能力 |
接入后，AI 应该怎样帮你创作？
先选风格或功能，确认参考图与内容，再获取报价并执行。
- 读取当前目录按素材类别检索，比较名称、简介与封面，选中后读取当前输入要求。
- 确认目标与报价确定风格、内容、数量与参数，展示预计萝卜，确认后生成。
- 等待并交付查询原任务，完成后下载产物。多步制作把已确认结果作为下一步参考；需要画布的功能回到网站使用。
对 AI 的需求示例
帮我找适合武侠 RPG 角色的国风风格，先展示几个封面，选定后报价做一张立绘。
开发者怎样避免重复任务和凭证泄漏？
按官方约定保存凭证、查询任务和重试，不把私人凭证写进公开文档或聊天记录。
- 接入码短时有效，私人凭证由官方脚本保存在本机受限目录。排查问题时不公开完整认证配置。
- REST 生成使用 Idempotency-Key，MCP 对应 requestId；同一任务超时重试时保留相同编号与输入。
- needs_input 时展示公开问题并续答；completed 后使用产物下载入口。
- 权限受凭证与功能范围限制。只读凭证不能生成，Agent 不能代替网站管理账户授权。