Integration
MCP Server — AI-Agents lesen deine Transkripte direkt
Claude Desktop, Cursor, Zed und andere MCP-Clients sprechen direkt mit deiner DeepScript-Bibliothek. Kein Copy-Paste, keine Drittanbieter-Cloud.
Statt eigene Summarize-, Translate- oder Suchendpunkte zu bauen, stellt DeepScript einen vollwertigen MCP-Server bereit. AI-Clients wie Claude Desktop, Claude Code oder Cursor verbinden sich per Bearer-Auth gegen `https://mcp.deepscript.com` und können dann deine Transkripte durchsuchen, einzelne abrufen oder zusammenfassen — mit dem LLM ihrer Wahl. Drei Tools sind verfügbar: `search_transcripts` (Volltextsuche über deine Bibliothek), `get_transcript` (kompletter Transkript-Inhalt inkl. Wort-Timestamps) und `list_recent` (die letzten N Transkriptionen). Der MCP-Server ist Teil des Pro-Plans (22 €/Monat), weil er die Default-30-Tage-Retention aufhebt und Agent-Traffic unlimited freischaltet. Auth-Token sind dieselben `ds_live_`-API-Keys wie bei der REST-API.
Was du bauen kannst
- Claude in der Desktop-App fragen: "Wie hieß nochmal der Lieferant im Meeting letzte Woche?" — und Claude durchsucht deine Transkripte.
- Podcast-Episoden im IDE-Agenten zusammenfassen lassen, ohne sie zu kopieren.
- Interview-Quotes via Agent extrahieren und in Markdown-Notizen schreiben (z.B. in Cursor oder Zed).
- Compliance-Audits: Agent prüft, ob bestimmte Begriffe in archivierten Meetings vorkamen.
- Cross-Recording-Recherche: "Finde alle Meetings, in denen über Projekt X gesprochen wurde."
Code-Beispiele
{
"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 wenigen Schritten
- 1
Pro-Plan aktivieren
Der MCP-Server ist Pro-only (22 €/Monat). Im Billing-Dashboard upgraden. Pro hebt gleichzeitig die 30-Tage-Auto-Löschung auf, sodass dein Agent auch ältere Transkripte durchsuchen kann.
- 2
API-Key als Bearer-Token nutzen
Im Dashboard einen normalen `ds_live_`-Key generieren. Derselbe Key authentifiziert MCP- und REST-Calls. Empfehlung: einen dedizierten MCP-Key mit eigener Scope-Bezeichnung erstellen, dann kannst du ihn isoliert widerrufen.
- 3
MCP-Client konfigurieren
In Claude Desktop, Cursor oder Zed den oben gezeigten Server-Eintrag hinzufügen. Client neu starten. Die drei Tools `search_transcripts`, `get_transcript` und `list_recent` erscheinen automatisch im Tool-Picker.
- 4
Im Chat verwenden
Frag den Agent in natürlicher Sprache. Er entscheidet selbst, welches Tool er aufruft. Beispiel: "Such mal in meinen Transkripten nach allen Erwähnungen von 'Q3-Forecast'." — der Agent ruft `search_transcripts({ query: 'Q3-Forecast' })` auf.
Häufige Fragen
Warum ist MCP Pro-only?
Agents stellen oft viele Queries pro Konversation und brauchen Zugriff auf ältere Transkripte. Pro hebt die 30-Tage-Standard-Retention auf und befreit MCP-Calls vom regulären Rate Limit. Für gelegentliche Nutzung reicht der REST-Endpoint im Pay-per-use-Modus.
Welche Transport-Varianten unterstützt der Server?
Aktuell HTTP-Transport (Server-Sent Events für streaming responses). stdio wird nicht unterstützt, weil der Server remote läuft. Die meisten Clients (Claude Desktop seit Version 0.7, Cursor, Zed) unterstützen HTTP-MCP out of the box.
Sehen die AI-Anbieter meine Transkripte?
Ja — sobald dein lokaler Agent ein Transkript per `get_transcript` lädt, sendet er es als Kontext an das LLM (z.B. Anthropic, OpenAI). Wer das vermeiden will, betreibt einen lokalen LLM-Client (z.B. Ollama via Claude Code Adapter) und kombiniert ihn mit DeepScript-MCP — dann verlassen die Daten nie deine Maschine plus unseren DE-Server.
Wie ist die Verfügbarkeit des MCP-Servers?
Der MCP-Server läuft im selben Hetzner-Cluster wie die REST-API mit dem üblichen 99.9%-SLA. Status und Incidents siehst du unter deepscript.com/status. Bei einem Server-Ausfall fällt der Agent transparent aus — Tool-Calls scheitern mit klarer Fehlermeldung.
Kann ich die MCP-Tools selbst aufrufen, ohne AI-Client?
Technisch ja — MCP ist ein offenes JSON-RPC-Protokoll, du kannst die Tools per HTTP/curl ansprechen. Für reine Server-zu-Server-Integrationen ist die normale REST-API aber praktischer, weil sie OpenAPI-getypt und nicht agent-orientiert ist.
Bereit, das in Production zu bringen?
Account erstellen, API-Key generieren, los geht's. Drei Transkriptionen kostenlos zum Testen. Vollständige OpenAPI 3.1 Docs unter api.deepscript.com/docs.