Zur MCP-Referenz

MCP-Dokumentation

Ihre Transkripte im KI-Assistenten.

Client verbindenTools ansehen
Auf dieser Seite

Taption MCP

Verbinden Sie Taption mit einem MCP-Client, um Audio und Video zu transkribieren und zu übersetzen, fertige Transkripte und Übersetzungen zu lesen und letzte Arbeiten direkt im Gespräch abzurufen.

Über das Model Context Protocol (MCP) nutzt Ihr Assistent Taption-Tools in Ihrem Auftrag. Diese benutzerdefinierte Verbindung unterstützt das Lesen von Transkripten sowie neue Transkriptions- und Übersetzungsaufträge.

Streamable HTTPOAuth 2.1

Server-URL

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

Verwenden Sie diese vollständige URL, um Taption als entfernten MCP-Server hinzuzufügen.

Transport
Streamable HTTP
Authentifizierung
OAuth 2.1

Voraussetzungen

  • Ein Taption-Konto, ohne erforderliches Bezahlabo. Bei Anmeldung mit E-Mail und Passwort müssen Sie vor dem Verbinden Ihre E-Mail-Adresse bestätigen.
  • Verfügbare Minuten für neue Transkriptions- und Übersetzungsaufträge. Die Grenzen Ihres Kontos und Tarifs gelten weiterhin.
  • Ein Client mit Unterstützung für entferntes Streamable HTTP und OAuth. Client-Tarife und Organisationsrichtlinien können den Zugriff einschränken.

Unterstützte Medienquellen

Nutzen Sie direkte Audio- oder Video-URLs, öffentliche Google-Drive-Dateien oder YouTube-Videos. Der benutzerdefinierte Endpunkt akzeptiert auch öffentliche Beiträge von Facebook, Instagram, TikTok, X, Threads, Vimeo, Dailymotion, Bilibili (bilibili.tv) sowie Twitch-Videos und -Clips.

ChatGPT kann hochgeladene Audio- oder Videodateien bereitstellen, wenn seine Dateiintegration verfügbar ist. Andere Clients können eine herunterladbare Medien-URL nutzen.

Taption muss auf den Link zugreifen können. Livestreams werden nicht unterstützt; verwenden Sie die fertige Aufzeichnung.

Client einrichten

Wählen Sie Ihre Anwendung für eine vollständige Schritt-für-Schritt-Anleitung.

Authentifizierung

Taption nutzt OAuth 2.1 mit PKCE. Melden Sie sich an und genehmigen Sie die Verbindung. Der Client verwaltet die Autorisierung und erneuert das eine Stunde gültige Zugriffstoken automatisch.

MCP nutzt OAuth-Zugriffstokens. Taption-REST-API-Schlüssel können diese Verbindung nicht authentifizieren.

Verwenden Sie durchgehend /mcp-custom. Ein für /mcp ausgestelltes Token funktioniert nicht unter /mcp-custom.

Widerrufen Sie den Zugriff in Taption unter Konto → Verbundene Apps, indem Sie den Client trennen. Für erneuten Zugriff verbinden und autorisieren Sie ihn wieder.

Berechtigungen

transcripts:read
Status und Inhalt von Transkripten lesen sowie aktuelle Transkripte auflisten.
transcripts:write
Transkriptions- und Übersetzungsaufträge mit den Minuten Ihres Kontos erstellen.

Unterstützte Abläufe

Geben Sie dem Assistenten das Medium und das gewünschte Ergebnis. Er führt diese Schritte mit Taption-Tools aus.

  1. Medium und Ausgabe wählen

    Geben Sie einen Link oder unterstützten Upload, die gesprochene Sprache und den Zweck an: Klartext, Sprecherkennzeichnung oder Untertitel. Fehlende Angaben werden vor dem Start erfragt.

  2. Transkribieren und Fortschritt prüfen

    transcribe liefert sofort eine ID. get_transcript wartet kurz auf einen Auftrag, der gleich fertig ist. Läuft er noch, fragen Sie nach etwa einer Minute erneut. Sind E-Mail-Benachrichtigungen in Taption aktiviert, erhalten Sie zusätzlich eine E-Mail, sobald er fertig ist.

  3. Lesen, zusammenfassen und exportieren

    Lesen Sie das fertige Transkript oder lassen Sie es zusammenfassen. Nutzen Sie verfügbare SRT-Download- und Editorlinks. Der Taption-Editor bietet weitere Exportformate.

