# 在 Claude 里用

把 Side Space 接到 Claude，用一句话找视频里的台词、看中午以后改了什么、整理文件夹、给客户发链接。

Side Space 不内置 AI 助手，而是在 Claude 里用：接上以后，你直接跟 Claude 说要什么，它通过 [MCP 服务](/docs/mcp)按你的权限去找、读、整理和分享文件。

## 接上

- **claude.ai 和 Claude 桌面版**：打开设置里的“连接器”（Connectors），添加自定义连接器，地址填你的服务器加 `/mcp`，例如 `https://side.example.com/mcp`。点“连接”，在弹出的页面登录 Side Space，再点“允许”。团队版和企业版由管理员在组织设置里添加一次，成员各自登录。
- **Claude Code**：运行 `claude mcp add --transport http side https://side.example.com/mcp`，第一次用时会打开浏览器登录。

授权时只勾 Claude 需要的：只是找和读，`files:read` 就够；要改文件、整理文件夹，加 `files:write`；要发分享链接，再加 `shares:manage`（默认不勾）。

## 可以这样说

- “在 Film A 里找到港口夜戏，告诉我提到暴风雨是在第几秒。”
- “/Ep01 从昨天下午到现在改了什么？把 script.md 恢复成中午的样子。”
- “把 /dailies 里有声音的视频都转写一下。”
- “把这三条挪到 /selects，给客户做一个能评论、7 天有效的链接。”
- “让外拍组周五前把第三集素材传到 /Ep03/素材。”
- “把剧本第 12 场的错别字改掉。”（Claude 只改那一行，不会重写整个文件。）
- “给新上传的素材打标签，每条写一句概要追加到 notes.md。”

Claude 回答时会给出路径；视频和音频还会给出说到那句话的时间点，可以直接从那一秒打开。

## 怎么保证不出错

- 每次改动都存成新版本，删掉的东西在回收站里留 30 天。Claude 做的事可以一个文件一个文件地撤回，也可以[把整个文件夹退回去](/docs/history)。
- 工具的说明要求 Claude 删除前先问你；整体回滚先做一次演练（dry run），把要改的内容给你看。
- 修改只替换 Claude 指定的那段原文，别人在文件其他地方的改动会保留；那段原文已经不在了，修改就失败，不会乱改。
- 改动记在你名下（或者记在 [AI 成员](/docs/authentication#ai-成员)名下，带 Agent 标记）；每个工具都按你允许的空间和权限检查。
- 想断开，在 Claude 里删掉连接器，或者用 `sidespace token list` 找到 `app:…` 那一项，再 `sidespace token revoke`。

## 用沙盒试一试

[试用容器](/docs/quickstart#先在自己电脑上试)里自带几段示例视频，已经转写好、打好标签。claude.ai 连不到 `localhost`，Claude Code 可以：

```sh
claude mcp add --transport http side http://localhost:8080/mcp \
  --header "Authorization: Bearer $SIDESPACE_TOKEN"
```

然后问它：“Film A 里有什么？哪一段有人在说港口？”

全部工具见 [MCP](/docs/mcp#工具)。