MCP server ToRun
Posledná aktualizácia: 11 nov 2026
Čo to je
MCP server ToRun umožňuje programovaciemu agentovi používať ToRun, kým pracuje na vašom projekte. Agent, ktorý podporuje vzdialené MCP servery, napríklad Claude Code, Cursor alebo opencode, môže vytvárať obrázky, reč, hudbu a video, upravovať obrázky, prepisovať audio, spúšťať hĺbkový výskum a šablóny pracovných postupov ToRun a publikovať stránku HTML alebo prehliadačovú hru ako odkaz, bez toho, aby ste opustili editor. To, čo agent vytvorí, sa platí z vášho účtu ToRun za rovnaké ceny ako v aplikácii a ukladá sa do vášho účtu ToRun rovnako ako čokoľvek, čo vytvoríte v aplikácii.
Adresa a prihlásenie
| Adresa servera | https://mcp.torun.ai/mcp |
| Prenos | HTTP (vzdialený MCP server) |
| Prihlásenie | Authorization: Bearer <your developer key> |
Vývojársky kľúč začína na trn_live_. Vytvoríte ho na stránke Pre vývojárov vo svojom účte ToRun: pozrite Vývojárske kľúče. Nastavenie pre jednotlivé nástroje:
Nástroje
| Nástroj | Čo robí | Platený |
|---|---|---|
image_generate |
Vytvára obrázky podľa promptu: sprity, ikony, pozadia, ilustrácie. Vracia obrázky, alebo ID úlohy, keď trvajú dlhšie, než sa agent rozhodol čakať. | Áno |
image_edit |
Mení obrázok podľa písaného pokynu: nové pozadie, iná farba, pridaný alebo odstránený objekt, iný štýl. Obrázok je buď ten, ktorý agent vytvoril s ToRun, alebo odkaz na súbor PNG, JPEG či WebP do 20 MB; obrázok zadaný odkazom sa najprv uloží do vašej knižnice ToRun. Vracia obrázky alebo ID úlohy, rovnako ako image_generate. |
Áno |
tts_generate |
Prevádza text na reč a vracia zvukový súbor a dĺžku jeho prehrávania, odmeranú zo súboru. | Áno |
stt_transcribe |
Prevádza reč v audio alebo video súbore na text, s časovo označenými úsekmi pre titulky, keď o ne agent požiada. Prijíma súbory mp3, m4a, wav, webm, ogg, opus, flac, aac a mp4 do 25 MB. | Áno |
music_generate |
Zloží skladbu so spevom alebo bez neho a vráti ID úlohy. | Áno |
video_generate |
Vytvorí krátky klip podľa promptu a vráti ID úlohy. | Áno |
job_status |
Hlási priebeh úlohy obrázka, hudby alebo videa a vráti súbor, keď je hotový. | Zadarmo |
deep_research_start |
Spustí hĺbkový výskum k zadanej otázke: prehľadá web naprieč mnohými zdrojmi a napíše správu s citovanými zdrojmi. Vráti ID úlohy. | Áno |
deep_research_status |
Hlási priebeh hĺbkového výskumu a vráti správu, keď je hotová. | Zadarmo |
workflow_template_search |
Vyhľadá šablóny pracovných postupov ToRun, teda hotové viackrokové procesy, a ukáže, čo každá vytvára, koľko zvyčajne stojí a aké vstupy prijíma. | Zadarmo |
workflow_run |
Spustí šablónu pracovného postupu so vstupmi, ktoré jej agent odovzdá, a vráti ID úlohy. | Áno |
workflow_run_status |
Hlási priebeh behu pracovného postupu a koľko Runs zatiaľ stál a vráti jeho výsledky, keď sú hotové. | Zadarmo |
canvas_publish |
Publikuje jednosúborovú stránku HTML alebo prehliadačovú hru ako odkaz. | Zadarmo |
account_balance |
Zobrazí, koľko zostáva z limitu plánu a v peňaženke, a mesačný limit a výdavky tohto kľúča. | Zadarmo |
Odkaz na súbor, ktorý nástroj vráti, sa dá stiahnuť bez prihlásenia, takže agent môže súbor uložiť do vášho projektu. Uchovajte celý odkaz vrátane časti za otáznikom.
Publikovaná stránka je neverejná: otvoriť ju môže ktokoľvek, kto má odkaz, ale nezobrazuje sa v sekcii Objavovať v ToRun a vyhľadávače ju neindexujú.
Dlhé úlohy
Hudba, video, hĺbkový výskum a behy pracovných postupov trvajú dlhšie než jedno volanie. Nástroj vráti ID úlohy a agent sa pýta znova, kým výsledok nie je hotový: job_status pre obrázky, hudbu a video, deep_research_status pre správu z výskumu a workflow_run_status pre beh pracovného postupu. Obrázok, ktorý nie je hotový počas doby čakania zvolenej agentom, sa tiež vráti ako ID úlohy.
Výskum trvá 1 až 10 minút a pokračuje, aj keď konverzácia s agentom skončí; správa sa tiež objaví ako samostatná konverzácia vo vašom zozname chatov ToRun. Beh pracovného postupu trvá od minúty po desiatky minút a beh aj jeho súbory sa objavia vo vašom účte ToRun. Dlhá správa alebo dlhá sada výsledkov prichádza po častiach a agent si o zvyšok požiada.
Ako sa volania platia
- Každé platené volanie sa účtuje v Runs za rovnaké ceny ako v aplikácii.
- Platí sa najprv z limitu vášho plánu, potom z peňaženky, ak ste to pri kľúči povolili.
- Bezplatný limit volania API nikdy neplatí.
- Beh pracovného postupu sa účtuje krok za krokom počas svojho priebehu.
- Každá platba sa zobrazí na vašej stránke fakturácie pod kľúčom, ktorý ju vykonal.
Volanie nad prahom kľúča sa najprv opýta
Každý kľúč má prah. Keď by jedno volanie stálo viac, nástroj ho zatiaľ nevykoná. Pri behu pracovného postupu sa porovnáva jeho odhadovaná cena.
- Ak váš nástroj vie zobraziť formulár, keď sa MCP server na niečo opýta (MCP elicitation), ToRun sa vás opýta tam: formulár ukáže cenu a opýta sa, či pokračovať. Ak súhlasíte, volanie prebehne; ak odmietnete, nič sa nespustí.
- Inak nástroj odpovie cenou, váš agent vám ju ukáže a volanie prebehne, až keď ho agent po vašom súhlase zopakuje.
Za samotnú otázku sa nič neúčtuje.
Limity
Každý kľúč má mesačný a denný limit výdavkov a limit volaní za minútu. Každý účet má aj denný limit publikovaných stránok. Mesačný limit a prah kľúča nastavujete pri jeho vytvorení; predvolené hodnoty sú uvedené na torun.ai/developers. Ak ich chcete zmeniť, vytvorte nový kľúč s požadovaným nastavením a starý zrušte.
Keď je volanie odmietnuté
| Čo sa agent dozvie | Čo robiť |
|---|---|
| Volanie vyžaduje vývojársky kľúč | Skontrolujte, či TORUN_API_KEY obsahuje celý kľúč a či kľúč nebol zrušený. |
| Limit plánu je vyčerpaný a kľúč nesmie platiť z peňaženky | Počkajte, kým sa limit obnoví, alebo vytvorte kľúč, ktorý smie platiť z peňaženky. |
| Vývojárske kľúče míňajú len limit plateného plánu alebo peňaženku | Dobite kredit alebo si predplaťte plán. |
| Kľúč dosiahol mesačný alebo denný limit výdavkov | Počkajte do ďalšieho dňa alebo mesiaca, alebo vytvorte kľúč s vyšším limitom. |
| Kľúč vykonal príliš veľa volaní za minútu | Chvíľu počkajte a skúste to znova. |
| Kľúč nemá rozsah, ktorý nástroj potrebuje | Rozsahy kľúča nemožno zmeniť. Vytvorte nový kľúč: nový kľúč má všetky rozsahy. |
| Súbor musí byť zadaný ako ID z knižnice ToRun alebo ako odkaz https, nie oboje | Zadajte práve jedno z toho. |
| V knižnici ToRun tohto účtu taký súbor nie je | Použite súbor tohto účtu. Odkaz ToRun na súbor iného účtu je odmietnutý rovnako. |
| Súbor je príliš veľký, nie je vo formáte, ktorý nástroj prijíma, alebo sa ho nepodarilo stiahnuť | Obrázky pre image_edit: PNG, JPEG alebo WebP, do 20 MB. Súbory pre stt_transcribe: mp3, m4a, wav, webm, ogg, opus, flac, aac alebo mp4, do 25 MB. Odkaz sa musí dať stiahnuť bez prihlásenia. |