Hushscript parla il Model Context Protocol. Punta un client MCP su un unico URL, approva la connessione nel tuo browser, e l’assistente può lavorare con le registrazioni e le trascrizioni del tuo account. È il tuo account e i tuoi minuti dall’inizio alla fine: il server non vede mai i dati di un altro cliente, e niente qui cambia il modo in cui la trascrizione viene tariffata o conservata.
Connessione
Il server parla Streamable HTTP su un unico endpoint:
https://mcp.hushscript.com/mcp
Non esiste un endpoint SSE e non c’è nulla da installare localmente. In Claude Code:
claude mcp add --transport http hushscript https://mcp.hushscript.com/mcp
In un client che accetta una configurazione JSON:
{
"mcpServers": {
"hushscript": {
"type": "http",
"url": "https://mcp.hushscript.com/mcp"
}
}
}
Il tuo client scopre tutto il resto da solo. Si registra dinamicamente
(/oauth/register), legge /.well-known/oauth-authorization-server per gli
endpoint, e apre una finestra del browser per farti accedere.
Cosa approvi
L’autorizzazione avviene tramite OAuth 2.1 con PKCE. La finestra del browser è una schermata di consenso di Hushscript, non una casella per la password del client: indica il nome dell’applicazione che lo richiede, elenca in linguaggio semplice cosa vuole fare, e aspetta la tua conferma. Niente viene concesso finché non lo approvi lì.
I token di accesso durano un’ora e si rinnovano per trenta giorni. Non vedi, copi o incolli mai un token: il client e il server lo scambiano direttamente, quindi non c’è nessun segreto che resta in un file di configurazione sul tuo disco.
Permessi
Una connessione possiede un insieme di scope, e il server pubblicizza solo gli
strumenti che quegli scope coprono. Un client che non chiede nulla di
specifico ottiene tutto tranne billing.
| Scope | Cosa consente |
|---|---|
transcripts:read |
Leggere le trascrizioni, i loro metadati e l’elenco degli elementi eliminati |
transcripts:write |
Modificare, taggare, tradurre, ripristinare ed eliminare le trascrizioni |
transcribe |
Caricare registrazioni, importare da un link e avviare trascrizioni |
insights |
Leggere, generare ed eliminare gli Insights |
context |
Gestire i dizionari salvati e i preset dei prompt |
account:read |
Leggere saldo, utilizzo, transazioni e trattenute |
settings:write |
Modificare le impostazioni dell’account |
org:read |
Leggere i membri dello spazio di lavoro, il registro contabile, le fatture e il registro di audit |
export |
Esportare le trascrizioni e richiedere un’esportazione completa dell’account |
billing |
Acquistare pacchetti di minuti con la carta salvata |
billing è l’eccezione in ogni direzione. Non viene mai concesso
implicitamente, la schermata di consenso ti avvisa prima che tu lo approvi, e
resta disattivato a meno che la fatturazione non sia abilitata anche
sull’account stesso.
Cosa coprono gli strumenti
Cinquanta strumenti, raggruppati in base a cosa toccano:
| Gruppo | Strumenti | Esempi |
|---|---|---|
| Trascrizioni, lettura | 4 | list_transcripts, get_transcript, list_deleted |
| Trascrizioni, scrittura | 10 | update_body, revert_body, retranslate, tag_transcripts |
| Trascrizione | 8 | create_upload, transcribe_from_url, list_jobs, cancel_job |
| Account | 6 | get_balance, get_usage, list_transactions |
| Insights | 3 | get_insights, generate_insights, delete_insights |
| Esportazione | 4 | export_transcript, request_account_export |
| Contesto di trascrizione | 5 | save_dictionary, save_prompt_preset |
| Spazio di lavoro | 5 | get_org, list_org_members, get_org_audit_log |
| Fatturazione | 5 | list_packs, purchase_pack, list_payment_methods |
export_transcript restituisce TXT, SRT, VTT, Markdown o JSON. Il set
completo di 21 formati di esportazione si trova nell’app.
Cosa costa minuti
Leggere qualsiasi cosa è gratuito. Le azioni a pagamento sono le stesse che hanno un costo nell’app, alle stesse tariffe, prelevate dallo stesso saldo:
- Trascrivere una registrazione spende minuti pari alla sua durata. La modalità medica aggiunge il 100%, e ogni lingua di traduzione aggiunge il 25%.
- Insights è gratuito la prima volta per ogni trascrizione. Rigenerarlo in seguito costa il 40% della durata della registrazione a partire dall’Originale, oppure il 30% a partire dalla versione Pulita.
- Ritradurre una trascrizione costa il 25% della sua durata per lingua, e sovrascrive: ogni lingua per cui la chiamata addebita perde qualsiasi copia modificata a mano di quella traduzione, senza modo di recuperarla.
purchase_packaddebita subito la tua carta salvata. Richiede lo scopebilling, che nessun client ottiene per errore.
Vedi prezzi per i pacchetti stessi.
Verifica e revoca
Ogni connessione appare sotto App connesse nella pagina MCP del tuo account, con il client che l’ha creata e gli scope che detiene. Revocarne una lì la interrompe immediatamente. Fai questo invece di eliminare la voce nella configurazione del tuo client: la configurazione impedisce solo alla tua macchina di fare richieste.
Gli endpoint di autorizzazione hanno un limite di 30 richieste al minuto per indirizzo. È una misura contro i tentativi ripetuti di richiesta di token, non un limite alla quantità di lavoro che un assistente connesso può svolgere.