通过 MCP 连接外部助手

MCP 让兼容的外部 AI 客户端调用正在运行的 ShotAI，查询素材信息或执行操作。建议先查看素材库信息，再在一个指定收藏夹中做小范围搜索。使用 ShotAI 桌面界面的普通搜索不需要配置 MCP。

连接前准备

在与客户端相同的电脑上打开 ShotAI，登录账号，并完成素材导入与 AI 理解。连接期间保持 ShotAI 开启。客户端需要支持本机 SSE 连接和 Authorization 请求头；只支持远程 HTTPS 服务的客户端不能直接使用这个本机地址。

以下内容说明 ShotAI 提供的连接信息。不同客户端的配置文件和传输方式支持不同，请按所用客户端当前的 MCP 说明配置；设置页中提及某客户端，不代表其所有版本均已通过兼容验证。

找到连接信息

1. 打开 设置 → 关于 → 外部 Agent，英文界面为 Settings → About → External Agents。
2. 如果 MCP Server 尚未开启，启用后确认界面显示服务正在运行。
3. 查看当前安装版本显示的地址与连接参数，使用 Copy MCP configuration，或将字段分别填入客户端的 MCP 设置。
4. 妥善保管 Auth Token。它用于授权访问本机 ShotAI 工具，不要将真实值写入共享说明、截图或代码仓库。

下面是含占位符的示例，不能原样作为有效凭据使用：

{
  "mcpServers": {
    "shotai": {
      "url": "http://127.0.0.1:23817/sse",
      "transport": "sse",
      "headers": {
        "Authorization": "Bearer YOUR_SHOTAI_AUTH_TOKEN"
      }
    }
  }
}

请使用自己应用内显示的值。这是 ShotAI 展示的配置结构，部分客户端要求不同的配置格式。地址指向你自己的电脑，不是云端托管的 ShotAI API。

核对一次只读任务

先让客户端列出收藏夹或统计素材库。连接成功后，应返回真实的 ShotAI 数据。若无法发现或调用工具，先解决连接问题，再尝试完整工作流。

然后把下面的收藏夹名称替换成自己的项目：

请确认名为“秋季宣传片”的收藏夹，只在这个收藏夹中搜索有人在笔记本上写字的镜头。最多返回三个候选，列出源视频及起止时间，并核对每条候选确实属于该收藏夹。收藏夹不存在或重名时停止并说明。不要修改或导出素材。

在 ShotAI 中打开候选，确认实际画面。分数和助手摘要都不能替代对具体要求的检查。收藏夹范围限制的是检索，不是访问权限。

连接异常时

本次核验的 1.2.0 连接一次支持一个 SSE 客户端。重新连接前，先关闭另一个已连接客户端。还应确认 ShotAI 保持打开、服务显示运行中，以及客户端能发送所需请求头。身份验证失败、传输方式不支持、素材尚未完成理解，是不同的问题。

如果客户端拒绝配置，向支持团队提供客户端名称、版本和已脱敏的报错。不要通过将本机服务暴露到公网来解决连接问题。外部客户端收到的素材信息还适用其自身数据处理规则，详见隐私与联网。