DeepScript

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

Claude Desktop – claude_desktop_config.jsonJSON
{
  "mcpServers": {
    "deepscript": {
      "type": "http",
      "url": "https://mcp.deepscript.com",
      "headers": {
        "Authorization": "Bearer ds_live_xxx"
      }
    }
  }
}
Cursor / Zed – mcp.jsonJSON
{
  "servers": {
    "deepscript": {
      "transport": "http",
      "url": "https://mcp.deepscript.com",
      "auth": {
        "type": "bearer",
        "token": "ds_live_xxx"
      }
    }
  }
}
Tool-schema (door de server geëxposeerd)JSON
{
  "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. 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. 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. 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. 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.

MCP-server voor transcripten – Claude & ChatGPT-toegang | DeepScript