Aller à la référence MCP

Documentation MCP

Vos transcriptions dans votre assistant IA.

Connecter votre clientDécouvrir les outils
Sur cette page

Taption MCP

Connectez Taption à un client MCP pour transcrire et traduire des médias, lire vos transcriptions et traductions, et consulter vos travaux récents depuis la conversation.

Le Model Context Protocol (MCP) permet à votre assistant d’utiliser les outils Taption en votre nom. Cette connexion personnalisée permet de lire des transcriptions et de lancer des transcriptions et des traductions.

Streamable HTTPOAuth 2.1

URL du serveur

https://api.taption.com/mcp-custom

Utilisez cette URL complète pour ajouter Taption comme serveur MCP distant.

Transport
Streamable HTTP
Authentification
OAuth 2.1

Prérequis

  • Un compte Taption, sans abonnement payant obligatoire. Si vous utilisez une adresse e-mail et un mot de passe, vérifiez votre adresse avant de vous connecter.
  • Des minutes disponibles pour créer des transcriptions et des traductions. Les limites de votre compte et de votre forfait s’appliquent.
  • Un client prenant en charge Streamable HTTP à distance et OAuth. Son forfait et les règles de votre organisation peuvent limiter l’accès.

Sources multimédias compatibles

Utilisez une URL directe audio ou vidéo, un fichier Google Drive public ou une vidéo YouTube. Ce serveur accepte aussi les publications publiques Facebook, Instagram, TikTok, X, Threads, Vimeo, Dailymotion, Bilibili (bilibili.tv), ainsi que les vidéos et clips Twitch.

ChatGPT peut fournir un fichier audio ou vidéo téléversé si son intégration de fichiers est disponible. Les autres clients peuvent utiliser une URL de téléchargement.

Taption doit pouvoir accéder au lien. Les directs ne sont pas pris en charge : utilisez l’enregistrement terminé.

Configurer votre client

Choisissez votre application pour consulter le guide de configuration étape par étape.

Authentification

Taption utilise OAuth 2.1 avec PKCE. Connectez-vous et approuvez la connexion. Le client gère l’autorisation et renouvelle automatiquement le jeton d’accès valable une heure.

MCP utilise des jetons OAuth. Les clés REST API Taption ne permettent pas cette authentification.

Utilisez /mcp-custom pendant toute la configuration. Un jeton émis pour /mcp ne fonctionne pas sur /mcp-custom.

Pour révoquer l’accès, ouvrez Compte → Applications connectées dans Taption et déconnectez le client. Reconnectez-vous et autorisez-le pour rétablir l’accès.

Autorisations de la connexion

transcripts:read
Lire l’état et le contenu des transcriptions, et afficher les plus récentes.
transcripts:write
Créer des transcriptions et des traductions avec les minutes de votre compte.

Flux de travail disponibles

Indiquez le média et le résultat souhaité. L’assistant utilise les outils Taption pour suivre ces étapes.

  1. Choisir le média et le résultat

    Fournissez un lien ou un fichier compatible, la langue parlée et l’usage : texte simple, identification des locuteurs ou sous-titres. L’assistant demande les choix manquants avant de commencer.

  2. Transcrire et suivre la progression

    transcribe renvoie immédiatement un ID. get_transcript attend brièvement une tâche sur le point de se terminer ; si le traitement continue, redemandez après environ une minute. Si les notifications par e-mail sont activées dans Taption, vous recevez aussi un e-mail à la fin.

  3. Lire, résumer et exporter

    Lisez le texte ou demandez à l’assistant de le résumer. Utilisez les liens de téléchargement SRT et d’édition disponibles. L’éditeur Taption propose d’autres formats d’export.

Exemples de demandes

Transcris cet enregistrement en anglais en identifiant les deux locuteurs : [your media URL].
Crée des sous-titres pour cette vidéo en japonais : [your media URL]. Utilise 16 caractères par ligne.
Transcris cet entretien en anglais sous forme de sous-titres, puis traduis-le en japonais et en espagnol : [your media URL].
Traduis ma transcription « Weekly sync » en chinois traditionnel.
Trouve mes transcriptions Taption récentes et résume l’entretien terminé. Ajoute les liens de téléchargement des sous-titres et d’édition disponibles.

Remplacez [your media URL] par votre lien. L’assistant produit le résumé à partir du texte. La personnalisation de la longueur des sous-titres dépend du forfait Taption.

transcribe

Crée une tâchetranscripts:write

Lance une transcription en arrière-plan avec media_url ou file. L’utilisateur doit choisir la langue parlée et l’usage. Sinon, l’outil demande ces informations sans lancer de tâche. Ajoutez translate_to pour traduire automatiquement la transcription une fois terminée.

Paramètres

media_urlstringUne source au choix

Lien multimédia compatible, 2 048 caractères maximum. À fournir à la place de file.

fileobjectUne source au choix

Fichier fourni par le client avec download_url et file_id ; mime_type et file_name sont facultatifs. L’URL doit être téléchargeable par Taption.

languagestringNécessaire au démarrage

Langue parlée, par exemple en-US, zh-TW, ja-JP ou es-ES. Demandez à l’utilisateur ; ne la déduisez pas du nom de fichier ou du chat.

Voir les codes de langue
purposestringNécessaire au démarrage

transcript : texte ponctué ; speakers : locuteurs identifiés ; captions : segments de sous-titres. Demander seulement de transcrire ne choisit pas l’usage.

transcriptspeakerscaptions
speaker_countinteger

