ToRunin MCP-palvelin
Viimeksi päivitetty 11 marrask. 2026
Mikä se on
ToRunin MCP-palvelimen avulla koodausagentti voi käyttää ToRunia työskennellessään projektisi parissa. Etä-MCP-palvelimia tukeva agentti, kuten Claude Code, Cursor tai opencode, voi luoda kuvia, puhetta, musiikkia ja videota, muokata kuvia, litteroida ääntä, ajaa syvätutkimusta ja ToRunin työnkulkumalleja sekä julkaista HTML-sivun tai selainpelin linkkinä ilman, että sinun tarvitsee poistua editorista. Se, mitä agentti luo, maksetaan ToRun-tililtäsi samoilla hinnoilla kuin sovelluksessa, ja se tallentuu ToRun-tilillesi kuten kaikki, mitä luot sovelluksessa.
Osoite ja kirjautuminen
| Palvelimen osoite | https://mcp.torun.ai/mcp |
| Siirtotapa | HTTP (etä-MCP-palvelin) |
| Kirjautuminen | Authorization: Bearer <your developer key> |
Kehittäjäavain alkaa merkeillä trn_live_. Luot sen ToRun-tilisi Kehittäjille-sivulla: katso Kehittäjäavaimet. Kunkin työkalun asetukset:
Työkalut
| Työkalu | Mitä se tekee | Maksullinen |
|---|---|---|
image_generate |
Luo kuvia kehotteesta: spritejä, kuvakkeita, taustoja, kuvituksia. Palauttaa kuvat tai työn tunnisteen, kun niiden luonti kestää kauemmin kuin agentti päätti odottaa. | Kyllä |
image_edit |
Muuttaa kuvaa kirjallisen ohjeen perusteella: uusi tausta, eri väri, lisätty tai poistettu kohde, eri tyyli. Kuva on agentin ToRunilla luoma kuva tai linkki enintään 20 Mt:n PNG-, JPEG- tai WebP-tiedostoon; linkillä annettu kuva tallennetaan ensin ToRun-kirjastoosi. Palauttaa kuvat tai työn tunnisteen, kuten image_generate. |
Kyllä |
tts_generate |
Muuttaa tekstin puheeksi ja palauttaa äänitiedoston ja sen toistoajan tiedostosta mitattuna. | Kyllä |
stt_transcribe |
Muuttaa ääni- tai videotiedoston puheen tekstiksi, ja agentin pyynnöstä myös ajastetut jaksot tekstityksiä varten. Hyväksyy enintään 25 Mt:n mp3-, m4a-, wav-, webm-, ogg-, opus-, flac-, aac- ja mp4-tiedostot. | Kyllä |
music_generate |
Säveltää kappaleen laulun kanssa tai ilman ja palauttaa työn tunnisteen. | Kyllä |
video_generate |
Luo lyhyen leikkeen kehotteesta ja palauttaa työn tunnisteen. | Kyllä |
job_status |
Kertoo kuva-, musiikki- tai videotyön edistymisestä ja palauttaa tiedoston, kun se on valmis. | Maksuton |
deep_research_start |
Aloittaa syvätutkimuksen kysymyksestä: se hakee verkosta monista lähteistä ja kirjoittaa raportin lähteet mainiten. Palauttaa työn tunnisteen. | Kyllä |
deep_research_status |
Kertoo syvätutkimuksen edistymisestä ja palauttaa raportin, kun se on valmis. | Maksuton |
workflow_template_search |
Etsii ToRunin työnkulkumalleja eli valmiita monivaiheisia prosesseja ja näyttää, mitä kukin tuottaa, mitä se tyypillisesti maksaa ja mitä syötteitä se ottaa. | Maksuton |
workflow_run |
Ajaa työnkulkumallin agentin antamilla syötteillä ja palauttaa työn tunnisteen. | Kyllä |
workflow_run_status |
Kertoo työnkulun ajon edistymisestä ja siitä, montako Runs-yksikköä se on tähän mennessä maksanut, ja palauttaa tulokset, kun ne ovat valmiit. | Maksuton |
canvas_publish |
Julkaisee yhden tiedoston HTML-sivun tai selainpelin linkkinä. | Maksuton |
account_balance |
Näyttää jäljellä olevan tilauksen kiintiön ja lompakon sekä tämän avaimen kuukausirajan ja käytön. | Maksuton |
Työkalun palauttama tiedostolinkki latautuu ilman kirjautumista, joten agentti voi tallentaa tiedoston projektiisi. Säilytä koko linkki, myös kysymysmerkin jälkeinen osa.
Julkaistu sivu on listaamaton: kuka tahansa, jolla on linkki, voi avata sen, mutta sitä ei näytetä ToRunin Tutki-osiossa, eivätkä hakukoneet indeksoi sitä.
Pitkät työt
Musiikki, video, syvätutkimus ja työnkulkujen ajot kestävät kauemmin kuin yksi kutsu. Työkalu palauttaa työn tunnisteen, ja agentti kysyy uudelleen, kunnes tulos on valmis: job_status kuville, musiikille ja videolle, deep_research_status tutkimusraportille ja workflow_run_status työnkulun ajolle. Myös kuva, joka ei valmistu agentin valitseman odotusajan kuluessa, palautuu työn tunnisteena.
Tutkimus kestää 1–10 minuuttia ja jatkuu, vaikka keskustelu agentin kanssa päättyisi; raportti näkyy myös omana keskustelunaan ToRunin keskusteluluettelossasi. Työnkulun ajo kestää minuutista kymmeniin minuutteihin, ja ajo tiedostoineen näkyy ToRun-tililläsi. Pitkä raportti tai pitkä tulosjoukko saapuu osina, ja agentti pyytää loput.
Miten kutsut maksetaan
- Jokainen maksullinen kutsu veloitetaan Runs-yksiköinä samoilla hinnoilla kuin sovelluksessa.
- Se maksetaan ensin tilauksesi kiintiöstä ja sitten lompakostasi, jos olet sallinut sen avaimelle.
- Ilmainen kiintiö ei koskaan maksa API-kutsuja.
- Työnkulun ajo veloitetaan vaihe vaiheelta sen edetessä.
- Jokainen veloitus näkyy laskutussivullasi sen avaimen alla, joka sen teki.
Avaimen kynnyksen ylittävä kutsu kysyy ensin
Jokaisella avaimella on kynnys. Kun yksittäinen kutsu maksaisi enemmän, työkalu ei vielä suorita sitä. Työnkulun ajossa verrataan ajon arviota.
- Jos työkalusi pystyy näyttämään lomakkeen, kun MCP-palvelin esittää kysymyksen (MCP elicitation), ToRun kysyy sinulta siellä: lomake näyttää hinnan ja kysyy, jatketaanko. Kutsu suoritetaan, jos hyväksyt; jos kieltäydyt, mitään ei ajeta.
- Muuten työkalu vastaa hinnalla, agenttisi näyttää sen sinulle, ja kutsu suoritetaan vasta, kun agentti toistaa sen suostumuksesi jälkeen.
Kysymisestä ei veloiteta mitään.
Rajat
Jokaisella avaimella on kuukausittainen ja päivittäinen käyttöraja sekä minuuttikohtainen kutsuraja. Jokaisella tilillä on myös päivittäinen raja julkaistuille sivuille. Avaimen kuukausirajan ja kynnyksen asetat, kun luot sen; oletusarvot on lueteltu osoitteessa torun.ai/developers. Muuttaaksesi niitä luo uusi avain haluamillasi asetuksilla ja peru vanha.
Kun kutsu hylätään
| Mitä agentille kerrotaan | Mitä tehdä |
|---|---|
| Kutsu vaatii kehittäjäavaimen | Tarkista, että TORUN_API_KEY sisältää koko avaimen ja ettei avainta ole peruttu. |
| Tilauksen kiintiö on käytetty, eikä avain saa käyttää lompakkoa | Odota, että kiintiö uusiutuu, tai luo avain, joka saa käyttää lompakkoa. |
| Kehittäjäavaimet käyttävät vain maksullisen tilauksen kiintiötä tai lompakkoa | Lisää saldoa tai tilaa. |
| Avain on saavuttanut kuukausittaisen tai päivittäisen käyttörajansa | Odota seuraavaan päivään tai kuukauteen tai luo avain, jolla on korkeampi raja. |
| Avain teki liian monta kutsua minuutissa | Odota hetki ja yritä uudelleen. |
| Avaimella ei ole työkalun tarvitsemaa käyttöoikeusaluetta | Avaimen käyttöoikeusalueita ei voi muuttaa. Luo uusi avain: uudella avaimella on kaikki käyttöoikeusalueet. |
| Tiedosto on annettava ToRun-kirjaston tunnisteena tai https-linkkinä, ei molempina | Anna tasan toinen niistä. |
| Tilin ToRun-kirjastossa ei ole tällaista tiedostoa | Käytä tämän tilin tiedostoa. ToRun-linkki toisen tilin tiedostoon hylätään samalla tavalla. |
| Tiedosto on liian suuri, ei ole työkalun hyväksymässä muodossa tai sitä ei voitu ladata | Kuvat image_edit-työkalulle: PNG, JPEG tai WebP, enintään 20 Mt. Tiedostot stt_transcribe-työkalulle: mp3, m4a, wav, webm, ogg, opus, flac, aac tai mp4, enintään 25 Mt. Linkin on latauduttava ilman kirjautumista. |