MCP server ToRun
Poslední aktualizace: 11 lis 2026
Co to je
MCP server ToRun umožňuje programovacímu agentovi používat ToRun, zatímco pracuje na vašem projektu. Agent, který podporuje vzdálené MCP servery, například Claude Code, Cursor nebo opencode, může vytvářet obrázky, řeč, hudbu a video, upravovat obrázky, přepisovat audio, spouštět hloubkový výzkum a šablony pracovních postupů ToRun a publikovat stránku HTML nebo prohlížečovou hru jako odkaz, aniž byste opustili editor. To, co agent vytvoří, se platí z vašeho účtu ToRun za stejné ceny jako v aplikaci a ukládá se do vašeho účtu ToRun stejně jako cokoli, co vytvoříte v aplikaci.
Adresa a přihlášení
| Adresa serveru | https://mcp.torun.ai/mcp |
| Přenos | HTTP (vzdálený MCP server) |
| Přihlášení | Authorization: Bearer <your developer key> |
Vývojářský klíč začíná na trn_live_. Vytvoříte ho na stránce Pro vývojáře ve svém účtu ToRun: viz Vývojářské klíče. Nastavení pro jednotlivé nástroje:
Nástroje
| Nástroj | Co dělá | Placený |
|---|---|---|
image_generate |
Vytváří obrázky podle promptu: sprity, ikony, pozadí, ilustrace. Vrací obrázky, nebo ID úlohy, když trvají déle, než se agent rozhodl čekat. | Ano |
image_edit |
Mění obrázek podle psaného pokynu: nové pozadí, jiná barva, přidaný nebo odebraný objekt, jiný styl. Obrázek je buď ten, který agent vytvořil s ToRun, nebo odkaz na soubor PNG, JPEG či WebP do 20 MB; obrázek zadaný odkazem se nejprve uloží do vaší knihovny ToRun. Vrací obrázky nebo ID úlohy, stejně jako image_generate. |
Ano |
tts_generate |
Převádí text na řeč a vrací zvukový soubor a délku jeho přehrávání, změřenou ze souboru. | Ano |
stt_transcribe |
Převádí řeč v audio nebo video souboru na text, s časově označenými úseky pro titulky, když o ně agent požádá. Přijímá soubory mp3, m4a, wav, webm, ogg, opus, flac, aac a mp4 do 25 MB. | Ano |
music_generate |
Složí skladbu se zpěvem nebo bez něj a vrátí ID úlohy. | Ano |
video_generate |
Vytvoří krátký klip podle promptu a vrátí ID úlohy. | Ano |
job_status |
Hlásí průběh úlohy obrázku, hudby nebo videa a vrátí soubor, když je hotový. | Zdarma |
deep_research_start |
Spustí hloubkový výzkum k zadané otázce: prohledá web napříč mnoha zdroji a napíše zprávu s citovanými zdroji. Vrátí ID úlohy. | Ano |
deep_research_status |
Hlásí průběh hloubkového výzkumu a vrátí zprávu, když je hotová. | Zdarma |
workflow_template_search |
Vyhledá šablony pracovních postupů ToRun, tedy hotové vícekrokové procesy, a ukáže, co každá vytváří, kolik obvykle stojí a jaké vstupy přijímá. | Zdarma |
workflow_run |
Spustí šablonu pracovního postupu se vstupy, které jí agent předá, a vrátí ID úlohy. | Ano |
workflow_run_status |
Hlásí průběh běhu pracovního postupu a kolik Runs zatím stál a vrátí jeho výsledky, když jsou hotové. | Zdarma |
canvas_publish |
Publikuje jednosouborovou stránku HTML nebo prohlížečovou hru jako odkaz. | Zdarma |
account_balance |
Zobrazí, kolik zbývá z limitu plánu a v peněžence, a měsíční limit a útratu tohoto klíče. | Zdarma |
Odkaz na soubor, který nástroj vrátí, lze stáhnout bez přihlášení, takže agent může soubor uložit do vašeho projektu. Uchovejte celý odkaz včetně části za otazníkem.
Publikovaná stránka je neveřejná: otevřít ji může kdokoli, kdo má odkaz, ale nezobrazuje se v sekci Objevovat v ToRun a vyhledávače ji neindexují.
Dlouhé úlohy
Hudba, video, hloubkový výzkum a běhy pracovních postupů trvají déle než jedno volání. Nástroj vrátí ID úlohy a agent se ptá znovu, dokud výsledek není hotový: job_status pro obrázky, hudbu a video, deep_research_status pro zprávu z výzkumu a workflow_run_status pro běh pracovního postupu. Obrázek, který není hotový během doby čekání zvolené agentem, se také vrátí jako ID úlohy.
Výzkum trvá 1 až 10 minut a pokračuje, i když konverzace s agentem skončí; zpráva se také objeví jako samostatná konverzace ve vašem seznamu chatů ToRun. Běh pracovního postupu trvá od minuty po desítky minut a běh i jeho soubory se objeví ve vašem účtu ToRun. Dlouhá zpráva nebo dlouhá sada výsledků přichází po částech a agent si o zbytek požádá.
Jak se volání platí
- Každé placené volání se účtuje v Runs za stejné ceny jako v aplikaci.
- Platí se nejprve z limitu vašeho plánu, potom z peněženky, pokud jste to u klíče povolili.
- Bezplatný limit volání API nikdy neplatí.
- Běh pracovního postupu se účtuje krok za krokem během svého průběhu.
- Každá platba se zobrazí na vaší stránce fakturace pod klíčem, který ji provedl.
Volání nad prahem klíče se nejprve zeptá
Každý klíč má práh. Když by jedno volání stálo víc, nástroj ho zatím neprovede. U běhu pracovního postupu se porovnává jeho odhadovaná cena.
- Pokud váš nástroj umí zobrazit formulář, když se MCP server na něco zeptá (MCP elicitation), ToRun se vás zeptá tam: formulář ukáže cenu a zeptá se, zda pokračovat. Pokud souhlasíte, volání proběhne; pokud odmítnete, nic se nespustí.
- Jinak nástroj odpoví cenou, váš agent vám ji ukáže a volání proběhne, až když ho agent po vašem souhlasu zopakuje.
Za samotný dotaz se nic neúčtuje.
Limity
Každý klíč má měsíční a denní limit útraty a limit volání za minutu. Každý účet má také denní limit publikovaných stránek. Měsíční limit a práh klíče nastavujete při jeho vytvoření; výchozí hodnoty jsou uvedeny na torun.ai/developers. Chcete-li je změnit, vytvořte nový klíč s požadovaným nastavením a starý zrušte.
Když je volání odmítnuto
| Co se agent dozví | Co dělat |
|---|---|
| Volání vyžaduje vývojářský klíč | Zkontrolujte, že TORUN_API_KEY obsahuje celý klíč a že klíč nebyl zrušen. |
| Limit plánu je vyčerpán a klíč nesmí platit z peněženky | Počkejte, až se limit obnoví, nebo vytvořte klíč, který smí platit z peněženky. |
| Vývojářské klíče utrácejí jen limit placeného plánu nebo peněženku | Dobijte kredit nebo si předplaťte plán. |
| Klíč dosáhl měsíčního nebo denního limitu útraty | Počkejte do dalšího dne nebo měsíce, nebo vytvořte klíč s vyšším limitem. |
| Klíč provedl příliš mnoho volání za minutu | Chvíli počkejte a zkuste to znovu. |
| Klíč nemá rozsah, který nástroj potřebuje | Rozsahy klíče nelze změnit. Vytvořte nový klíč: nový klíč má všechny rozsahy. |
| Soubor musí být zadán jako ID z knihovny ToRun, nebo jako odkaz https, ne obojí | Zadejte právě jedno z toho. |
| V knihovně ToRun tohoto účtu takový soubor není | Použijte soubor tohoto účtu. Odkaz ToRun na soubor jiného účtu je odmítnut stejně. |
| Soubor je příliš velký, není ve formátu, který nástroj přijímá, nebo ho nebylo možné stáhnout | Obrázky pro image_edit: PNG, JPEG nebo WebP, do 20 MB. Soubory pro stt_transcribe: mp3, m4a, wav, webm, ogg, opus, flac, aac nebo mp4, do 25 MB. Odkaz musí jít stáhnout bez přihlášení. |