芊云小助手 MCP：让 AI 直接协助你管理全景

什么是芊云小助手 MCP？

芊云小助手 MCP 是芊云全景正式上线的 Model Context Protocol 服务。它把芊云全景的知识查询和内容管理能力，连接到支持 MCP 的 AI 客户端中，让 AI 能够在清晰的工具规范下理解你的全景业务请求。

它不是一个普通聊天窗口，也不是把所有功能混在一起的“万能按钮”。芊云小助手会按照作品、场景、素材、音乐、语音、热点和开发者能力进行分类，再选择对应工具处理任务，让 AI 的调用路径更清楚、参数更可靠、结果更容易核对。

服务入口由芊云全景 MCP 控制器统一承接，并经过开发者 key 鉴权、访问限流、参数 Schema 校验和业务权限链路，适合个人创作者、全景工作室、企业运营团队以及开发者使用。

为什么需要芊云小助手 MCP？

目前可以连接哪些芊云全景能力？

芊云小助手采用“顶级工具—业务大类—具体小工具”的分层方式。AI 会根据你的请求选择对应能力，你不需要把所有工具名称都记下来。

如果你只是想了解芊云全景的功能、规则、接入方式或操作流程，直接咨询即可，芊云小助手会优先查询“芊云全景百科全书”资料工具；如果你要真正查询或修改账号下的数据，则会进入对应业务工具。

芊云小助手是怎样工作的？

这种设计的重点是让 AI “知道什么时候用哪个工具、每个字段应该填什么、出错后如何修正”，而不是简单地把大量接口名称堆给用户。

如何接入芊云小助手 MCP？

1. 登录芊云全景账号。确认使用的是需要访问作品和素材的账号。
2. 获取开发者 key。打开 开发者凭证页面，获取当前账号对应的 MCP 凭证。
3. 打开 AI 客户端的 MCP 配置。将芊云小助手作为远程 MCP 服务添加，服务地址为 https://api.9kvr.cn/api/mcp/index.html?key=你的开发者key。
4. 重新连接或初始化客户端。客户端首次连接时会读取芊云小助手的初始化规范和工具清单。
5. 先做只读验证。可以先询问“查询我的作品列表”或“芊云全景如何发布作品”，确认连接、账号和工具调用均正常。

{
  "mcpServers": {
    "qianyun-assistant": {
      "url": "https://api.9kvr.cn/api/mcp/index.html?key=你的开发者key"
    }
  }
}

不同 AI 客户端的配置文件格式可能略有不同，请以客户端实际要求为准。不要把真实 key 发布到公开仓库、截图、文章或聊天群中。

接入后可以怎样使用？

资料咨询：直接问芊云全景相关问题

例如：

• “芊云全景如何发布作品？”
• “芊云全景支持哪些开发者接入方式？”
• “怎样给全景作品添加语音讲解？”

这类请求的重点是获取资料，芊云小助手会查询芊云全景百科资料并返回原始知识内容，再由 AI 整理成适合阅读的答案。

作品查询：让 AI 协助定位内容

• “列出我最近创建的全景作品。”
• “查询作品 123 的详细信息。”
• “看看这部作品有哪些场景。”
• “读取这部作品的评分和优化建议。”

内容管理：明确说明目标和动作

• “把作品名称修改为‘春日展厅’。”
• “给这部作品添加一首系统音乐，循环播放。”
• “在大厅场景添加一个跳转到展厅的热点。”
• “上传这段配音，并添加到指定作品。”

涉及修改、删除、上传和发布等写入操作时，建议补充明确的目标 ID、对象范围和期望结果。目标不明确时，AI 应先向你确认，而不是猜测执行。

安全与权限：为什么可以放心使用？

谁适合使用芊云小助手 MCP？

• 全景创作者：减少在作品、场景和素材页面之间反复查找的时间。
• 全景工作室：用统一的 AI 入口处理多个作品和内容资产。
• 企业运营团队：快速查询作品状态、素材信息和内容配置。
• 开发者：通过标准 MCP 协议把芊云全景能力接入自己的 AI 工作流。
• 自动化团队：将作品查询、素材整理和内容检查纳入已有的 AI 流程。

常见问题