MCP 安全与权限

开启 Agent 访问后，连接的客户端可以读取素材，包括原件和字幕。 整理与导入开关控制的是修改权限，不会把读取范围限制为预览图。

选择谁可以连接

Agent 访问默认关闭。在设置 → AI Agent 中选择监听范围：

监听范围	适用情况
仅本机	助手运行在同一台电脑上。这是默认选项。
本机与局域网	同一私有网络中的可信设备需要访问。使用显示的局域网地址和同一个令牌。

连接期间保持 ClipSeek 运行。关闭 Agent 访问或退出 ClipSeek，服务就会停止。当前不支持公网访问和外部反向代理，请勿把端口映射到公网。

保管好访问令牌

令牌相当于连接密码。能访问服务地址、又持有令牌的客户端，可以使用你已开启的工具。

• 只粘贴到可信客户端的身份验证设置中。
• 截图时遮住令牌，不要放入共享聊天、公开问题或代码仓库。
• 令牌可能泄露时，在 ClipSeek 中点击重新生成令牌，再更新客户端。旧令牌和已有下载链接会同时失效。

在 Codex 配置文件中，可以用 bearer_token_env_var 引用本机环境变量，方法见连接 Codex。

需要修改时，再开启额外权限

允许整理与导入独立控制，默认关闭。开启后可以新建文件夹、修改标签和文件夹归属、导入文件。导入会把接受的本机文件复制进素材库；调整文件夹归属不会移动磁盘上的源文件。

ClipSeek 会检查该权限，但不会为每次工具调用弹出确认框。请在 AI 客户端中设置审批，并让助手先展示修改清单。完成后可以关闭此权限。

MCP 没有删除或恢复素材、远程上传、跨库移动，以及创建、删除、迁移、合并素材库的工具。

下载链接也要保密

原件和生成文件通过临时下载链接获取，通常 10 分钟后失效。能访问服务且持有有效链接的人，可以下载对应文件。不要公开、转发，或把完整链接保存为永久地址。

预览只能读取素材库中已登记的资源，客户端不能提交任意文件路径来读取。交给 AI 客户端的内容受该客户端的数据使用设置影响，连接私人素材前请先查看相关设置。

技术限制与本机审计记录

• 每个 MCP 请求都需携带 Authorization: Bearer <token>，验证失败返回 HTTP 401。
• 令牌是独立保存的 256 位随机值；Unix 系统使用仅所有者可读写的文件权限。ClipSeek 不会把它放入 MCP URL 或应用日志。
• MCP：每个来源 IP 每分钟最多 240 个已认证请求。
• 下载：每个来源 IP 每分钟最多 120 个请求；整个服务同时最多 4 路下载。
• 图片/视频派生任务最多同时运行 2 个。临时缓存容量为 2 GiB；启动时清理超过 24 小时的孤立文件。
• 成功的整理操作、原件下载授权和派生结果会追加到本机 mcp-audit.jsonl，不记录令牌、下载凭据、完整下载链接或本机绝对路径。

参数限制和错误码见 MCP 接口参考。