A ToRun MCP-szerver
Utolsó frissítés: 11 nov. 2026
Mi ez
A ToRun MCP-szerver lehetővé teszi, hogy egy kódoló ügynök a ToRun-t használja, miközben a projektjén dolgozik. Egy távoli MCP-szervereket támogató ügynök, például a Claude Code, a Cursor vagy az opencode, képeket, beszédet, zenét és videót készíthet, képeket szerkeszthet, hangfelvételeket írhat át szöveggé, mélykutatást és ToRun munkafolyamat-sablonokat futtathat, és linkként tehet közzé egy HTML-oldalt vagy böngészős játékot, anélkül hogy Önnek el kellene hagynia a szerkesztőt. Amit az ügynök készít, azt a ToRun-fiókjából fizetik ugyanazon az áron, mint az alkalmazásban, és a ToRun-fiókjába kerül, mint bármi, amit az alkalmazásban készít.
Cím és bejelentkezés
| Szervercím | https://mcp.torun.ai/mcp |
| Átvitel | HTTP (távoli MCP-szerver) |
| Bejelentkezés | Authorization: Bearer <your developer key> |
A fejlesztői kulcs trn_live_ előtaggal kezdődik. A ToRun-fiókja Fejlesztőknek oldalán hozhatja létre: lásd Fejlesztői kulcsok. Az egyes eszközök beállítása:
Eszközök
| Eszköz | Mit csinál | Fizetős |
|---|---|---|
image_generate |
Képeket készít promptból: sprite-okat, ikonokat, háttereket, illusztrációkat. A képeket adja vissza, vagy feladatazonosítót, ha tovább tartanak, mint amennyit az ügynök várni szándékozott. | Igen |
image_edit |
Írásos utasítás alapján módosít egy képet: új háttér, más szín, hozzáadott vagy eltávolított tárgy, más stílus. A kép vagy olyan, amelyet az ügynök a ToRun-nal készített, vagy egy legfeljebb 20 MB-os PNG-, JPEG- vagy WebP-fájl linkje; a linkkel megadott kép előbb a ToRun-könyvtárába kerül. A képeket vagy egy feladatazonosítót adja vissza, mint az image_generate. |
Igen |
tts_generate |
Beszéddé alakítja a szöveget, és visszaadja a hangfájlt és a fájlból mért lejátszási hosszát. | Igen |
stt_transcribe |
Szöveggé alakítja egy hang- vagy videofájl beszédét, és ha az ügynök kéri, időbélyeges szakaszokat is ad feliratokhoz. Legfeljebb 25 MB-os mp3-, m4a-, wav-, webm-, ogg-, opus-, flac-, aac- és mp4-fájlokat fogad. | Igen |
music_generate |
Zeneszámot szerez énekkel vagy anélkül, és feladatazonosítót ad vissza. | Igen |
video_generate |
Rövid klipet készít promptból, és feladatazonosítót ad vissza. | Igen |
job_status |
Beszámol egy kép-, zene- vagy videófeladat állapotáról, és visszaadja a fájlt, amikor elkészült. | Ingyenes |
deep_research_start |
Mélykutatást indít egy kérdésről: sok forrásban keres a weben, és jelentést ír a források megjelölésével. Feladatazonosítót ad vissza. | Igen |
deep_research_status |
Beszámol a mélykutatás állapotáról, és visszaadja a jelentést, amikor elkészült. | Ingyenes |
workflow_template_search |
Megkeresi a ToRun munkafolyamat-sablonjait, vagyis a kész, többlépéses folyamatokat, és megmutatja, mit állít elő mindegyik, általában mennyibe kerül, és milyen bemeneteket fogad. | Ingyenes |
workflow_run |
Lefuttat egy munkafolyamat-sablont az ügynök által megadott bemenetekkel, és feladatazonosítót ad vissza. | Igen |
workflow_run_status |
Beszámol egy munkafolyamat-futtatás állapotáról és arról, eddig hány Runs-ba került, és visszaadja az eredményeit, amikor elkészültek. | Ingyenes |
canvas_publish |
Linkként tesz közzé egy egyfájlos HTML-oldalt vagy böngészős játékot. | Ingyenes |
account_balance |
Megmutatja a csomag keretéből és a tárcából fennmaradó összeget, valamint ennek a kulcsnak a havi korlátját és költését. | Ingyenes |
Az eszköz által visszaadott fájllink bejelentkezés nélkül letölthető, így az ügynök a projektjébe mentheti a fájlt. Őrizze meg a teljes linket, a kérdőjel utáni részt is.
A közzétett oldal nem listázott: bárki megnyithatja, akinek megvan a linkje, de nem jelenik meg a ToRun Felfedezés részében, és a keresőmotorok nem indexelik.
Hosszú feladatok
A zene, a videó, a mélykutatás és a munkafolyamat-futtatások tovább tartanak egyetlen hívásnál. Az eszköz feladatazonosítót ad vissza, az ügynök pedig újra rákérdez, amíg az eredmény el nem készül: képekhez, zenéhez és videóhoz a job_status, kutatási jelentéshez a deep_research_status, munkafolyamat-futtatáshoz a workflow_run_status eszközt használja. Az a kép is feladatazonosítóként tér vissza, amely nem készül el az ügynök által választott várakozási időn belül.
Egy kutatás 1–10 percig tart, és akkor is folytatódik, ha az ügynökkel folytatott beszélgetés véget ér; a jelentés külön beszélgetésként is megjelenik a ToRun-csevegéslistájában. Egy munkafolyamat-futtatás egy perctől több tíz percig tart, a futtatás és a fájljai pedig megjelennek a ToRun-fiókjában. A hosszú jelentés vagy a hosszú eredményhalmaz részletekben érkezik, és az ügynök elkéri a többit.
Hogyan fizetik a hívásokat
- Minden fizetős hívást Runs egységben számlázunk, ugyanazon az áron, mint az alkalmazásban.
- Először a csomagja keretéből fizetjük, majd a tárcájából, ha ezt engedélyezte a kulcson.
- Az ingyenes keret soha nem fizeti az API-hívásokat.
- A munkafolyamat-futtatást futás közben lépésenként számlázzuk.
- Minden terhelés megjelenik a számlázási oldalán az azt végző kulcs alatt.
A kulcs küszöbértéke feletti hívás előbb kérdez
Minden kulcsnak van küszöbértéke. Ha egyetlen hívás ennél többe kerülne, az eszköz még nem futtatja le. Munkafolyamat-futtatásnál a futtatás becsült költségét hasonlítjuk össze.
- Ha az eszköze meg tud jeleníteni egy űrlapot, amikor egy MCP-szerver kérdést tesz fel (MCP elicitation), a ToRun ott kérdezi meg Önt: az űrlap megmutatja az árat, és megkérdezi, folytassa-e. Ha igent mond, a hívás lefut; ha elutasítja, semmi sem fut le.
- Ellenkező esetben az eszköz az árral válaszol, az ügynök megmutatja Önnek, és a hívás csak akkor fut le, ha az ügynök az Ön beleegyezése után megismétli.
A kérdésért semmit sem számlázunk.
Korlátok
Minden kulcsnak van havi és napi költési korlátja, valamint percenkénti híváskorlátja. Minden fióknak van napi korlátja a közzétett oldalakra is. A kulcs havi korlátját és küszöbértékét a létrehozásakor állítja be; az alapértékek a torun.ai/developers oldalon szerepelnek. A módosításukhoz hozzon létre egy új kulcsot a kívánt beállításokkal, és vonja vissza a régit.
Ha egy hívást elutasítunk
| Amit az ügynök megtud | Mi a teendő |
|---|---|
| A híváshoz fejlesztői kulcs szükséges | Ellenőrizze, hogy a TORUN_API_KEY a teljes kulcsot tartalmazza-e, és hogy a kulcsot nem vonták-e vissza. |
| A csomag kerete elfogyott, és a kulcs nem költhet a tárcából | Várja meg, amíg a keret megújul, vagy hozzon létre egy kulcsot, amely költhet a tárcából. |
| A fejlesztői kulcsok csak a fizetős csomag keretét vagy a tárcát költik | Töltse fel az egyenlegét, vagy fizessen elő. |
| A kulcs elérte a havi vagy napi költési korlátját | Várjon a következő napig vagy hónapig, vagy hozzon létre egy magasabb korlátú kulcsot. |
| A kulcs túl sok hívást indított egy perc alatt | Várjon egy kicsit, és próbálja újra. |
| A kulcsnak nincs meg az a hatóköre, amelyre egy eszköznek szüksége van | A kulcs hatóköreit nem lehet módosítani. Hozzon létre új kulcsot: az új kulcs minden hatókörrel rendelkezik. |
| A fájlt ToRun-könyvtárbeli azonosítóként vagy https-linkként kell megadni, nem mindkettőként | Pontosan az egyiket adja meg. |
| A fiók ToRun-könyvtárában nincs ilyen fájl | Ennek a fióknak egy fájlját használja. Egy másik fiók fájljára mutató ToRun-linket ugyanígy elutasítunk. |
| A fájl túl nagy, nem az eszköz által fogadott formátumú, vagy nem sikerült letölteni | Képek az image_edit eszközhöz: PNG, JPEG vagy WebP, legfeljebb 20 MB. Fájlok az stt_transcribe eszközhöz: mp3, m4a, wav, webm, ogg, opus, flac, aac vagy mp4, legfeljebb 25 MB. A linknek bejelentkezés nélkül letölthetőnek kell lennie. |