返回首页

AGENT BRIDGE · MCP

把 Codex 接进你的莘禾工作台

Codex CLI、Claude Code 这类编程 Agent 现在可以通过标准 MCP 协议(Model Context Protocol) 直连你在莘禾账号下的漫剧项目。Agent 在终端里读到的、改动的,和你自己在网页上操作的是同一份数据—— 不需要导出文件、不需要复制粘贴,写操作还要经过你的人工确认。

端点 https://qixinhe.top/mcp8 个工具(4 读 + 4 写)OAuth 2.0 + PKCE 授权免费 · 需莘禾账号

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 开源技能库逛逛,那里有上千个可一键安装的开源技能。

AI Agent 接入指南(Codex / Claude Code / MCP) - 莘禾教育