> 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/th/reference/remote-mcp.md).

# ปลายทาง MCP ระยะไกล

`https://api.getsquish.app/mcp` — เครื่องยนต์เดียวกับ [MCP server](/squish/th/reference/mcp.md)ที่สื่อสารผ่าน MCP อย่างเป็นทางการ **HTTP แบบสตรีมได้** เป็นช่องทางรับส่งข้อมูล เหมาะสำหรับแอป AI ที่รับแค่ URL ตัวเชื่อมต่อ (Claude Desktop, ตัวเชื่อมต่อแบบกำหนดเองของ claude.ai): ไม่ต้องติดตั้ง ไม่ต้องมี ffmpeg ในเครื่อง

ต่างจากเซิร์ฟเวอร์ในเครื่อง จุดปลายทางนี้ทำงานบนโครงสร้างพื้นฐานที่โฮสต์โดย Squish: วิดีโอจะถูกดึง **จาก URL สาธารณะ** โดยจุดปลายทาง — ไม่มีอะไรอัปโหลดจากเครื่องของคุณ — และชีตจะถูกให้บริการจาก URL ความสามารถที่มีอายุสั้น ดู [ความเป็นส่วนตัวและการไหลของข้อมูล](/squish/th/the-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 เป็นหัวข้อคำขอแบบคงที่ตอนเพิ่มตัวเชื่อมต่อได้ (beta ของ `static_headers` ) — ซึ่งจะปลดล็อกช่องทางที่ใช้คีย์ด้านล่างให้ทั้งองค์กร
4. ในแชต: เปิดใช้ Squish ภายใต้ตัวเชื่อมต่อ แล้วถามเกี่ยวกับ URL วิดีโอสาธารณะใดก็ได้

## เครื่องมือ

เครื่องมือเดี่ยวตัวเดิม `squish_video`พร้อมปลายทางระยะไกล — สตริงสัญญาสำหรับมันเอง, `squish-mcp-http-v0`:

| พารามิเตอร์     | ความแตกต่างจาก [เซิร์ฟเวอร์ในเครื่อง](/squish/th/reference/mcp.md#parameters)                                                                |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `video_url`     | แทนที่ `video_path`: URL http(s) สาธารณะของ **ไฟล์วิดีโอโดยตรง** (ไม่ใช่หน้า YouTube/หน้าเล่นสตรีม) ที่อยู่ส่วนตัวและที่อยู่ภายในจะถูกปฏิเสธ |
| `density`       | เหมือนกัน                                                                                                                                    |
| `start` / `end` | เหมือนกัน — [ลูปการนำทาง](/squish/th/the-primitive/the-navigation-loop.md) ใช้ได้จากแอปอย่างเป็นทางการ, รหัสเวลาจะเป็นแบบสัมบูรณ์ทุกระดับ    |
| `out_dir`       | ไม่มีให้ใช้ — เซิร์ฟเวอร์เป็นผู้กำหนดตำแหน่งผลลัพธ์                                                                                          |

เมื่อสำเร็จ ผลลัพธ์จะเป็นบล็อกข้อความ JSON หนึ่งชุด — รูปแบบผลลัพธ์แบบท้องถิ่นที่มี `files[]` ในรูปแบบ **URL ความสามารถอายุประมาณ 24 ชั่วโมง**พร้อมกับ `sheet_ttl_hours` และ `job_id` — และชีตแรกถูกแนบเป็นบล็อกภาพ MCP แบบอินไลน์

## ภาพตัวอย่างแบบอินไลน์จะถูกส่งมาพร้อม

แอปอย่างเป็นทางการจำกัดขนาดรวมของผลลัพธ์จากเครื่องมือ และโมเดลภายในแอปอย่างเป็นทางการโดยทั่วไป **ไม่สามารถดึง URL ความสามารถเหล่านั้นได้เอง** — ภาพแบบอินไลน์จึงเป็นตาเพียงคู่เดียวของโมเดล ดังนั้นจุดปลายทางจะเข้ารหัสชีตแรกใหม่โดยลดระดับคุณภาพ/ขนาดลงเรื่อย ๆ จนกว่าจะพอดีกับงบประมาณ (\~90 KB): เนื้อหาที่ง่ายจะออกมาคมชัด; เนื้อหาที่มีรายละเอียดสูงจะออกมาเป็นภาพย่อขนาดเล็กลงพร้อมคำเตือนให้โมเดลอ่านป้ายกำกับที่แน่นอนจาก `timecodes[][]` (เซลล์ไล่จากซ้าย→ขวา บน→ล่าง — JSON และพิกเซลจะไม่ขัดกัน) การเรียกต่อแบบซูมเข้าไปจะทำให้ช่วงภาพแคบลง ซึ่งเพิ่มความละเอียดที่แท้จริงของภาพย่อ — วนลูปแล้วจะซ่อมตัวเองได้

## รูปแบบการส่งผ่าน

ไม่มีสถานะ และใช้ได้เฉพาะ POST: `GET`/`DELETE` ตอบกลับ `405` (เป็นไปตามสเปกสำหรับเซิร์ฟเวอร์ที่ไม่เปิดสตรีมใด ๆ), คำตอบเป็น JSON ธรรมดา และจะไม่ออก `Mcp-Session-Id` เลย ตรวจสอบหัวข้อ Host และ Origin

## การยืนยันตัวตนและโควตา

จุดปลายทางมี 2 ช่องทาง:

* **แบบใช้คีย์** — ส่ง `Authorization: Bearer sq_live_…` พร้อม API key เดียวกับที่ [HTTP API](/squish/th/reference/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 ใด ๆ หรือ ตัวเชื่อมต่อในแอปอย่างเป็นทางการที่ผู้ดูแลองค์กร Claude Team/Enterprise แนบคีย์เป็นหัวข้อคำขอไว้ (`static_headers`, beta); กล่องโต้ตอบตัวเชื่อมต่อสำหรับผู้ใช้ทั่วไปเป็นแบบ OAuth เท่านั้น งานถูกคิดราคาใน [เครดิตที่ถ่วงน้ำหนักตามความหนาแน่น](/squish/th/reference/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 เครดิตฟรี/วัน ไม่ต้องใช้บัตร) หรือรัน Squish ในเครื่อง **ทราฟฟิกของ Apps-SDK (แอป ChatGPT) จะได้ยินเวอร์ชันที่ไม่ใช่เชิงพาณิชย์แทน** — รอรีเซ็ตเวลา 00:00 UTC หรือรัน Squish ในเครื่อง — เพราะแนวทางแอปของ OpenAI ห้ามการเสนอขายเครดิตดิจิทัลเพื่ออัปเซลล์ (รวมถึงแบบฟรีเมียม) ภายในแอป ChatGPT

Authorization `ที่มีอยู่แต่ไม่ถูกต้อง` หัวข้อเป็น `401` (ไม่เคยลดระดับเงียบ ๆ ไปยังช่องทางฟรี) คำขอที่ถาโถมจะตอบกลับ `429` พร้อมหัวข้อ `Retry-After` .

## ขีดจำกัดเบตา

การใช้งานในทางที่ผิดจะถูกจำกัดด้วยช่องทางด้านบน และมีกลไกให้ประมวลผลวิดีโอได้ครั้งละหนึ่งไฟล์ (ถ้าเรียกขณะยุ่ง ระบบจะตอบข้อความให้ลองใหม่อย่างสุภาพ ไม่ค้าง) วิดีโอที่ดึงมาจะอยู่ภายใต้ข้อจำกัดของระบบที่โฮสต์ไว้ (300 MB / 30 นาที) และจะถูกลบเมื่อจบงาน; ชีตจะหมดอายุหลังจากประมาณ 24 ชั่วโมง

## เมื่อควรเลือกใช้

* ไคลเอนต์เป็นแอป AI อย่างเป็นทางการที่รับแค่ URL ของตัวเชื่อมต่อ → ใช้จุดปลายทางนี้
* เอเจนต์มีเชลล์หรือไฟล์ระบบ (Claude Code, Cursor, Hermes, ไคลเอนต์ stdio ใด ๆ) → [เซิร์ฟเวอร์ MCP ในเครื่อง](/squish/th/reference/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/th/reference/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.