Transcrire une vidéo avec Cursor et MCP
Ajoutez l’URL du serveur et votre clé API dans .cursor/mcp.json. Pour VS Code, utilisez .vscode/mcp.json avec sa propre structure. Les instructions MCP proposent aussi une installation en un clic pour chaque client.
Votre client doit prendre en charge les serveurs MCP distants et envoyer l’en-tête Authorization à chaque appel. Copiez la configuration prévue pour votre application : renommer le fichier Cursor ne suffit pas pour le rendre compatible avec VS Code.
Commencez par demander get_account ou list_transcriptions. Vous vérifiez ainsi la connexion sans créer de transcription payante. Si les outils n’apparaissent pas, vérifiez que le client a chargé la configuration et activé le serveur. Si l’accès est refusé, vérifiez la clé dans ses réglages.
{
"mcpServers": {
"transcript1": {
"url": "https://api.transcript1.com/mcp",
"headers": {
"Authorization": "Bearer t1_YOURKEY"
}
}
}
}Configurer Claude Code, Claude ou ChatGPT
Dans Claude Code, lancez claude mcp add avec l’endpoint et votre clé API. Dans Claude ou ChatGPT, ajoutez un connecteur personnalisé avec la même URL, puis connectez votre compte. Suivez les étapes propres à votre client.
Les connecteurs Claude et ChatGPT utilisent OAuth. Leur disponibilité dépend de votre offre chez l’assistant et des réglages de l’espace de travail. La configuration par clé API d’un éditeur de code est un autre parcours : choisissez les instructions de l’application que vous utilisez.
Une fois connecté, donnez un lien public et une consigne précise. Demandez par exemple la transcription d’un Reel Instagram, puis les étapes expliquées à l’oral. transcript1 fournit les paroles : il ne montre pas à l’assistant ce qui se passe à l’image.
claude mcp add --transport http transcript1 https://api.transcript1.com/mcp --header "Authorization: Bearer t1_YOURKEY"Demandez le texte, puis les passages utiles
L’assistant appelle transcribe et lit la première page. Si le traitement continue, il reçoit un ID à consulter avec get_transcription. La référence des outils détaille les paramètres ; le guide pour agents IA explique comment enchaîner les appels.
Par défaut, l’assistant reçoit du texte horodaté. Si la transcription continue sur une autre page, il récupère next_from_seconds et le passe comme from_seconds à l’appel suivant. Il doit lire tous les passages utiles avant de résumer l’enregistrement, sans présenter la première page comme le texte complet.
Pour un lien complet, une transcription correspondante des dernières 24 heures peut être réutilisée. Un lien court ne permet pas ce rapprochement au moment de l’envoi. Dans tous les cas, un ID connu se relit avec get_transcription. Dans l’exemple, remplacez le lien fictif par celui d’une vraie vidéo TikTok publique.
transcribe(url="[public TikTok video URL]")
get_transcription(id="tr_8fK2Lm0PqRsTuVwXyZaBcD", format="srt")Votre assistant peut-il envoyer un fichier local ?
Les outils MCP échangent des paramètres et du texte, pas les octets de l’enregistrement. create_upload réserve l’import et renvoie son découpage. L’agent doit ensuite lire le fichier, envoyer les parties par HTTP en dehors de MCP, puis appeler complete_upload. Le guide des fichiers précise cette séparation.
Certains assistants savent appeler un serveur MCP distant, mais pas lire un fichier local ou envoyer des données binaires. Dans ce cas, importez l’enregistrement dans le tableau de bord et donnez-leur l’ID de la transcription terminée. Écrire un chemin de fichier dans le chat ne transmet pas son contenu.
Les webhooks sont réservés à l’API REST. Pour une conversation, l’assistant peut attendre un peu, puis consulter get_transcription. Si la connexion coupe, retrouvez le traitement par son ID ou dans les transcriptions récentes : la coupure ne prouve pas que la création a échoué.
La même connexion sert pour une vidéo Bluesky ou un script TikTok. Les règles d’accès restent les mêmes : la publication doit être publique. L’assistant travaille à partir des paroles, pas d’images qu’il n’a pas vues.