AGENT BRIDGE · MCP
把 Codex 接进你的莘禾工作台
Codex CLI、Claude Code 这类编程 Agent 现在可以通过标准 MCP 协议(Model Context Protocol) 直连你在莘禾账号下的漫剧项目。Agent 在终端里读到的、改动的,和你自己在网页上操作的是同一份数据—— 不需要导出文件、不需要复制粘贴,写操作还要经过你的人工确认。
QUICK START
Codex CLI:两条命令接入
Codex 把「注册」和「登录」分成两步:第一条只是把莘禾写进它的 MCP 配置,第二条才会打开浏览器走授权。
第 1 步 · 注册莘禾 MCP 服务
$ codex mcp add qixinhe --url https://qixinhe.top/mcp第 2 步 · 浏览器授权登录
$ codex mcp login qixinhe执行后会自动打开浏览器,跳到 qixinhe.top/mcp/connect 的授权确认页。用你的莘禾账号登录并点「允许」,回到终端就完成了。
用其他 Agent?
Claude Code 用户执行下面这条命令,首次使用时会自动触发同样的浏览器授权;Cursor 用户在 .cursor/mcp.json 的 mcpServers 里加一条 { "url": "https://qixinhe.top/mcp" } 即可。任何支持 MCP Streamable HTTP + OAuth 的客户端都能接入。
$ claude mcp add --transport http qixinhe https://qixinhe.top/mcp接入后 Agent 能做什么
MCP 工具全部调用莘禾后端的同一套 API,不另存一份数据。读操作随时可用;写操作要求参数里显式带上人工确认标记,Agent 无法背着你偷偷改项目。
读 · narrative.read(默认授予)
narrative_list_projects列出你有权限访问的漫剧项目,并返回可直接打开的项目链接。
narrative_get_project读取单个项目的 StoryBible、审核状态、实体、剧集与镜头计数。
narrative_list_skills列出已审核通过的制作技能,供 Agent 参考专业流程。
narrative_list_workflow_templates列出可用的生产工作流模板(如批量分镜、连续出图)。
写 · narrative.write(授权时勾选)
narrative_create_project创建空漫剧项目,返回项目 ID 与可打开的网页链接。
narrative_start_intake把结构化故事设定导入项目;参数必须包含 confirmedByHuman: true。
narrative_approve_story_bible审批人工已确认的 StoryBible;参数必须包含 confirmedByHuman: true。
narrative_apply_workflow_template把某个工作流模板应用到项目上,启动批量生产任务。
接入之后,试着这样说
授权完成后新开一个 Codex 会话,用自然语言下指令,Agent 会自己挑合适的工具:
- 「列出我的漫剧项目,并把《都市逆袭》的世界观和主要角色整理成一份设定摘要。」
- 「帮我创建一个新的 9:16 竖屏漫剧项目,标题叫「新品发布短剧」,创建完把链接给我。」
- 「看看这个项目还卡在哪个审核环节,把待办事项汇总成清单。」
权限与安全边界
Token 永不进配置文件
授权走 OAuth 2.0 授权码 + PKCE 流程:访问令牌只有 1 小时有效期,由客户端自动用 30 天有效期的刷新令牌续期,全程不存在「把密钥粘贴进配置文件」这一步,也绝不会共享你的登录密码。
写操作必须人工确认
故事导入、StoryBible 审批这类写工具,参数里必须显式携带 confirmedByHuman: true 才会执行;授权页上你也可以只授予只读权限(narrative.read),不让 Agent 碰任何写操作。
随时可撤销
不想继续用了,在 Agent 客户端里移除 qixinhe 这个 MCP 服务即可;撤销后已发放的令牌立即失效,下次使用需要重新授权。
绑定你的工作区身份
每次 Agent 请求都以你在授权时确认的工作区身份执行,遵守项目的审批、预算与审计规则——Agent 看到的权限不会比你本人在网页上多一分。
需要先拥有一个莘禾账号(授权确认环节要用它登录)。接入本身免费,Agent 通过工具产生的正常生产消耗(如批量出图)按站内积分规则结算。 想装「技能」丰富 Agent 的专业流程?去AI Skill 开源技能库逛逛,那里有上千个可一键安装的开源技能。