Vanuit Cursor met MCP een video transcriberen
Zet het endpoint en je API-sleutel in .cursor/mcp.json. Voor VS Code gebruik je dezelfde URL in .vscode/mcp.json. In de MCP-documentatie vind je voor beide clients ook een installatie met één klik.
Je client moet externe MCP-servers via streamable HTTP ondersteunen en de Authorization-header meesturen. Cursor en VS Code gebruiken verschillende configuraties. Neem het voorbeeld voor jouw editor over; alleen de bestandsnaam veranderen is niet genoeg.
Laat de assistent eerst get_account of list_transcriptions aanroepen. Zo controleer je de verbinding zonder een betaalde transcriptie te starten. Ontbreken de tools, kijk dan of de client de configuratie heeft geladen en de server heeft ingeschakeld. Krijg je een autorisatiefout, controleer dan de opgeslagen API-sleutel.
{
"mcpServers": {
"transcript1": {
"url": "https://api.transcript1.com/mcp",
"headers": {
"Authorization": "Bearer t1_YOURKEY"
}
}
}
}Claude Code, Claude of ChatGPT verbinden
In Claude Code voeg je de server toe met claude mcp add, het endpoint en je API-sleutel. In Claude maak je een eigen connector met die URL en log je in. Voor ChatGPT gebruik je dezelfde URL. Volg de stappen voor jouw assistent.
De connectors van Claude en ChatGPT gebruiken OAuth. Of je een eigen connector kunt toevoegen, hangt af van je abonnement bij de assistent en de instellingen van je werkruimte. De API-sleutelroute voor een code-editor is iets anders; kies dus de uitleg voor de app die je gebruikt.
Geef na het verbinden een openbare videolink en een concrete opdracht. Vraag bijvoorbeeld eerst om het transcript van een Instagram Reel en daarna om de uitgesproken instructies. transcript1 levert de woorden uit de audio. Je assistent weet daarmee nog niet wat er alleen in beeld gebeurt.
claude mcp add --transport http transcript1 https://api.transcript1.com/mcp --header "Authorization: Bearer t1_YOURKEY"Zo haalt de assistent de tekst op
Je assistent roept transcribe aan, wacht en leest de eerste pagina. Duurt de verwerking langer, dan krijgt hij een ID om met get_transcription verder te gaan. De toolreferentie beschrijft de parameters; de agentgids helpt bij hergebruik en het lezen van lange transcripts.
Standaard komt de tekst terug met tijdstempels. Bij lange opnames geeft next_from_seconds aan waar de volgende pagina begint. Geef die waarde mee als from_seconds. Laat je assistent niet de hele opname samenvatten op basis van alleen de eerste pagina: eerst moeten alle relevante delen gelezen zijn.
Een volledige ondersteunde videolink kan een passende transcriptie van de afgelopen 24 uur opleveren. Bij korte deellinks werkt die matching bij het insturen niet. Heb je al een ID, lees dat dan met get_transcription in plaats van opnieuw te starten. Vervang in het voorbeeld de placeholder door een echte, openbare TikTok-videolink.
transcribe(url="[public TikTok video URL]")
get_transcription(id="tr_8fK2Lm0PqRsTuVwXyZaBcD", format="srt")Een bestandsnaam in de chat is nog geen upload
MCP verstuurt toolrequests en antwoorden, niet de bytes van je opname. create_upload reserveert een upload en geeft een plan terug. Je agent moet het lokale bestand zelf kunnen lezen, de delen buiten MCP via HTTP versturen en daarna complete_upload aanroepen. De bestandsuitleg laat zien waar die grens ligt.
Niet elke assistent kan bij je lokale bestanden of binaire HTTP-requests versturen. Upload de opname dan in het dashboard en geef de assistent het ID van de afgeronde transcriptie. Alleen een lokaal pad noemen maakt het bestand niet beschikbaar voor transcript1.
Voor webhooks gebruik je de REST API; MCP heeft daar geen parameter voor. In een gesprek kun je kort wachten en de status met get_transcription opnieuw opvragen. Verbreekt de verbinding, zoek dan je recente transcripties op of ga verder met het bekende ID. Een afgebroken toolaanroep bewijst niet dat er geen taak is gestart.
Met dezelfde verbinding kun je een Bluesky-video laten samenvatten of de tekst van een TikTok-video bespreken. De bronregels blijven gelden: posts moeten openbaar zijn en het transcript bevat de gesproken woorden, niet wat er alleen in beeld gebeurt.