Il server MCP di ToRun
Ultimo aggiornamento: 11 nov 2026
Che cos'è
Il server MCP di ToRun permette a un agente di programmazione di usare ToRun mentre lavora al tuo progetto. Un agente che supporta i server MCP remoti, come Claude Code, Cursor o opencode, può creare immagini, voce, musica e video, modificare immagini, trascrivere audio, eseguire ricerche approfondite e i modelli di workflow di ToRun, e pubblicare una pagina HTML o un gioco per browser come link, senza farti uscire dall'editor. Ciò che l'agente crea viene pagato dal tuo account ToRun agli stessi prezzi dell'app e viene salvato nel tuo account ToRun come tutto ciò che crei nell'app.
Indirizzo e accesso
| Indirizzo del server | https://mcp.torun.ai/mcp |
| Trasporto | HTTP (server MCP remoto) |
| Accesso | Authorization: Bearer <your developer key> |
Una chiave sviluppatore inizia con trn_live_. La crei nella pagina Sviluppatori del tuo account ToRun: vedi Chiavi sviluppatore. Configurazione per ogni strumento:
Strumenti
| Strumento | Cosa fa | A pagamento |
|---|---|---|
image_generate |
Crea immagini da un prompt: sprite, icone, sfondi, illustrazioni. Restituisce le immagini, oppure un id di job quando richiedono più tempo di quanto l'agente ha scelto di aspettare. | Sì |
image_edit |
Modifica un'immagine a partire da un'istruzione scritta: un nuovo sfondo, un altro colore, un oggetto aggiunto o rimosso, un altro stile. L'immagine è una creata dall'agente con ToRun oppure un link a un file PNG, JPEG o WebP fino a 20 MB; un'immagine indicata tramite link viene prima salvata nella tua libreria ToRun. Restituisce le immagini o un id di job, come image_generate. |
Sì |
tts_generate |
Trasforma il testo in voce e restituisce il file audio e la sua durata di riproduzione, misurata dal file. | Sì |
stt_transcribe |
Trasforma in testo il parlato di un file audio o video, con segmenti temporizzati per i sottotitoli quando l'agente li chiede. Accetta file mp3, m4a, wav, webm, ogg, opus, flac, aac e mp4 fino a 25 MB. | Sì |
music_generate |
Compone una traccia, con o senza voce, e restituisce un id di job. | Sì |
video_generate |
Crea una breve clip da un prompt e restituisce un id di job. | Sì |
job_status |
Riferisce lo stato di un job di immagine, musica o video e restituisce il file quando è pronto. | Gratis |
deep_research_start |
Avvia una ricerca approfondita su una domanda: cerca sul web in molte fonti e scrive un report con le fonti citate. Restituisce un id di job. | Sì |
deep_research_status |
Riferisce lo stato di una ricerca approfondita e restituisce il report quando è pronto. | Gratis |
workflow_template_search |
Trova i modelli di workflow di ToRun, pipeline in più passaggi già pronte, e mostra cosa produce ciascuno, quanto costa di solito e quali input richiede. | Gratis |
workflow_run |
Esegue un modello di workflow con gli input che gli dà l'agente e restituisce un id di job. | Sì |
workflow_run_status |
Riferisce lo stato di un'esecuzione di workflow e i Runs che è costata finora, e restituisce i risultati quando sono pronti. | Gratis |
canvas_publish |
Pubblica come link una pagina HTML in un solo file o un gioco per browser. | Gratis |
account_balance |
Mostra la quota del piano e il portafoglio rimanenti, oltre al limite mensile e alla spesa di questa chiave. | Gratis |
Un link a un file restituito da uno strumento si scarica senza effettuare l'accesso, così l'agente può salvare il file nel tuo progetto. Conserva il link intero, compresa la parte dopo il punto interrogativo.
Una pagina pubblicata non è elencata: chiunque abbia il link può aprirla, ma non compare in Esplora di ToRun e i motori di ricerca non la indicizzano.
Job lunghi
Musica, video, ricerche approfondite ed esecuzioni di workflow richiedono più tempo di una chiamata. Lo strumento restituisce un id di job, e l'agente chiede di nuovo finché il risultato non è pronto: job_status per immagini, musica e video, deep_research_status per un report di ricerca e workflow_run_status per un'esecuzione di workflow. Anche un'immagine che non è pronta entro il tempo di attesa scelto dall'agente torna come id di job.
Una ricerca dura da 1 a 10 minuti e prosegue anche se la conversazione con il tuo agente termina; il report compare anche come conversazione a sé nell'elenco delle chat di ToRun. Un'esecuzione di workflow dura da un minuto a decine di minuti, e l'esecuzione e i suoi file compaiono nel tuo account ToRun. Un report lungo o un lungo insieme di risultati arriva in più parti, e l'agente chiede il resto.
Come vengono pagate le chiamate
- Ogni chiamata a pagamento viene addebitata in Runs agli stessi prezzi dell'app.
- Viene pagata prima dalla quota del tuo piano, poi dal tuo portafoglio se lo hai consentito sulla chiave.
- La quota gratuita non paga mai le chiamate API.
- Un'esecuzione di workflow viene addebitata passo dopo passo mentre è in corso.
- Ogni addebito compare nella pagina di fatturazione sotto la chiave che lo ha generato.
Una chiamata oltre la soglia della chiave chiede prima
Ogni chiave ha una soglia. Quando una singola chiamata costerebbe di più, lo strumento non la esegue ancora. Per un'esecuzione di workflow si confronta la stima dell'esecuzione.
- Se il tuo strumento può mostrare un modulo quando un server MCP fa una domanda (MCP elicitation), ToRun te lo chiede lì: il modulo mostra il prezzo e chiede se continuare. La chiamata viene eseguita se dici di sì; se rifiuti, non viene eseguito nulla.
- Altrimenti lo strumento risponde con il prezzo, il tuo agente te lo mostra e la chiamata viene eseguita solo quando l'agente la ripete dopo il tuo consenso.
Chiedere non costa nulla.
Limiti
Ogni chiave ha un limite di spesa mensile e uno giornaliero, e un limite di chiamate al minuto. Ogni account ha anche un limite giornaliero di pagine pubblicate. Il limite mensile e la soglia di una chiave li imposti quando la crei; i valori predefiniti sono indicati su torun.ai/developers. Per cambiarli, crea una nuova chiave con le impostazioni che desideri e revoca quella vecchia.
Quando una chiamata viene rifiutata
| All'agente viene detto | Cosa fare |
|---|---|
| La chiamata richiede una chiave sviluppatore | Verifica che TORUN_API_KEY contenga la chiave completa e che la chiave non sia stata revocata. |
| La quota del piano è esaurita e la chiave non può spendere dal portafoglio | Aspetta il rinnovo della quota, oppure crea una chiave che possa spendere dal portafoglio. |
| Le chiavi sviluppatore spendono solo la quota di un piano a pagamento o il portafoglio | Ricarica o abbonati. |
| La chiave ha raggiunto il suo limite di spesa mensile o giornaliero | Aspetta il giorno o il mese successivo, oppure crea una chiave con un limite più alto. |
| La chiave ha fatto troppe chiamate in un minuto | Aspetta un momento e riprova. |
| La chiave non ha l'ambito di cui uno strumento ha bisogno | Gli ambiti di una chiave non si possono modificare. Crea una nuova chiave: una chiave nuova ha tutti gli ambiti. |
| Il file va indicato con un id della libreria ToRun o con un link https, non entrambi | Indica esattamente uno dei due. |
| Nella libreria ToRun dell'account non c'è un file del genere | Usa un file di questo account. Un link ToRun al file di un altro account viene rifiutato allo stesso modo. |
| Il file è troppo grande, non è in un formato accettato dallo strumento o non è stato possibile scaricarlo | Immagini per image_edit: PNG, JPEG o WebP, fino a 20 MB. File per stt_transcribe: mp3, m4a, wav, webm, ogg, opus, flac, aac o mp4, fino a 25 MB. Un link deve poter essere scaricato senza effettuare l'accesso. |