ScribeToAny per sviluppatori

ScribeToAny offre un server MCP remoto. Collegalo a ChatGPT, Claude, Cursor o a qualsiasi altro client MCP: l'app AI potrà elencare le tue trascrizioni, leggerle come testo o sottotitoli e avviare nuove trascrizioni da un link, tutto con il tuo account.

URL del server

https://scribetoany.com/api/mcp

Trasporto Streamable HTTP, JSON-RPC stateless con risposte JSON (nessun flusso SSE, nessun session id). Non serve una API key: il client effettua l'accesso con OAuth alla prima connessione.

Connessione

ChatGPT

ScribeToAny è disponibile nella directory dei plugin di ChatGPT: Aggiungi a ChatGPT. Maggiori dettagli nella pagina di ChatGPT.

Claude

Aggiungi come connettore personalizzato (oppure vai in Settings → Connectors → Add custom connector e incolla l'URL del server). Maggiori dettagli nella pagina di Claude.

Claude Code

Esegui questo comando, poi accedi con /mcp:

claude mcp add --transport http scribetoany https://scribetoany.com/api/mcp

Cursor

Aggiungi a Cursor con un clic, oppure inserisci questo in ~/.cursor/mcp.json:

{
  "mcpServers": {
    "scribetoany": {
      "url": "https://scribetoany.com/api/mcp"
    }
  }
}

Codex CLI

codex mcp add scribetoany --url https://scribetoany.com/api/mcp
codex mcp login scribetoany

Gemini CLI

Esegui questo comando, poi accedi con /mcp auth scribetoany:

gemini mcp add --transport http --scope user scribetoany https://scribetoany.com/api/mcp

VS Code

In .vscode/mcp.json:

{
  "servers": {
    "scribetoany": {
      "type": "http",
      "url": "https://scribetoany.com/api/mcp"
    }
  }
}

Quando l'app apre ScribeToAny, accedi e seleziona «Consenti l'accesso». Per disconnetterti, rimuovi ScribeToAny nelle impostazioni dell'app AI. Per provare il server senza un'app AI, esegui npx @modelcontextprotocol/inspector, scegli Streamable HTTP e usa l'URL sopra indicato.

Lascia che sia il tuo agent a configurarlo

Usi un coding agent (Claude Code, Codex, Gemini CLI, Cursor)? Incollagli questo prompt e aggiungerà il server per te.

Configura ScribeToAny per me, così potrò trascrivere audio e video e leggere le mie trascrizioni da qui.

1. Aggiungi il server MCP remoto https://scribetoany.com/api/mcp (Streamable HTTP, OAuth, nessuna API key) con il nome "scribetoany". Usa il tuo comando dedicato, ad esempio `claude mcp add --transport http scribetoany https://scribetoany.com/api/mcp` in Claude Code, `codex mcp add scribetoany --url https://scribetoany.com/api/mcp` in Codex o `gemini mcp add --transport http --scope user scribetoany https://scribetoany.com/api/mcp` in Gemini CLI.
2. Avvia l'accesso. Si aprirà ScribeToAny nel mio browser, dove effettuerò l'accesso e selezionerò «Consenti l'accesso».
3. Una volta effettuata la connessione, elenca le mie trascrizioni recenti per confermare che tutto funzioni.

Trascrivi i file sul tuo computer (CLI)

I client MCP diversi da ChatGPT non possono passare un file dal tuo computer. Lo strumento da riga di comando ScribeToAny può farlo: carica il file sul tuo account, attende la trascrizione e la salva come testo, SRT o VTT. I coding agent (Claude Code, Codex, Gemini CLI, Cursor) lo eseguono come qualsiasi altro comando. Richiede Node.js 20 o versioni successive.

npm i -g scribetoany
scribetoany auth login
scribetoany transcribe meeting.m4a --format srt --speakers

Aggiungi l'agent skill in modo che il tuo agent conosca i comandi e le opzioni:

npx skills add scribetoany/skills --skill scribetoany

scribetoany auth login apre ScribeToAny nel tuo browser, dove puoi accedere e autorizzare "ScribeToAny CLI", lo stesso consenso richiesto per le app IA. I risultati vanno su stdout e l'avanzamento su stderr; aggiungi --json per un output leggibile dalla macchina. Esegui scribetoany --help per tutte le opzioni.

Strumenti

StrumentoAccessoCosa fa
list_transcriptsSola letturaElenca le tue trascrizioni, dalla più recente, con stato, lingua e durata. Query di ricerca opzionale.
get_transcription_statusSola letturaVerifica se una trascrizione è in coda, in elaborazione, completata o non riuscita.
get_transcriptSola letturaLeggi una trascrizione completata come testo (timestamp ed etichette dei relatori opzionali), SRT o VTT.
transcribe_linkScritturaTrascrivi un link pubblico: X, Twitch, Loom, Google Drive, Dropbox o un URL audio/video diretto. I link di YouTube, TikTok e Instagram non sono supportati.
transcribe_fileScritturaSolo per ChatGPT: trascrivi un file audio o video allegato nella conversazione.
get_upload_linkSola letturaPer le app che non possono inviare file: ottieni un link che apre ScribeToAny nel browser per caricare un file locale.
get_usageSola letturaMostra il piano e la quota di trascrizione rimanente.

Ogni risultato include un link alla trascrizione nella dashboard di ScribeToAny. L'app non può modificare né eliminare nulla e non visualizza mai i dati di pagamento.

Autenticazione

  • Flusso authorization code di OAuth 2.1 con PKCE (solo S256) e dynamic client registration, così i client si registrano autonomamente. Gli access token durano 1 ora; i refresh token durano 30 giorni.
  • Una richiesta non autenticata riceve 401 con un header WWW-Authenticate che punta ai metadati della risorsa protetta, tramite cui i client individuano l'authorization server:
https://scribetoany.com/.well-known/oauth-protected-resource/api/mcp
https://scribetoany.com/.well-known/oauth-authorization-server

L'accesso viene concesso solo dopo aver approvato il client nella schermata di consenso di ScribeToAny, e solo gli account verificati possono connettersi.

Limiti

  • Le trascrizioni avviate da un'app AI vengono conteggiate nel piano come tutte le altre. Il piano gratuito include 2 trascrizioni al giorno e 100 minuti al mese; i piani a pagamento aumentano entrambi i limiti.
  • get_transcript restituisce fino a 120.000 caratteri; le trascrizioni più lunghe vengono troncate con un link a quella completa.
  • Un batch JSON-RPC può contenere fino a 10 messaggi.
  • I link di YouTube, TikTok e Instagram non sono supportati. Scarica il file e caricalo direttamente su ScribeToAny.

Altro

Le domande che puoi porre una volta effettuata la connessione sono disponibili nel Centro assistenza. Una guida in testo normale all'intero sito per gli assistenti AI è disponibile su /llms.txt. I contenuti a cui un'app collegata può accedere sono descritti nella Informativa sulla privacy. Qualcosa non funziona? Contattaci.