Beispielanfragen

Transkribiere diese englische Aufnahme mit Kennzeichnung von zwei Sprechern: [your media URL].
Erstelle Untertitel für dieses japanische Video: [your media URL]. Verwende 16 Zeichen pro Zeile.
Transkribiere dieses englische Interview als Untertitel und übersetze es dann ins Japanische und Spanische: [your media URL].
Übersetze mein Transkript „Weekly sync“ ins traditionelle Chinesisch.
Finde meine aktuellen Taption-Transkripte und fasse das abgeschlossene Interview zusammen. Füge verfügbare Untertitel-Downloads und Editorlinks hinzu.

Ersetzen Sie [your media URL] durch Ihren Link. Zusammenfassungen erstellt der Assistent aus dem Transkript. Die Anpassung der Untertitellänge hängt vom Taption-Tarif ab.

transcribe

Erstellt einen Auftragtranscripts:write

Startet eine Hintergrundtranskription mit media_url oder file. Sprache und Zweck müssen vom Nutzer stammen. Fehlen diese, werden sie erfragt, ohne einen Auftrag zu starten. Mit translate_to wird das Transkript nach der Transkription automatisch übersetzt.

Parameter

media_urlstringEine Medienquelle

Unterstützter Medienlink mit maximal 2.048 Zeichen. Alternativ zu file angeben.

fileobjectEine Medienquelle

Client-Upload mit download_url und file_id; mime_type und file_name sind optional. Taption muss die URL herunterladen können.

languagestringZum Start benötigt

Gesprochene Sprache, z. B. en-US, zh-TW, ja-JP oder es-ES. Nutzer fragen, nicht aus Dateinamen oder Chatsprache ableiten.

Sprachcodes ansehen
purposestringZum Start benötigt

transcript: Text mit Satzzeichen; speakers: Sprecherkennzeichnung; captions: kurze Untertitelabschnitte. „Transkribieren“ allein wählt keinen Zweck.

transcriptspeakerscaptions
speaker_countinteger

Geschätzte Sprecherzahl für speakers: 2–10. Standard: 2.

max_charactersinteger

1–200 Zeichen pro Zeile für captions in berechtigten Bezahltarifen. Standard: 16 für zh/ja/ko/yue, sonst 65.

translate_tostring[]

Optional. 1–5 Sprachen, in die nach der Transkription übersetzt wird, etwa en, ja oder zh-TW. Jede nutzt zusätzlich Minuten in Länge der Mediendatei.

extensionstring

Dateiendung eines Uploads, falls nicht erkennbar. Für Links unnötig. Audio und unterstützte Videoformate werden akzeptiert, 3gp nicht.

namestring

Transkriptname, maximal 200 Zeichen. Standard ist der Quelldateiname.

Beispielargumente

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

Beispielwerte: Ersetzen Sie Medien-URL oder Transkript-ID durch Ihre eigenen.

Liefert ID und Status. Jede erfolgreiche Erstellung beginnt einen neuen Auftrag und nutzt Minuten, dazu für jede Sprache in translate_to Minuten in Länge der Mediendatei. Prüfen Sie den Fortschritt mit derselben ID, statt erneut einzureichen.

get_transcript

Nur lesentranscripts:read

Prüft den Fortschritt oder liest das Ergebnis als Text mit Zeitstempeln, SRT oder VTT. Mit language lesen Sie eine Übersetzung. Die erste Seite enthält verfügbare download_url und editing_url sowie die Übersetzungen des Transkripts und ihren Status.

Parameter

idstringErforderlich

ID aus transcribe oder list_transcripts: 1–128 Buchstaben, Ziffern, Unterstriche oder Bindestriche.

languagestring

Zu lesende Übersetzung als Sprachcode, etwa ja. Ohne Angabe wird das Originaltranskript gelesen.

