Serverul MCP ToRun
Ultima actualizare: 11 nov. 2026
Ce este
Serverul MCP ToRun permite unui agent de programare să folosească ToRun în timp ce lucrează la proiectul dvs. Un agent care acceptă servere MCP la distanță, precum Claude Code, Cursor sau opencode, poate crea imagini, vorbire, muzică și video, poate edita imagini, poate transcrie audio, poate rula cercetări aprofundate și șabloanele de fluxuri de lucru ToRun și poate publica o pagină HTML sau un joc de browser ca link, fără să vă părăsiți editorul. Ce creează agentul se plătește din contul dvs. ToRun la aceleași prețuri ca în aplicație și se salvează în contul dvs. ToRun ca orice creați în aplicație.
Adresă și autentificare
| Adresa serverului | https://mcp.torun.ai/mcp |
| Transport | HTTP (server MCP la distanță) |
| Autentificare | Authorization: Bearer <your developer key> |
O cheie de dezvoltator începe cu trn_live_. O creați pe pagina Dezvoltatori din contul dvs. ToRun: consultați Chei de dezvoltator. Configurarea pentru fiecare instrument:
Instrumente
| Instrument | Ce face | Plătit |
|---|---|---|
image_generate |
Creează imagini dintr-un prompt: sprite-uri, pictograme, fundaluri, ilustrații. Returnează imaginile sau un ID de sarcină când durează mai mult decât a ales agentul să aștepte. | Da |
image_edit |
Modifică o imagine pe baza unei instrucțiuni scrise: un fundal nou, altă culoare, un obiect adăugat sau eliminat, alt stil. Imaginea este una creată de agent cu ToRun sau un link către un fișier PNG, JPEG sau WebP de până la 20 MB; o imagine dată prin link este salvată mai întâi în biblioteca dvs. ToRun. Returnează imaginile sau un ID de sarcină, ca image_generate. |
Da |
tts_generate |
Transformă textul în vorbire și returnează fișierul audio și durata de redare, măsurată din fișier. | Da |
stt_transcribe |
Transformă vorbirea dintr-un fișier audio sau video în text, cu segmente cronometrate pentru subtitrări când agentul le cere. Acceptă fișiere mp3, m4a, wav, webm, ogg, opus, flac, aac și mp4 de până la 25 MB. | Da |
music_generate |
Compune o piesă, cu sau fără voce, și returnează un ID de sarcină. | Da |
video_generate |
Creează un clip scurt dintr-un prompt și returnează un ID de sarcină. | Da |
job_status |
Raportează progresul unei sarcini de imagine, muzică sau video și returnează fișierul când este gata. | Gratuit |
deep_research_start |
Pornește o cercetare aprofundată despre o întrebare: caută pe web în multe surse și scrie un raport cu sursele citate. Returnează un ID de sarcină. | Da |
deep_research_status |
Raportează progresul unei cercetări aprofundate și returnează raportul când este gata. | Gratuit |
workflow_template_search |
Găsește șabloanele de fluxuri de lucru ToRun, procese gata făcute în mai mulți pași, și arată ce produce fiecare, cât costă de obicei și ce date de intrare primește. | Gratuit |
workflow_run |
Rulează un șablon de flux de lucru cu datele de intrare date de agent și returnează un ID de sarcină. | Da |
workflow_run_status |
Raportează progresul unei rulări de flux de lucru și câte Runs a costat până acum și returnează rezultatele când sunt gata. | Gratuit |
canvas_publish |
Publică o pagină HTML dintr-un singur fișier sau un joc de browser ca link. | Gratuit |
account_balance |
Arată ce a rămas din alocarea planului și din portofel, precum și limita lunară și cheltuielile acestei chei. | Gratuit |
Un link de fișier returnat de un instrument se descarcă fără autentificare, așa că agentul poate salva fișierul în proiectul dvs. Păstrați linkul întreg, inclusiv partea de după semnul întrebării.
O pagină publicată este nelistată: oricine are linkul o poate deschide, dar nu apare în secțiunea Explorează din ToRun, iar motoarele de căutare nu o indexează.
Sarcini lungi
Muzica, video, cercetările aprofundate și rulările de fluxuri de lucru durează mai mult decât un apel. Instrumentul returnează un ID de sarcină, iar agentul întreabă din nou până când rezultatul este gata: job_status pentru imagini, muzică și video, deep_research_status pentru un raport de cercetare și workflow_run_status pentru o rulare de flux de lucru. O imagine care nu este gata în timpul de așteptare ales de agent revine tot ca ID de sarcină.
O cercetare durează între 1 și 10 minute și continuă chiar dacă se termină conversația cu agentul; raportul apare și ca o conversație separată în lista dvs. de chaturi ToRun. O rulare de flux de lucru durează de la un minut la zeci de minute, iar rularea și fișierele ei apar în contul dvs. ToRun. Un raport lung sau un set lung de rezultate vine în părți, iar agentul cere restul.
Cum se plătesc apelurile
- Fiecare apel plătit se taxează în Runs la aceleași prețuri ca în aplicație.
- Se plătește mai întâi din alocarea planului dvs., apoi din portofel, dacă ați permis acest lucru pe cheie.
- Alocarea gratuită nu plătește niciodată apelurile API.
- O rulare de flux de lucru se taxează pas cu pas în timp ce rulează.
- Fiecare taxare apare pe pagina dvs. de facturare, sub cheia care a făcut-o.
Un apel peste pragul cheii întreabă mai întâi
Fiecare cheie are un prag. Când un singur apel ar costa mai mult, instrumentul nu îl rulează încă. Pentru o rulare de flux de lucru, se compară estimarea rulării.
- Dacă instrumentul dvs. poate afișa un formular când un server MCP pune o întrebare (MCP elicitation), ToRun vă întreabă acolo: formularul arată prețul și întreabă dacă doriți să continuați. Apelul rulează dacă acceptați; dacă refuzați, nu rulează nimic.
- Altfel, instrumentul răspunde cu prețul, agentul vi-l arată, iar apelul rulează doar când agentul îl repetă după ce sunteți de acord.
Pentru întrebare nu se taxează nimic.
Limite
Fiecare cheie are o limită lunară și una zilnică de cheltuieli, precum și o limită de apeluri pe minut. Fiecare cont are și o limită zilnică de pagini publicate. Limita lunară și pragul unei chei le setați când o creați; valorile implicite sunt listate pe torun.ai/developers. Pentru a le schimba, creați o cheie nouă cu setările dorite și revocați-o pe cea veche.
Când un apel este refuzat
| Ce i se spune agentului | Ce trebuie făcut |
|---|---|
| Apelul necesită o cheie de dezvoltator | Verificați că TORUN_API_KEY conține cheia întreagă și că cheia nu a fost revocată. |
| Alocarea planului s-a epuizat, iar cheia nu are voie să cheltuiască din portofel | Așteptați reînnoirea alocării sau creați o cheie care are voie să cheltuiască din portofel. |
| Cheile de dezvoltator cheltuiesc doar alocarea unui plan plătit sau portofelul | Reîncărcați soldul sau abonați-vă. |
| Cheia a atins limita lunară sau zilnică de cheltuieli | Așteptați ziua sau luna următoare sau creați o cheie cu o limită mai mare. |
| Cheia a făcut prea multe apeluri într-un minut | Așteptați puțin și încercați din nou. |
| Cheia nu are domeniul de acces de care are nevoie un instrument | Domeniile de acces ale unei chei nu pot fi schimbate. Creați o cheie nouă: o cheie nouă are toate domeniile de acces. |
| Fișierul trebuie dat ca ID din biblioteca ToRun sau ca link https, nu ambele | Dați exact unul dintre cele două. |
| Nu există un astfel de fișier în biblioteca ToRun a contului | Folosiți un fișier al acestui cont. Un link ToRun către fișierul altui cont este refuzat la fel. |
| Fișierul este prea mare, nu este într-un format acceptat de instrument sau nu a putut fi descărcat | Imagini pentru image_edit: PNG, JPEG sau WebP, până la 20 MB. Fișiere pentru stt_transcribe: mp3, m4a, wav, webm, ogg, opus, flac, aac sau mp4, până la 25 MB. Linkul trebuie să se descarce fără autentificare. |