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
{
"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 }
}
}
}
]
}Configurazione in pochi passaggi
- 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
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
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
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.