> For the complete documentation index, see [llms.txt](https://getsquish.gitbook.io/squish/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://getsquish.gitbook.io/squish/zh/can-kao/remote-mcp.md).

# 远程 MCP 端点

`https://api.getsquish.app/mcp` — 与……相同的引擎 [MCP 服务器](/squish/zh/can-kao/mcp.md)，通过官方 MCP 传输 **可流式 HTTP** 传输方式。它面向那些只接受连接器 URL 的 AI 应用（Claude Desktop、claude.ai 自定义连接器）：无需安装，也无需本地 ffmpeg。

与本地服务器不同，这个端点运行在 Squish 托管的基础设施上：视频会被获取 **自公开 URL** 由该端点完成——不会从你的机器上传任何内容——而工作表则通过短时有效的 capability URL 提供。参见 [隐私与数据流](/squish/zh/primitive/privacy-and-data-flow.md) 了解完整拆分。

## 设置（Claude Desktop / claude.ai）

1. 设置 → 连接器 → **添加自定义连接器**
2. 名称： `Squish`
3. URL： `https://api.getsquish.app/mcp` — 无需密钥；消费者连接器对话框使用匿名免费通道（其高级设置仅支持 OAuth）。在 Claude Team/Enterprise 中，组织管理员在添加连接器时可以把 API key 作为固定请求头附加上去（Anthropic 的 `static_headers` beta）——这会为整个组织解锁下面的密钥通道。
4. 在聊天中：在连接器下启用 Squish，然后询问任意公开视频 URL

## 该工具

同一个单一工具， `squish_video`，带有远程端——其自身的契约字符串， `squish-mcp-http-v0`:

| 参数              | 与……的区别 [本地服务器](/squish/zh/can-kao/mcp.md#parameters)                                |
| --------------- | ----------------------------------------------------------------------------------- |
| `video_url`     | 替代 `video_path`：一个公开的 http(s) URL，指向一个 **直接视频文件** （不是 YouTube/流媒体页面）。私有和内部地址会被拒绝。   |
| `density`       | 相同。                                                                                 |
| `start` / `end` | 相同—— [导航循环](/squish/zh/primitive/the-navigation-loop.md) 可在官方应用中使用，所有层级的时间码都是绝对时间码。 |
| `out_dir`       | 不可用——输出位置由服务器管理。                                                                    |

成功时，结果是一个 JSON 文本块——其结构与本地结果一致，并包含 `files[]` 作为 **约 24 小时有效的 capability URL**，以及 `sheet_ttl_hours` 和 `job_id` ——并将第一张工作表作为内联 MCP 图像块附加。

## 内联缩略图始终会随结果一起发送

官方应用会限制工具结果的总大小，而官方应用内的模型通常 **无法自行获取这些 capability URL** ——内联图像是模型唯一的“眼睛”。因此，该端点会不断降低第一张工作表的质量/尺寸并重新编码，直到满足预算（约 90 KB）：简单内容会清晰呈现；高细节内容则会以更小的缩略图形式返回，并附带警告，提示模型从 `timecodes[][]` （单元格按从左到右、从上到下排列——JSON 和像素永远不会不一致）。后续的放大调用会缩小窗口，从而提高缩略图的有效分辨率——这个循环会自我修复。

## 传输形态

无状态且仅支持 POST： `GET`/`DELETE` answer `405` （对一个不打开任何流的服务器来说符合规范），响应是纯 JSON，而且不会发出任何 `Mcp-Session-Id` 。不会发放任何会话 ID。会验证 Host 和 Origin 请求头。

## 身份验证与配额

该端点有两种通道：

* **密钥通道** ——发送 `Authorization: Bearer sq_live_…` ，使用与 [HTTP API](/squish/zh/can-kao/http-api.md) 相同的 API key，创建于 [getsquish.app/api-keys](https://getsquish.app/api-keys) （可在同一页面撤销/轮换：创建新密钥，撤销旧密钥）。需要能够发送该请求头的客户端——Claude Code（`claude mcp add --transport http squish https://api.getsquish.app/mcp --header "Authorization: Bearer sq_live_…"`), `mcp-remote`、任何 SDK 客户端，或由 Team/Enterprise 组织管理员将密钥作为请求头附加的官方应用连接器（`static_headers`，beta）；消费者连接器对话框仅支持 OAuth。任务按相同的 [按密度加权的 credits](/squish/zh/can-kao/http-api.md#credits-and-pricing) 作为 `POST /v1/squish` ——在提取前扣费， **自动退款** 如果引擎失败——并且每个任务都会显示在以下页面的用量表中 `/api-keys`。成功结果会包含 `credits_charged` 和 `credits_remaining`.
* **匿名** ——完全不带任何请求头。一个小型免费通道：按 UTC 日每天几个任务（当前为 3 个），当客户端发送 Apps-SDK 时按用户计数 `_meta["openai/subject"]` id（官方 AI 应用通过共享出口 IP 访问该端点），否则按每个 IP 计数，且受整个端点共享的每日上限约束。成功结果会包含 `free_jobs_remaining_today`。当该通道用尽时，工具会返回一个 **结构化 JSON 错误** ，模型可以直接转述。在大多数通道上，它会包含 `billing_url` 以及提示——申请一个免费密钥（每天 7 个免费 credits，无需信用卡）或在本地运行 Squish。 **Apps-SDK（ChatGPT 应用）流量则会收到非商业版本** ——请等待 UTC 00:00 重置，或在本地运行 Squish——因为 OpenAI 的应用指南禁止在 ChatGPT 应用内推销数字 credits（包括 freemium 方案）。

一个存在但无效的 `Authorization` 请求头会被如实视为 `401` （绝不会静默降级到免费通道）。请求洪泛会返回 `429` 并带有 `Retry-After` 请求头。

## Beta 限制

滥用会受到上述通道以及一次只处理一个视频的门控限制（繁忙时会返回礼貌的重试消息，而不会卡住）。获取的视频遵循托管端限制（300 MB / 30 分钟），并会在任务结束后删除；工作表会在约 24 小时后过期。

## 何时优先使用

* 客户端是只接受连接器 URL 的官方 AI 应用 → 使用这个端点。
* 代理拥有 shell 或文件系统（Claude Code、Cursor、Hermes，或任何 stdio 客户端）→ 使用 [本地 MCP 服务器](/squish/zh/can-kao/mcp.md)：在设备上运行，免费，无需上传，无限制。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://getsquish.gitbook.io/squish/zh/can-kao/remote-mcp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.