Integratie
MCP-server – AI-agents lezen je transcripten direct
Claude Desktop, Cursor, Zed en andere MCP-clients praten rechtstreeks met je DeepScript-bibliotheek. Geen kopiëren-plakken, geen cloud van derden.
In plaats van eigen samenvattings-, vertaal- of zoekendpoints te bouwen, levert DeepScript een volwaardige MCP-server. AI-clients zoals Claude Desktop, Claude Code of Cursor verbinden via Bearer-auth met `https://mcp.deepscript.com` en kunnen vervolgens je transcripten doorzoeken, afzonderlijke ophalen of samenvatten – met het LLM van hun keuze. Er zijn drie tools beschikbaar: `search_transcripts` (full-text zoeken in je bibliotheek), `get_transcript` (volledige transcriptinhoud inclusief woord-timestamps) en `list_recent` (de laatste N transcripties). De MCP-server maakt deel uit van het Pro-plan (€ 22/maand) omdat het de standaard 30-dagen-retentie opheft en onbeperkt agent-verkeer ontgrendelt. Auth-tokens zijn dezelfde `ds_live_`-API-sleutels als bij de REST API.
Wat je kunt bouwen
- Vraag Claude in de desktop-app: "Hoe heette de leverancier ook alweer in de meeting van vorige week?" – en Claude doorzoekt je transcripten.
- Laat podcast-afleveringen samenvatten door je IDE-agent zonder ze te kopiëren.
- Extraheer interviewcitaten via de agent en schrijf ze in Markdown-notities (bijv. in Cursor of Zed).
- Compliance-audits: laat de agent controleren of bepaalde termen in gearchiveerde meetings voorkwamen.
- Onderzoek over meerdere opnames heen: "Vind alle meetings waarin Project X is besproken."
Codevoorbeelden
{
"mcpServers": {
"deepscript": {
"type": "http",
"url": "https://mcp.deepscript.com",
"headers": {
"Authorization": "Bearer ds_live_xxx"
}
}
}
}{
"servers": {
"deepscript": {
"transport": "http",
"url": "https://mcp.deepscript.com",
"auth": {
"type": "bearer",
"token": "ds_live_xxx"
}
}
}
}{
"tools": [
{
"name": "search_transcripts",
"description": "Full-text search across the user's transcript library. Returns the top N hits with snippet, transcriptId and createdAt.",
"inputSchema": {
"type": "object",
"properties": {
"query": { "type": "string" },
"limit": { "type": "integer", "default": 10, "maximum": 50 }
},
"required": ["query"]
}
},
{
"name": "get_transcript",
"description": "Return the full text and word-level metadata for one transcription.",
"inputSchema": {
"type": "object",
"properties": {
"transcriptId": { "type": "string", "format": "uuid" },
"includeWords": { "type": "boolean", "default": false }
},
"required": ["transcriptId"]
}
},
{
"name": "list_recent",
"description": "List the N most recent transcriptions with filename, duration and createdAt.",
"inputSchema": {
"type": "object",
"properties": {
"limit": { "type": "integer", "default": 20, "maximum": 100 }
}
}
}
]
}Setup in een paar stappen
- 1
Het Pro-plan activeren
De MCP-server is alleen voor Pro (€ 22/maand). Upgrade in het billing-dashboard. Pro heft tegelijk de automatische verwijdering na 30 dagen op, zodat je agent ook oudere transcripten kan doorzoeken.
- 2
Een API-sleutel als bearer-token gebruiken
Genereer een gewone `ds_live_`-sleutel in het dashboard. Dezelfde sleutel authenticeert zowel MCP- als REST-calls. Aanbeveling: maak een aparte MCP-sleutel met een eigen label aan, zodat je hem afzonderlijk kunt intrekken.
- 3
Je MCP-client configureren
Voeg de hierboven getoonde server-entry toe aan Claude Desktop, Cursor of Zed. Start de client opnieuw op. De drie tools `search_transcripts`, `get_transcript` en `list_recent` verschijnen automatisch in de tool-picker.
- 4
Gebruik het in de chat
Praat met de agent in natuurlijke taal. Hij kiest zelf de juiste tool. Voorbeeld: "Zoek in mijn transcripten naar alle vermeldingen van 'Q3-forecast'." – de agent roept `search_transcripts({ query: 'Q3 forecast' })` aan.
Veelgestelde vragen
Waarom is MCP alleen voor Pro?
Agents stellen vaak veel queries per gesprek en hebben toegang tot oudere transcripten nodig. Pro heft de standaard 30-dagen-retentie op en stelt MCP-calls vrij van de reguliere rate limit. Voor incidenteel gebruik volstaat het REST-endpoint in pay-per-use-modus.
Welke transports ondersteunt de server?
Momenteel HTTP-transport (Server-Sent Events voor streaming-responses). stdio wordt niet ondersteund omdat de server op afstand draait. De meeste clients (Claude Desktop sinds versie 0.7, Cursor, Zed) ondersteunen HTTP-MCP standaard.
Zien de AI-aanbieders mijn transcripten?
Ja – zodra je lokale agent een transcript via `get_transcript` laadt, stuurt hij het als context naar het LLM (bijv. Anthropic, OpenAI). Om dat te voorkomen, draai je een lokale LLM-client (bijv. Ollama via de Claude Code-adapter) in combinatie met DeepScript MCP – dan blijven de gegevens uitsluitend op je eigen machine plus onze Duitse server.
Wat is de beschikbaarheid van de MCP-server?
De MCP-server draait in hetzelfde Hetzner-cluster als de REST API met onze gebruikelijke 99,9%-SLA. Status en incidenten vind je op deepscript.com/status. Bij een storing faalt de agent netjes – tool-calls geven een duidelijke foutmelding terug.
Kan ik de MCP-tools zelf aanroepen, zonder AI-client?
Technisch gezien wel – MCP is een open JSON-RPC-protocol, je kunt de tools via HTTP/curl aanroepen. Voor pure server-naar-server-integraties is de gewone REST API echter handiger, omdat die OpenAPI-getypeerd is en niet agent-georiënteerd.
Klaar om dit naar productie te brengen?
Maak een account aan, genereer een API-sleutel en ga van start. Drie transcripties gratis om te testen. Volledige OpenAPI 3.1-docs op api.deepscript.com/docs.