formatstring

Ausgabeformat. Standard: text.

textsrtvtt
offsetinteger

Phrasenposition ab 0. Standard: 0. next_offset für die nächste Seite verwenden.

limitinteger

1–500 Phrasen pro Seite. Standard: 200.

Beispielargumente

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

Beispielwerte: Ersetzen Sie Medien-URL oder Transkript-ID durch Ihre eigenen.

Übergeben Sie next_offset als offset für die nächste Seite. Maximal 30.000 Zeichen pro Seite; über MCP sind die ersten 2.000 Phrasen lesbar. Der vollständige Text liegt in Taption. Ohne Sprache wird total_phrases: 0 zurückgegeben.

translate_transcript

Erstellt einen Auftragtranscripts:write

Übersetzt ein fertiges Transkript in bis zu fünf Sprachen. Nennen Sie ein Transkript beim Namen, sucht der Assistent es mit list_transcripts und fragt nach, wenn es nicht eindeutig passt. Die Zielsprachen müssen vom Nutzer stammen.

Parameter

idstringErforderlich

ID aus transcribe oder list_transcripts: 1–128 Buchstaben, Ziffern, Unterstriche oder Bindestriche.

target_languagesstring[]Erforderlich

1–5 Übersetzungs-Sprachcodes, etwa en, ja, es oder zh-TW. Ein Transkript kann nicht in seine eigene Sprache übersetzt werden.

overwriteboolean

Auf true setzen, um eine vorhandene Übersetzung samt Änderungen in Taption zu ersetzen. Nur nach Zustimmung des Nutzers.

Beispielargumente

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

Beispielwerte: Ersetzen Sie Medien-URL oder Transkript-ID durch Ihre eigenen.

Liefert die eingereihten Sprachen und die Minuten pro Sprache, entsprechend der Länge der Mediendatei. Eine vorhandene Übersetzung kann Ihre Änderungen enthalten und wird nur mit overwrite ersetzt, nachdem Sie zugestimmt haben. Lesen Sie das Ergebnis mit get_transcript und language.

list_transcripts

Nur lesentranscripts:read

Listet Transkripte nach letzter Änderung absteigend mit ID, Name, Status, Sprache, Übersetzungen und Änderungszeit. Mit query finden Sie ein Transkript über seinen Namen. Lesen Sie den Inhalt über get_transcript mit der ID.

Parameter

limitinteger

1–50 Transkripte. Standard: 10.

querystring

Teil eines Transkriptnamens, gesucht unter Ihren 100 neuesten Transkripten. Groß- und Kleinschreibung egal.

Beispielargumente

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

Beispielwerte: Ersetzen Sie Medien-URL oder Transkript-ID durch Ihre eigenen.

Ohne Aufnahmen wird ein leeres transcripts-Array geliefert. Es gibt eine Ergebnisgrenze, aber keine Seitennavigation.

Fehlerbehebung

Verbindungs- oder Berechtigungsfehler

Verbinden Sie sich erneut über OAuth und erlauben Sie die Rechte. Prüfen Sie, ob die URL mit /mcp-custom endet.

Medium nicht herunterladbar

Prüfen Sie, ob Datei oder Beitrag öffentlich, unterstützt und kein Livestream ist. Aktivieren Sie für Google Drive den Linkzugriff.

Zu wenig Minuten oder zu viele Aufträge

Prüfen Sie Ihre Taption-Minuten. Bei Frequenz- oder Parallelitätsgrenzen warten Sie auf den Abschluss laufender Aufträge und beachten die angegebene Wartezeit.

Verarbeitung läuft oder ist fehlgeschlagen

Bei laufender Verarbeitung dieselbe ID etwa jede Minute prüfen. Bei Status error die Fehlermeldung lesen und die Ursache vor einem neuen Auftrag beheben.

Weitere Exportformate

Öffnen Sie das Transkript in Taption für TXT, PDF, SRT, VTT, Final Cut Pro XML, JSON oder Video mit eingebrannten Untertiteln. Es gibt kein separates MCP-Exporttool.

REST-API-Dokumentation lesen