向阳AI · MODEL CONTEXT PROTOCOL

让你的 Agent
接入完整创作流程

通过 MCP 连接向阳AI，从画布编排、模型与报价查询，到生成、任务跟踪和资产管理，在你熟悉的 Agent 中完成创作。

管理连接查看接入方法

Streamable HTTP/api/mcp

当前页面 /mcp 是接入文档；客户端的服务器地址请填写 /api/mcp。

CAPABILITIES

从读取到生成，清楚知道每一步

读取与查询

读取画布与节点、可用模型及参数、当前报价、任务状态和资产信息。读取和报价本身不提交生成任务。

编辑与管理

创建、重命名和删除画布，增删改节点与连线、编排布局、管理引用素材与资产，并对可取消的任务发起取消请求。

生成与交付

按可用模型和参数提交生成、查询进度、获取结果与资产，并把结果用于画布创作。以服务端返回的状态和结果为准。

连接后的执行授权与算力点

账号连接完成后，你向 Agent 明确提出的操作意图即是执行授权。MCP 不要求每次生成再做一次独立确认。 例如，请求“按这个分镜生成视频”会允许 Agent 提交相应生成任务。

生成按向阳AI网站当时的模型与参数价格扣除当前账号的算力点，服务端实时报价与账单为准。本页不固定价格；你可以要求 Agent 先查询报价并告知预计消耗。仅询价不等于要求生成。

网站内原有的生成确认流程保持不变。撤销连接会阻止后续调用；已经提交的任务需另行查询并按支持的取消规则处理。

ACCOUNT CONNECTION

连接你的向阳AI账号

连接可读取账号内的画布、模型、任务与资产，编辑画布，并按你的指令执行生成与任务操作。生成使用当前账号的算力点余额。

正在确认登录状态…

CONNECT YOUR CLIENT

使用连接令牌接入

确认客户端能力
客户端需支持远程 MCP、Streamable HTTP，以及自定义 Authorization 请求头。不同客户端的配置格式和可用能力可能不同，请按其实际设置填写。
创建并保存令牌
登录后为该客户端创建一个连接，将只显示一次的令牌存入客户端的安全凭据设置。请勿把令牌发到聊天、共享文档或公开配置中。
填写远程服务地址
服务器地址为 /api/mcp，请求头为 Authorization: Bearer <YOUR_MCP_TOKEN>。将占位符替换为你的令牌，替换只在客户端中完成。
先查询，再开始创作
完成连接后，可先让 Agent 列出可用模型或画布，验证接入；提出生成指令前，可指定模型、数量和预算。可用工具以服务端实际提供的列表为准。

通用远程 MCP 配置示例

此 JSON 表达所需的地址与请求头，不保证所有客户端直接兼容；不支持自定义请求头的客户端不能使用此令牌配置。

{
  "mcpServers": {
    "xiangyang_ai": {
      "type": "http",
      "url": "/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_MCP_TOKEN>"
      }
    }
  }
}

OAuth 账号连接由支持该流程的客户端发起，浏览器授权页为 /mcp/connect；是否可用取决于客户端与服务端的 OAuth 支持。上面的令牌接入不依赖 OAuth，也不会自动触发 OAuth 授权。

原生 3D 导演台

MCP 可以读取导演场景，操作模型、姿态、相机和时间线，并请求截图或导出 MP4。执行这些原生操作时，请在网站登录同一账号，打开对应画布并保持页面可见；浏览器负责实际渲染，正在执行的导演操作结束后才会领取下一项作业。

作业排队不代表导出完成，请通过 canvas_director_job_get查询原作业的保存回执与输出资产。截图和原生视频导出不调用付费生成模型，不扣生成算力点；失败或中断后先查询原作业，不会自动重新渲染。

通过 MCP 上传参考素材

客户端可以完全通过 MCP 上传本地文件，无需额外调用上传 HTTP 接口。先使用 assets_prepare_upload 提交文件名、类型、字节数和整文件 SHA-256，取得 uploadId 与 chunkBytes。

按指定大小分块
以返回的 chunkBytes 为块大小切分原文件。使用 assets_upload_chunk，逐块传入同一个 uploadId、从零开始的字节偏移 offset 和该块的 dataBase64；最后一块可以不足整块。
完成并校验
全部分块上传后调用 assets_finish_upload。服务端组装文件并校验大小和 SHA-256，成功后返回可用于画布引用与生成的 assetRef。中断时复用原上传入口和相同分块内容继续，不要重新提交生成任务。

assets_prepare_upload 同时返回 uploadUrl 和 PUT 方式，支持直接 HTTP 上传的客户端也可使用该入口。上传文件本身不提交生成任务、不扣生成算力点；有效期、文件上限和分块大小以服务端返回为准。

连接遇到问题

客户端连接失败怎么办？

确认使用的是 /api/mcp，而不是文档页 /mcp；检查客户端支持 Streamable HTTP 与自定义请求头，令牌没有多余空格且未撤销。如果服务暂不可用，请稍后重试。

令牌丢失或不再使用某个客户端？

在“我的连接”撤销对应连接。令牌不能再次查看；需要继续使用时创建新连接。算力点余额和扣费记录可在个人中心查看。

取消任务与撤销连接有什么区别？

取消任务会向服务端请求停止具体任务，能否取消以及费用处理取决于当时任务状态和网站规则；撤销连接只停止该客户端的后续访问，不代表取消任务或退款。