智能体 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（须指定 creationMode）；可用下方提示词一键交给智能体。

连通性测试

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

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

创建快速成片作品

请调用影境 MCP，创建一个快速成片作品。

【必须执行】
1. 调用 whoami
2. 调用 createProject：creationMode 必须传 quick；作品名称可用「MCP 接入验证」；ideaText 写一句简短创意
3. 调用 getProject：确认 creationMode 为 quick，并记下 webUrl
4. 告诉我作品 id 与可打开的 webUrl

不要调用 getScriptGeneratePrompts、generateStyleSetting 或任何画风 / 脚本工具（这些能力已从产品主轴下线）。
不要只在聊天里描述，必须真正调用工具。

一句话出片

请调用影境 MCP，在刚才的快速成片作品上出一条短视频。

【必须执行】
1. 调用 estimateBilling：taskType=shot_video，durationSeconds=5，向我确认预估巨豆
2. 调用 generateQuick：prompt 用一句画面描述（如「户外露营，暖光，商品特写」）
3. 调用 getTask，每 3–5 秒轮询直到 success 或 failed；失败不要盲重试超过 1 次
4. 成功后告诉我 outputPublicUrl 与 webUrl

不要只在聊天里描述，必须真正调用工具。

找片验证

请调用影境 MCP，帮我找一条抖音作品并拉详情。

【必须执行】
1. 调用 searchSocialWorks：platform=douyin，keyword 用我给出的关键词（若我没给，先问我一句）
2. 从结果里选一条，调用 getSocialWorkDetail：platform 与 videoId 与搜索结果一致
3. 若我需要内容拆解/口播拆解/结构拆解：必须调用 breakdownSocialCopy（不传 taskId）提交；再用返回的 taskId，以 platform+taskId 每 3–5 秒轮询直到完成；**不要用 getTask**（那是出片任务）；**禁止**仅凭 getSocialWorkDetail 的标题/文案自编拆解
4. 告诉我标题、作者、可打开的网页入口；若做了拆解，摘要结果一并给出

不要只在聊天里描述，必须真正调用工具。

创建成功后，可在作品列表中看到新作品，或打开返回的 webUrl 进入对应工作台。脚本页与风格母版已下线。

工具能力

推荐顺序：whoami → getCapabilities → createProject（须传 creationMode，如 quick）→ getProject 核对 webUrl。出片：estimateBilling → generateQuick → getTask。经智技 / Aido Skill 调用时须传 skillSlug（可选 skillSemver），写入作品溯源供广场「用同款技能」。找片：有链接用 previewSocialLink → getSocialWorkDetail；无链接用 searchSocialWorks → getSocialWorkDetail；找账号用 searchSocialAccounts → listSocialAccountWorks → getSocialWorkDetail；可选 breakdownSocialCopy（用返回的 taskId 轮询，勿用 getTask）。脚本、画风设定、风格母版已从产品主轴下线。

whoami校验密钥，返回签发者与工作空间摘要
getCapabilities查询可用创作方式、工具阶段与是否已接计费
createProject创建视频作品（名称与 creationMode 必填）
listProjects分页列出当前签发者的作品，可按创作方式筛选
getProject查询详情（创作方式、webUrl、成片与分镜摘要）
updateProject更新名称、描述或标签
deleteProject逻辑删除作品
estimateBilling预估本次出片巨豆
saveQuick写入快速成片 / 编辑 / 模仿 / 换装草稿
generateQuick保存并出片，返回任务
generateStoryboard按 Idea 拆专业分镜
listShots列出各镜摘要（不含完整分镜 JSON）
addShot末尾追加一镜（最多 30，可带文案）
updateShot增量改一镜文案 / 时长 / 参考
deleteShot删除指定镜，不重排剩余镜号
generateShotVideo指定镜出视频
getTask查询单个出片任务，建议每 3–5 秒轮询
listTasks查询作品近期任务
searchSocialWorks找片·按关键词搜作品（抖音 / 快手 / 视频号）
searchSocialAccounts找片·按关键词搜账号（抖音 / 快手 / 视频号）
listSocialAccountWorks找片·列出账号下作品
previewSocialLink找片·贴链接免费认片（不预检）
getSocialWorkDetail找片·作品元信息（不含口播）；内容拆解须再调 breakdownSocialCopy
breakdownSocialCopy找片·内容/口播/结构拆解；传 taskId 轮询，勿用 getTask，禁止用详情标题代替

接入影境 MCP

签发 Agent 密钥

配置 MCP

验证并创建作品

工具能力