智能体 MCP 接入

签发 Agent 密钥
前往巨人肩膀工作空间设置，在 Agent API Key 中点击「签发密钥」，复制明文密钥（仅显示一次）。
密钥格式一般为 bigapp_...，请妥善保存明文密钥。
配置 MCP
将 BIGAPP_API_KEY 换成你的密钥后写入 MCP 配置；推荐用 npx 拉取 yingjing-mcp，无需本地构建。需 Node.js 18+。
已有 MCP 选，首次用，后粘贴到 .cursor/mcp.json 或 Cursor Settings → MCP。
```
{
  "mcpServers": {
    "yingjing": {
      "command": "npx",
      "args": [
        "-y",
        "yingjing-mcp"
      ],
      "env": {
        "BIGAPP_API_KEY": "粘贴你在工作空间签发的密钥"
      }
    }
  }
}
```

验证并创建项目

重载 MCP 后先让智能体调用 whoami，再 createProject；可用下方提示词一键交给智能体。

连通性测试

请调用影境 MCP 工具 whoami，测试影境是否已连通。

【必须执行】
1. 使用 MCP 工具 whoami（不要猜测或模拟返回）
2. 调用成功后告诉我：creatorUserId、工作空间名称
3. 若失败，把报错信息原样贴出

创建项目并写脚本

请调用影境 MCP，创建一个视频项目并写入脚本。

【必须执行】
1. 调用 createProject，项目名称可用「MCP 接入验证」
2. 调用 updateProject，用 scriptDocument 写入简短结构化脚本（不要手写分镜纯文本），例如：
   {"title":"MCP 接入验证","shots":[{"index":1,"durationSeconds":5,"visual":"产品界面亮相","narration":"影境已连通","subtitle":"接入成功"}]}
3. 调用 getProject 核对名称，并确认返回的 scriptDocument.shots 非空

完成后告诉我：项目 id、项目名称。不要只在聊天里描述，必须真正调用工具。

生成或修改画风设定

请调用影境 MCP，为指定项目生成或修改「画风设定」。

【必须执行】
1. 若我未提供 projectId，先 listProjects 让我确认项目
2. 调用 getStyleSetting 查看当前画风设定
3. 若需 AI 生成：调用 generateStyleSetting（覆盖已有时 regenerate=true，可附 extraRequirement）
4. 若需手改：调用 updateStyleSetting，只传要改的字段（styleName / styleDescription / colorTone / negativePrompt / defaultRatio / lockedSeed）
5. 再调用 getStyleSetting 核对结果

注意：不会自动出风格主图或锁定风格卡；主图请在 Web 风格母版页生成。完成后告诉我 styleName、colorTone、defaultRatio。

创建成功后，可在项目列表中看到新项目；画风设定会出现在项目「风格母版」页。

工具能力

推荐顺序：whoami → createProject → updateProject（scriptDocument）→ generateStyleSetting 或 updateStyleSetting → getStyleSetting 核对。首期不开放分镜/时间轴/风格主图写入。

whoami校验密钥，返回签发者与工作空间摘要
createProject创建视频项目（名称必填）
listProjects分页列出当前签发者的项目
getProject查询详情（含 scriptContent 与 scriptDocument）
updateProject更新名称/描述/标签与/或脚本（优先 scriptDocument）
deleteProject逻辑删除项目
getStyleSetting查询画风设定（风格卡文案 + 色调/负向词/比例/Seed）
generateStyleSettingAI 生成/重新生成画风设定（自动落库，不出主图）
updateStyleSetting手动修改画风设定（按字段增量更新）

接入影境 MCP

签发 Agent 密钥

配置 MCP

验证并创建项目

工具能力