DeepScript

Integrazione

Server MCP – gli agenti IA leggono le tue trascrizioni direttamente

Claude Desktop, Cursor, Zed e altri client MCP comunicano direttamente con la tua libreria DeepScript. Niente copia-incolla, nessun cloud di terze parti.

Invece di costruire i nostri endpoint di riassunto, traduzione o ricerca, DeepScript offre un server MCP completo. I client IA come Claude Desktop, Claude Code o Cursor si connettono tramite Bearer auth a `https://mcp.deepscript.com` e possono poi cercare nelle tue trascrizioni, recuperarne una o riassumerle – con l'LLM che preferiscono. Vengono esposti tre tool: `search_transcripts` (ricerca full-text nella tua libreria), `get_transcript` (contenuto completo della trascrizione, inclusi i timestamp per parola) e `list_recent` (le ultime N trascrizioni). Il server MCP fa parte del piano Pro (22 €/mese) perché rimuove la retention predefinita di 30 giorni e sblocca traffico degli agenti illimitato. I token di autenticazione sono le stesse chiavi API `ds_live_` usate dall'API REST.

Cosa puoi creare

  • Chiedi a Claude nell'app desktop: «Come si chiamava il fornitore nella riunione della settimana scorsa?» – e Claude cerca nelle tue trascrizioni.
  • Fai riassumere episodi di podcast all'agente nel tuo IDE senza doverli copiare.
  • Estrai citazioni dalle interviste tramite l'agente e scrivile in note Markdown (ad es. in Cursor o Zed).
  • Audit di conformità: fai verificare all'agente se determinati termini compaiono nelle riunioni archiviate.
  • Ricerca trasversale tra registrazioni: «Trova tutte le riunioni in cui si è parlato del Progetto X.»

Esempi di codice

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"
      }
    }
  }
}
Schema dei tool (esposto dal server)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 }
        }
      }
    }
  ]
}

Configurazione in pochi passaggi

  1. 1

    Attiva il piano Pro

    Il server MCP è riservato al piano Pro (22 €/mese). Esegui l'upgrade nella dashboard di fatturazione. Pro rimuove al contempo l'eliminazione automatica dopo 30 giorni, così il tuo agente può cercare anche tra le trascrizioni più vecchie.

  2. 2

    Usa una chiave API come token Bearer

    Genera una normale chiave `ds_live_` nella dashboard. La stessa chiave autentica sia le chiamate MCP che quelle REST. Consiglio: crea una chiave MCP dedicata con un'etichetta apposita, così potrai revocarla in modo isolato.

  3. 3

    Configura il tuo client MCP

    Aggiungi la voce server mostrata sopra in Claude Desktop, Cursor o Zed. Riavvia il client. I tre tool `search_transcripts`, `get_transcript` e `list_recent` compaiono automaticamente nel selettore dei tool.

  4. 4

    Usalo nella chat

    Parla all'agente in linguaggio naturale. Sceglie da solo il tool giusto. Esempio: «Cerca nelle mie trascrizioni tutte le menzioni di 'previsioni Q3'.» – l'agente chiama `search_transcripts({ query: 'Q3 forecast' })`.

Domande frequenti

Perché MCP è riservato al piano Pro?

Gli agenti effettuano spesso molte query per conversazione e hanno bisogno di accedere a trascrizioni più vecchie. Pro rimuove la retention predefinita di 30 giorni ed esenta le chiamate MCP dal normale rate limit. Per un uso occasionale è sufficiente l'endpoint REST in modalità pay-per-use.

Quali transport supporta il server?

Attualmente il transport HTTP (Server-Sent Events per le risposte in streaming). stdio non è supportato perché il server è remoto. La maggior parte dei client (Claude Desktop dalla versione 0.7, Cursor, Zed) supporta MCP HTTP out of the box.

I fornitori di IA vedono le mie trascrizioni?

Sì – non appena il tuo agente locale carica una trascrizione tramite `get_transcript`, la invia come contesto all'LLM (ad es. Anthropic, OpenAI). Per evitarlo, esegui un client LLM locale (ad es. Ollama tramite l'adapter Claude Code) combinato con DeepScript MCP – così i dati non lasciano mai la tua macchina più il nostro server tedesco.

Qual è la disponibilità del server MCP?

Il server MCP gira nello stesso cluster Hetzner dell'API REST con il consueto SLA del 99,9%. Stato e incidenti sono su deepscript.com/status. In caso di interruzione l'agente fallisce in modo controllato – le chiamate ai tool restituiscono un messaggio di errore chiaro.

Posso chiamare i tool MCP da solo, senza un client IA?

Tecnicamente sì – MCP è un protocollo JSON-RPC aperto, puoi richiamare i tool tramite HTTP/curl. Per integrazioni puramente server-to-server la normale API REST è però più pratica, perché è tipizzata con OpenAPI e non orientata agli agenti.

Pronto a portarlo in produzione?

Crea un account, genera una chiave API e parti. Tre trascrizioni gratuite per provare. Documentazione OpenAPI 3.1 completa su api.deepscript.com/docs.

Server MCP per trascrizioni – accesso Claude & ChatGPT | DeepScript