MCP 連携

Model Context Protocol で Claude・ChatGPT・Cursor・OpenAI Agent Builder を SubDownload に接続。

概要

Model Context Protocol（MCP） は、AI アシスタントが外部ツールを直接呼び出すための標準化フレームワークです。SubDownload の MCP サーバーは 12 のツールを公開し（非同期 AI 文字起こしとユーザー別 Library を含む）、OAuth 2.1 + Dynamic Client Registration（DCR）と静的 API キーの両方に対応しています。

サーバー構成

項目	値
サーバー URL	https://api.subdownload.com/mcp
認証メタデータ	/.well-known/oauth-authorization-server
動的登録	POST /oauth/register
認可	GET /oauth/authorize
トークン	POST /oauth/token
Scope	mcp:access
トークン接頭辞	oat_（OAuth）または sk_live_（API キー）

クライアント設定

クライアント別のステップガイド：

• → Claude（Desktop / Code） —— OAuth + DCR、事前クレデンシャル不要
• → ChatGPT —— 静的 OAuth クライアント（Client ID / Secret）
• → OpenAI Agent Builder —— API キー認証

MCP ツール

ツール	費用	目的
fetch_transcript	1 クレジット	URL/ID から文字起こしを取得（パラメータ：video_url、lang）。
search_youtube	1 クレジット	動画またはチャンネルを検索（パラメータ：query、type、limit）。
resolve_channel	無料	@handle / URL / UC… ID をチャンネル情報に解決（パラメータ：input）。
search_channel_videos	1 クレジット	指定チャンネル内で動画検索（パラメータ：channel、query、limit）。
get_channel_latest_videos	無料	RSS 経由で最新 ~15 本（パラメータ：channel）。
list_channel_videos	1 クレジット/ページ	アップロードのページネーション（パラメータ：channel または continuation）。
list_playlist_videos	1 クレジット/ページ	プレイリストのページネーション（パラメータ：playlist または continuation）。
transcribe_video	done 時 5 クレジット	字幕のない動画に対する非同期 AI Whisper 文字起こしを開始。task_id と next_poll_after_seconds を返す（パラメータ：video_url、lang）。
get_asr_task	無料	ASR タスクをポーリング；status=done のとき segments を返す（パラメータ：task_id）。
list_library	無料	ユーザーが保存した文字起こしと要約を一覧（パラメータ：favorite、q、limit、offset）。
get_library_item	無料	保存済み項目を transcript と summary 内包で取得（パラメータ：id、locale）。
save_to_library	1 トークンクォータ	kind=asr で文字起こし保存済みをマーク；kind=summary で AI 生成の要約をアップロード（パラメータ：video_id、kind、text、locale、model ほか）。

エラー処理

失敗した呼び出しではクレジットを消費しません。エラーは AI アシスタントが自然に解釈できる文言で返ります。全一覧は エラーコード を参照。