Nombre estimé de locuteurs pour speakers : 2–10. Valeur par défaut : 2.

max_charactersinteger

1–200 caractères par ligne pour captions avec un forfait payant éligible. Par défaut : 16 pour zh/ja/ko/yue, 65 sinon.

translate_tostring[]

Facultatif. 1 à 5 langues vers lesquelles traduire une fois la transcription terminée, par exemple en, ja ou zh-TW. Chacune utilise en plus des minutes égales à la durée du média.

extensionstring

Extension du fichier téléversé si elle ne peut être détectée. Inutile pour les liens. Audio et formats vidéo compatibles acceptés ; 3gp exclu.

namestring

Nom de la transcription, 200 caractères maximum. Par défaut : nom du fichier source.

Exemple d’arguments

{
  "media_url": "https://example.com/interview.mp4",
  "language": "en-US",
  "purpose": "speakers",
  "speaker_count": 2,
  "translate_to": [
    "ja"
  ],
  "name": "Interview"
}

Valeurs illustratives : remplacez l’URL ou l’ID par les vôtres.

Renvoie l’ID et l’état. Chaque création réussie lance une nouvelle tâche et utilise des minutes, plus des minutes égales à la durée du média pour chaque langue de translate_to. Réutilisez l’ID pour suivre la progression au lieu de soumettre à nouveau.

get_transcript

Lecture seuletranscripts:read

Vérifie la progression ou lit le résultat en texte horodaté, SRT ou VTT. Indiquez language pour lire une traduction. La première page contient download_url et editing_url lorsqu’ils sont disponibles, ainsi que les traductions de la transcription et leur état.

Paramètres

idstringObligatoire

ID obtenu via transcribe ou list_transcripts : 1–128 lettres, chiffres, tirets ou traits de soulignement.

languagestring

Traduction à lire, par son code de langue, par exemple ja. Sans valeur, la transcription originale est lue.

formatstring

Format de sortie. Par défaut : text.

textsrtvtt
offsetinteger

Position de phrase à partir de 0. Par défaut : 0. Utilisez next_offset pour la suite.

limitinteger

1–500 phrases par page. Par défaut : 200.

Exemple d’arguments

{
  "id": "TRANSCRIPT_ID",
  "format": "text",
  "offset": 0,
  "limit": 200
}

Valeurs illustratives : remplacez l’URL ou l’ID par les vôtres.

Passez next_offset dans offset pour lire la suite. Maximum : 30 000 caractères par page et les 2 000 premières phrases via MCP. Le texte intégral est dans Taption. Un média terminé sans parole renvoie total_phrases: 0.

translate_transcript

Crée une tâchetranscripts:write

Traduit une transcription terminée dans jusqu’à cinq langues. Si vous désignez une transcription par son nom, l’assistant la cherche avec list_transcripts et vous demande de choisir si la correspondance n’est pas claire. Les langues cibles doivent venir de l’utilisateur.

Paramètres

idstringObligatoire

ID obtenu via transcribe ou list_transcripts : 1–128 lettres, chiffres, tirets ou traits de soulignement.

target_languagesstring[]Obligatoire

1 à 5 codes de langue de traduction, par exemple en, ja, es ou zh-TW. Une transcription ne peut pas être traduite dans sa propre langue.

overwriteboolean

true remplace une traduction existante, y compris les modifications faites dans Taption. Uniquement après l’accord de l’utilisateur.

Exemple d’arguments

{
  "id": "TRANSCRIPT_ID",
  "target_languages": [
    "ja",
    "es"
  ]
}

Valeurs illustratives : remplacez l’URL ou l’ID par les vôtres.

Renvoie les langues en file d’attente et les minutes utilisées par langue, égales à la durée du média. Une traduction existante peut contenir vos modifications : elle n’est remplacée qu’avec overwrite, après votre accord. Lisez le résultat avec get_transcript et language.

list_transcripts

Lecture seuletranscripts:read

Liste les transcriptions par modification décroissante avec ID, nom, état, langue, traductions et date. Indiquez query pour trouver une transcription par son nom. Utilisez un ID avec get_transcript pour lire le contenu.

Paramètres

limitinteger

1–50 transcriptions. Par défaut : 10.

querystring

Partie d’un nom de transcription à chercher parmi vos 100 transcriptions les plus récentes, sans tenir compte de la casse.

Exemple d’arguments

{
  "query": "weekly sync",
  "limit": 10
}

Valeurs illustratives : remplacez l’URL ou l’ID par les vôtres.

Renvoie un tableau transcripts vide sans enregistrement. Le nombre de résultats est limité, sans pagination.

Dépannage

Erreur de connexion ou d’autorisation

Reconnectez-vous avec OAuth et accordez les droits demandés. Vérifiez que l’URL se termine par /mcp-custom.

Média impossible à télécharger

Vérifiez que le fichier ou la publication est public, compatible et non diffusé en direct. Activez l’accès par lien pour Google Drive.

Minutes insuffisantes ou trop de tâches

Vérifiez vos minutes Taption. Si une limite de fréquence ou de concurrence est atteinte, attendez la fin des tâches et respectez le délai indiqué.

Traitement en cours ou échec

En cours : interrogez le même ID environ une fois par minute. Avec l’état error, lisez le message et corrigez la cause avant de recréer une tâche.

Autres formats d’export

Ouvrez la transcription dans Taption pour exporter en TXT, PDF, SRT, VTT, Final Cut Pro XML, JSON ou vidéo sous-titrée. Il n’existe pas d’outil MCP d’export distinct.

Lire la documentation REST API