Intégration MCP

Connectez Claude, ChatGPT, Cursor et OpenAI Agent Builder à SubDownload via Model Context Protocol.

Vue d'ensemble

Model Context Protocol (MCP) est un protocole standard qui permet aux assistants IA d'appeler directement des outils externes. Le serveur MCP de SubDownload expose 12 outils — incluant la transcription IA asynchrone et une Library par utilisateur — et prend en charge OAuth 2.1 avec Dynamic Client Registration (DCR), ainsi que les clés API statiques.

Configuration du serveur

Propriété	Valeur
URL du serveur	https://api.subdownload.com/mcp
Métadonnées d'auth	/.well-known/oauth-authorization-server
Enregistrement dynamique	POST /oauth/register
Autorisation	GET /oauth/authorize
Token	POST /oauth/token
Scope	mcp:access
Préfixe de token	oat_ (OAuth) ou sk_live_ (clé API)

Configuration client

Voir les guides détaillés :

• → Claude (Desktop / Code) — OAuth avec DCR, sans identifiants pré-créés
• → ChatGPT — client OAuth statique (Client ID / Secret)
• → OpenAI Agent Builder — authentification par clé API

Outils MCP

Outil	Coût	Rôle
fetch_transcript	1 crédit	Récupérer la transcription par URL/ID (params : video_url, lang).
search_youtube	1 crédit	Rechercher des vidéos ou chaînes (params : query, type, limit).
resolve_channel	gratuit	Résoudre @handle / URL / UC… ID en infos de chaîne (param : input).
search_channel_videos	1 crédit	Rechercher dans une chaîne (params : channel, query, limit).
get_channel_latest_videos	gratuit	~15 dernières vidéos via RSS (param : channel).
list_channel_videos	1 crédit/page	Uploads paginés (params : channel ou continuation).
list_playlist_videos	1 crédit/page	Playlist paginée (params : playlist ou continuation).
transcribe_video	5 crédits à done	Démarre une transcription IA Whisper asynchrone pour vidéos sans sous-titres. Renvoie task_id + next_poll_after_seconds (params : video_url, lang).
get_asr_task	gratuit	Interroge une tâche ASR ; renvoie les segments à status=done (param : task_id).
list_library	gratuit	Liste les transcripts et résumés enregistrés de l'utilisateur (params : favorite, q, limit, offset).
get_library_item	gratuit	Lit un élément enregistré avec transcript + résumé en ligne (params : id, locale).
save_to_library	1 quota token	kind=asr marque un transcript enregistré ; kind=summary téléverse le résumé généré par l'IA (params : video_id, kind, text, locale, model…).

Gestion des erreurs

Les appels qui échouent ne consomment jamais de crédits. Les erreurs renvoient des messages lisibles que les assistants IA peuvent interpréter naturellement. Liste complète sur Codes d'erreur.