智能体 MCP 接入

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

验证并调用能力

重载 MCP 后先让智能体调用 whoami，再按需入库素材并创建 AI 任务；可用下方提示词一键交给智能体。

连通性测试

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

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

入库并跑 AI

请调用声境 MCP，入库一张图片并完成一次 AI 处理。

【必须执行】
1. 若我提供了公网图片 URL：调用 importImageFromUrl；否则用 uploadImage（localPath 或 base64）
2. 调用 createAiMatting（或我指定的 createAiUpscale / createAiRemove / createAiGenerate / createAiExpand / createAiRedraw），传入上一步返回的 imageFileId
3. 调用 waitAiTask，等待任务成功或失败
4. 成功后告诉我：inputImageFileId、taskId、outputImageFileId、outputPublicUrl

不要只在聊天里描述，必须真正调用工具。精修（裁剪/水印等）请提示我回声境 Web 编辑器。

保存工作稿

请调用声境 MCP，将当前处理结果保存为声音作品。

【必须执行】
1. 若我未提供 imageFileId，先 listImages 让我确认要用哪张图
2. 调用 saveProject：作品名称可用「MCP 接入验证」；关联对应 imageFileId（优先 AI 输出图）
3. 调用 getProject 或 listProjects，确认作品已出现

完成后告诉我：workId、作品名称、封面/主图 URL。可在声境「作品中心」中继续编辑。

结果会出现在作品中心；也可去广场浏览公开歌曲。

工具能力

推荐顺序：whoami → importImageFromUrl|uploadImage → createAi* → waitAiTask → 使用 outputPublicUrl / outputImageFileId；需要沉淀时可 saveProject。裁剪/压缩/水印/调色等 Canvas 精修请回 Web 编辑器。

whoami校验密钥，返回签发者与工作空间摘要
listImages分页列出当前空间素材
getImage查询素材元数据与公网 URL
importImageFromUrl从公网 URL 入库素材
uploadImage本地路径或 base64 上传入库
createAiMatting创建 AI 抠图任务
createAiUpscale创建 AI 放大任务
createAiRemove创建 AI 消除任务
createAiGenerate创建 AI 文生图 / 图生图任务
createAiExpand创建 AI 扩图任务
createAiRedraw创建 AI 局部重绘任务
getAiTask查询 AI 任务状态与结果
waitAiTask轮询至任务终态或超时
cancelAiTask取消进行中的 AI 任务
listProjects分页列出声音作品
getProject查询作品详情
saveProject新建或更新作品
deleteProject删除作品

接入声境 MCP

签发 Agent 密钥

配置 MCP

验证并调用能力

工具能力