Origin MCP
Origin MCP 把 Origin 的平台工具（生成素材、发布游戏、角色与讨论、素材库、知识库、数据分析）接进你的 Agent，只需要一个地址，在浏览器里登录即可。
地址
Origin MCP 的地址是 https://mcp.origingame.ai/mcp。这是一个远程 MCP 服务器（Streamable HTTP），在客户端里命名为 origin。连接 Origin MCP 和发布游戏不收费；生成图像、音频、视频和 3D 时按模型价格从你的 Origin 余额扣费。
Origin MCP 只提供平台工具，不提供模型或对话工具。想让 Agent 使用 Origin 的模型，见 接入 Agent 和 模型 API。
在客户端中安装
选择你的客户端，按步骤添加地址并登录。每个客户端只需要三步：添加地址、在浏览器里登录 Origin、开始使用。
第 1 步 ·添加 Origin
在终端运行这一行，为你的所有项目添加 Origin MCP。
claude mcp add --transport http --scope user origin https://mcp.origingame.ai/mcp第 2 步 ·在浏览器里登录
启动 Claude Code，输入 /mcp，选中 origin 后选择 Authenticate。浏览器会打开 Origin 授权页，登录并确认即可。
/mcp第 3 步 ·开始使用
再输入一次 /mcp，origin 显示已连接（connected）后，直接用自然语言提出需求。
完整的分步指南和可复制的命令在 Origin MCP 页面。要一次配置多个 Agent：终端里用 安装脚本，图形界面或 Windows 上用 Origin Kit。
连接好以后，在 Agent 里能看到 origin 和它的工具，就可以直接用自然语言提出需求，例如「用 Origin 生成一张 16:9 的像素风森林关卡背景，再生成一张透明背景的主角立绘」。
登录与授权
浏览器登录
Origin MCP 是 OAuth 2.1 受保护资源，支持远程 MCP 登录的客户端只需要地址：
- 未登录的请求返回 401，响应头
WWW-Authenticate指向https://mcp.origingame.ai/.well-known/oauth-protected-resource。 - 这份元数据给出授权服务器
https://origingame.ai/identity/v1和授权范围create:read、create:write。 - 客户端用 PKCE 打开浏览器，你登录 Origin 并确认授权。
- 客户端拿到短期访问令牌（有效期一小时），并自动续期。
| 授权范围 | 允许 |
|---|---|
create:read | 读取：发现、状态、你的游戏、版本、任务、素材和分析数据 |
create:write | create:read 的全部，加上计费的生成和发布等写操作 |
调用需要的授权范围超出已授权范围时，返回 403 insufficient_scope；请在客户端里重新授权，不要改用其他凭据。
无界面使用
CI、脚本和不支持 OAuth 的客户端，在 Authorization 请求头里携带账号 API Token（og- 开头，在 访问凭据 创建）或设备凭据：
claude mcp add --transport http --scope user origin https://mcp.origingame.ai/mcp \ --header "Authorization: Bearer $OG_API_KEY"
其他客户端在远程服务器配置里设置同样的请求头 Authorization: Bearer og-...。不要把密钥写进提示词、项目文件、URL 或游戏代码。安装脚本和 Origin Kit 只在 Agent 不支持浏览器登录时，才为它配置可撤销的设备凭据。
撤销授权
在 访问凭据 页面：通过浏览器登录的 Agent 在「已连接的应用」里，能看到授权范围和最近使用时间；用设备登录的客户端在「已登录设备」里。撤销其中一个，不影响其他 Agent 和你的账号 API Token。
工具的组织方式
Origin MCP 先提供三个发现工具，再把每个操作列为一个独立的带类型工具：
docs：浏览、搜索和分页读取公开指南。search：按领域、名称或关键词查询操作，返回当前的参数结构、副作用（read、write或billable）和对应指南。execute：在一次受限运行中用origin.call(name, args)组合多个操作。operations是本次运行允许调用的操作清单，不代表用户已批准。
支持工具搜索的客户端可以直接调用 generate_image 这类操作；其他客户端用 execute 组合。两条路径使用相同的处理逻辑、权限检查和审计。示例 execute 参数：
{
"operations": ["deploy_list"],
"code": "async () => await origin.call('deploy_list', {})"
} 调用前先用 search 读取操作的实际参数结构，不要根据指南猜参数名。deploy_delete、deploy_discard_release、game_leaderboard_reset 等不可恢复的操作带有 destructiveHint 标注，客户端应先向你确认。
领域
| 领域 | 内容 | 示例工具 |
|---|---|---|
generate | 图像、音乐、音效、语音、视频、3D 与动作的生成，余额与用量 | generate_image、image_cutout、generate_music、generate_video、generate_3d、generate_balance |
deploy | 发布与更新游戏、版本回滚、商店封面、运营已上线的游戏、起步模板 | deploy_create、deploy_update、deploy_status、deploy_releases、deploy_generate_artwork、sdk_scaffold |
universe | 公开搜索、角色、二创与谱系、频道、讨论 | universe_search、character_create、game_remix、channel_create、discussion_post |
aigcc | AIGCC 赛事报名作品的封面、上传与发布 | aigcc_begin、aigcc_generate_cover、aigcc_publish、aigcc_status |
assets | 搜索和下载素材库中的图像、3D、音频、HDR 与字体 | assets_search、assets_search_3d、assets_detail、assets_download |
knowledge | 有来源的玩法与类型设计知识 | gameplay_search、gameplay_get、genre_browse、concept_compare |
registry | 可复用的代码模块 | registry_search、registry_list、registry_get |
analytics | 你账号范围内的游戏漏斗、版本对比和工作流运行分析（只读） | analytics_game_funnel、analytics_compare_game_versions、analytics_run_summary |
完整、最新的操作列表以 search 的返回为准。某个领域暂时不可用时，search 会在 unavailable 中列出它，而不是返回空结果。
指南
docs({ id }) 读取下列指南；docs({}) 列出全部，docs({ query: "上传" }) 按关键词搜索。
| id | 内容 |
|---|---|
onboarding | 连接与登录 |
credentials | OAuth 登录与授权范围、无界面使用的密钥、计费查询 |
unified-tools | 使用 docs、search 和 execute |
game-development | 开发一个能顺利发布的游戏 |
sdk | 游戏协议 2：与 Player 通信 |
local-files | 本地文件、上传、下载和可选的命令行 |
assets | 查找和安装素材 |
generation | 生成媒体并恢复任务 |
publishing | 发布与恢复版本 |
universe | 角色、二创、发现与讨论 |
aigcc | 发布 AIGCC 赛事作品 |
knowledge-registry | 研究玩法设计、复用代码 |
analytics | 读取游戏与工作流分析 |
troubleshooting | 诊断连接、安全恢复 |
长任务
声明支持 MCP Tasks 扩展（io.modelcontextprotocol/tasks）的客户端，直接调用 generate_video、generate_3d、generate_tripo_3d、generate_speech、generate_motion、deploy_create 或 deploy_update 并启动了新任务时，会收到一个任务句柄，而不是任务的第一个状态。
- 用
tasks/get轮询，间隔 2 到 10 秒（以返回的pollIntervalMs为准）；句柄有效 24 小时。 - 任务完成后，
tasks/get返回与同步查询相同的结果，包括媒体。 - 不支持该扩展的客户端用
generate_get_tasks查询，或用generate_wait_tasks等待（每次最多 30 秒）。 execute里的调用和aigcc_publish始终是同步的。
限制
execute 在隔离的沙箱中运行，没有文件系统、网络或凭据：
| 项目 | 上限 |
|---|---|
| 代码大小 | 32 KB |
| 每次运行的操作调用 | 32 次 |
| 每个操作的参数或结果 | 1 MB JSON |
| 最终返回的 JSON | 256 KB |
| 沙箱内存 | 32 MiB |
| 执行时间 | 2 秒有效执行时间，总时长 10 分钟 |
不要把构建 ZIP 或大图片内联进代码，改用 local-files 指南中的上传流程。沙箱停止不会撤销已经开始的写操作：返回的每个调用都标记为 started、completed、failed 或 unknown，重试前先检查状态。
旧的分领域端点
mcp.origingame.ai 上的 /generate/mcp、/deploy/mcp、/aigcc/mcp、/knowledge/mcp 和 /registry/mcp 已弃用，由 /mcp 取代。在 2026-12-31 之前它们仍可使用，每个响应带有 Deprecation、Sunset 和指向 https://mcp.origingame.ai/mcp 的 Link 头；之后返回 HTTP 410（endpoint_retired）。浏览器登录得到的访问令牌只能用于 /mcp。
如果你的 Agent 里还有 origin-assets、origin-generate、origin-deploy、origin-aigcc、origin-knowledge 或 origin-registry，重新运行 安装脚本：它会移除由它写入的旧条目，只保留 origin。
排错
| 现象 | 处理 |
|---|---|
| 浏览器没有弹出登录 | 手动触发：Claude Code 输入 /mcp 选 Authenticate，Codex 运行 codex mcp login origin，Cursor 在 MCP 设置里点 Connect。仍然不行时，确认默认浏览器能打开 origingame.ai，并把 Agent 更新到最新版本。 |
| 401、令牌无效或已撤销 | 用正确的账号重新登录，或通过安装脚本、Origin Kit 重新连接。不要从其他程序的配置里提取凭据。 |
| 503 Identity unavailable | 凭据验证服务暂时不可用，不是凭据失效；稍后重试。 |
| 403 | 确认账号和目标游戏的归属；insufficient_scope 表示需要重新授权更大的范围。 |
429 rate_limited | 等待 Retry-After 秒后，只重试读操作或标记为可重试的调用。 |
search 的 unavailable 不为空 | 该领域暂时不可用，稍后再发现；不要因此重复计费操作。 |
outcome_unknown | 写操作或扣费可能已经发生。用保存的 ID 查询状态（如 deploy_status、generate_get_tasks），不要直接重试。 |
| 新旧工具名同时出现 | 重新运行安装脚本，它会移除旧条目并报告保留的条目。 |
向支持反馈时，提供操作名、时间、任务或操作 ID 和 HTTP 状态码，不要附带令牌、Cookie 或签名 URL。