> 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/ja/rifarensu/remote-mcp.md).

# リモート MCP エンドポイント

`https://api.getsquish.app/mcp` — 同じエンジンです。 [MCP サーバー](/squish/ja/rifarensu/mcp.md)、公式MCP **Streamable HTTP** トランスポート上で提供されます。これは、コネクタURLだけを受け取るAIアプリ（Claude Desktop、claude.aiのカスタムコネクタ）向けです。インストール不要、ローカルのffmpegも不要です。

ローカルサーバーとは異なり、このエンドポイントはSquishのホストインフラ上で動作します。動画は **公開URLから** エンドポイントによって取得されます。お使いのマシンから何もアップロードされることはありません。シートは短命の capability URL で提供されます。完全な分岐については [プライバシーとデータフロー](/squish/ja/purimitibu/privacy-and-data-flow.md) をご覧ください。

## セットアップ（Claude Desktop / claude.ai）

1. 設定 → コネクタ → **カスタムコネクタを追加**
2. 名前: `Squish`
3. URL: `https://api.getsquish.app/mcp` — キーは不要です。コンシューマー向けコネクタのダイアログは匿名の無料レーンを利用します（詳細設定はOAuthのみ対応です）。Claude Team/Enterpriseでは、組織管理者がコネクタ追加時にAPIキーを固定リクエストヘッダーとして付与できます（Anthropicの `static_headers` ベータ）。これにより、以下のキー付きレーンが組織全体で有効になります。
4. チャットでは、コネクタでSquishを有効にしてから、任意の公開動画URLについて質問してください

## ツール

同じ単一ツールを `squish_video`、リモート側で使うものです。独自の契約文字列で、 `squish-mcp-http-v0`:

| パラメータ           | ローカルサーバーとの違い [ローカルサーバー](/squish/ja/rifarensu/mcp.md#parameters)                                     |
| --------------- | --------------------------------------------------------------------------------------------------- |
| `video_url`     | 置き換え `video_path`： **直接動画ファイルの** 公開http(s) URLです（YouTube/ストリーミングページではありません）。プライベートおよび内部アドレスは拒否されます。 |
| `density`       | 同一です。                                                                                               |
| `start` / `end` | 同一です。 [ナビゲーションループ](/squish/ja/purimitibu/the-navigation-loop.md) 公式アプリで動作し、タイムコードは深さに関係なく常に絶対値です。   |
| `out_dir`       | 使用できません。出力先はサーバー側で管理されます。                                                                           |

成功時の結果は1つのJSONテキストブロックです。ローカル結果の形に `files[]` として **約24時間の capability URL**に加えて、 `sheet_ttl_hours` と `job_id` 、そして最初のシートがインラインMCP画像ブロックとして添付されます。

## インラインのサムネイルには常に

公式アプリではツール結果の合計サイズに上限があり、公式アプリ内のモデルは通常 **その capability URL を自分で取得できません** 。したがって、インライン画像がモデルの唯一の視覚情報になります。そのため、このエンドポイントは最初のシートを、予算（約90KB）に収まるまで品質/サイズの段階に沿って再エンコードします。単純な内容は鮮明に届き、詳細な内容は小さなサムネイルとして届くうえ、モデルに対して `timecodes[][]` 正確なラベルはそこから読むよう促す警告が付与されます（セルは左→右、上→下に並び、JSONとピクセルは決して食い違いません）。ズームした再取得呼び出しで表示範囲を狭めると、サムネイルの実効解像度が上がります。これにより、ループは自己修復します。

## トランスポートの形

ステートレスかつPOSTのみです。 `GET`/`DELETE` 応答 `405` （ストリームを開かないサーバーとして仕様準拠です）。応答はプレーンJSONで、 `Mcp-Session-Id` は一切発行されません。HostヘッダーとOriginヘッダーは検証されます。

## 認証とクォータ

このエンドポイントには2つのレーンがあります。

* **キー付き** — 次を送信します `Authorization: Bearer sq_live_…` 同じAPIキーを使います。 [HTTP API](/squish/ja/rifarensu/http-api.md) が使用するもので、 [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`、ベータ）です。コンシューマー向けコネクタのダイアログはOAuthのみ対応です。ジョブは同じ [密度加重クレジット](/squish/ja/rifarensu/http-api.md#credits-and-pricing) として `POST /v1/squish` で課金されます。これは抽出前に差し引かれ、 **失敗時は自動返金されます。** そして各ジョブは `/api-keys`の利用状況テーブルに表示されます。成功した結果には `credits_charged` と `credits_remaining`.
* **匿名** — ヘッダーは一切ありません。小さな無料レーンです。UTC日あたり数件のジョブ（現在は3件）までで、クライアントがApps-SDKの `_meta["openai/subject"]` IDを送信した場合はユーザー単位、それ以外ではIP単位でカウントされ、共有のエンドポイント全体の日次上限の下で運用されます。成功した結果には `free_jobs_remaining_today`が付与されます。レーンが使い切られると、ツールは **構造化 JSON エラー** モデルがそのまま伝えられるものを返します。ほとんどのレーンでは `billing_url` とヒントが含まれます。無料キー（1日7クレジット、カード不要）を発行するか、Squishをローカルで実行してください。 **Apps-SDK（ChatGPTアプリ）のトラフィックには、代わりに非商用版が返されます** 。00:00 UTCのリセットを待つか、Squishをローカルで実行してください。OpenAIのアプリガイドラインでは、ChatGPTアプリ内でデジタルクレジットのアップセル（フリーミアムを含む）が禁止されているためです。

存在するが無効な `Authorization` ヘッダーは、正直な `401` です（無料レーンへ黙って降格することはありません）。リクエストの洪水には `429` 付きで `Retry-After` ヘッダーが返されます。

## ベータの制限

悪用は、上記の各レーンに加えて「一度に1本の動画のみ」ゲートで抑制されます（処理中の呼び出しには、丁寧な再試行メッセージが返り、ハングはしません）。取得した動画はホスト側の上限（300 MB / 30分）に従い、ジョブ終了時に削除されます。シートは約24時間で期限切れになります。

## これを優先する場面

* クライアントがコネクタURLのみ受け付ける公式AIアプリである → このエンドポイントです。
* エージェントがシェルまたはファイルシステムを持つ（Claude Code、Cursor、Hermes、任意のstdioクライアント） → [ローカルMCPサーバー](/squish/ja/rifarensu/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/ja/rifarensu/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.