MCP 接入

通过 Model Context Protocol 把 Claude、ChatGPT、Cursor、OpenAI Agent Builder 接入 SubDownload。

概览

Model Context Protocol（MCP） 是一套让 AI 助手直接调用外部工具的标准化框架。SubDownload 的 MCP 服务器暴露 12 个工具 —— 含异步 AI 转写和按用户的 Library —— 支持 OAuth 2.1 + 动态客户端注册（DCR），也支持静态 API Key。

服务器配置

项	值
服务器地址	https://api.subdownload.com/mcp
鉴权元数据	/.well-known/oauth-authorization-server
动态注册	POST /oauth/register
授权	GET /oauth/authorize
Token	POST /oauth/token
Scope	mcp:access
Token 前缀	oat_（OAuth）或 sk_live_（API Key）

客户端接入

按客户端查看分步指南：

• → Claude（Desktop / Code） —— 走 OAuth + DCR，无需预先创建凭证
• → ChatGPT —— 静态 OAuth 客户端（Client ID / Secret）
• → OpenAI Agent Builder —— API Key 鉴权

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	free	轮询 ASR 任务；status=done 时返回 segments（参数：task_id）。
list_library	free	列出用户保存的转写和总结（参数：favorite、q、limit、offset）。
get_library_item	free	读取单个 Library 条目并内联 transcript 与 summary（参数：id、locale）。
save_to_library	计 1 个 token quota	kind=asr 标记转写已保存；kind=summary 上传 AI 生成的总结（参数：video_id、kind、text、locale、model 等）。

错误处理

调用失败不扣除积分。错误返回的是人类可读的提示，AI 助手能自然理解。完整列表见 错误码。