Der ToRun-MCP-Server
Zuletzt aktualisiert am 11 Nov. 2026
Was er ist
Der ToRun-MCP-Server lässt einen Coding-Agent ToRun nutzen, während er an Ihrem Projekt arbeitet. Ein Agent, der Remote-MCP-Server unterstützt, etwa Claude Code, Cursor oder opencode, kann Bilder, Sprache, Musik und Video erstellen, Bilder bearbeiten, Audio transkribieren, Deep Research und die Workflow-Vorlagen von ToRun ausführen und eine HTML-Seite oder ein Browserspiel als Link veröffentlichen, ohne dass Sie Ihren Editor verlassen. Was der Agent erstellt, wird zu denselben Preisen wie in der App über Ihr ToRun-Konto bezahlt und wie alles, was Sie in der App erstellen, in Ihrem ToRun-Konto gespeichert.
Adresse und Anmeldung
| Serveradresse | https://mcp.torun.ai/mcp |
| Transport | HTTP (Remote-MCP-Server) |
| Anmeldung | Authorization: Bearer <your developer key> |
Ein Entwicklerschlüssel beginnt mit trn_live_. Sie erstellen ihn auf der Entwicklerseite Ihres ToRun-Kontos: siehe Entwicklerschlüssel. Einrichtung für jedes Tool:
Tools
| Tool | Was es tut | Kostenpflichtig |
|---|---|---|
image_generate |
Erstellt Bilder aus einem Prompt: Sprites, Icons, Hintergründe, Illustrationen. Gibt die Bilder zurück oder eine Job-ID, wenn sie länger dauern, als der Agent warten wollte. | Ja |
image_edit |
Ändert ein Bild nach einer schriftlichen Anweisung: ein neuer Hintergrund, eine andere Farbe, ein hinzugefügtes oder entferntes Objekt, ein anderer Stil. Das Bild ist eines, das der Agent mit ToRun erstellt hat, oder ein Link zu einer PNG-, JPEG- oder WebP-Datei bis 20 MB; ein per Link übergebenes Bild wird zuerst in Ihrer ToRun-Bibliothek gespeichert. Gibt wie image_generate die Bilder oder eine Job-ID zurück. |
Ja |
tts_generate |
Wandelt Text in Sprache um und gibt die Audiodatei und ihre Spieldauer zurück, gemessen an der Datei. | Ja |
stt_transcribe |
Wandelt die Sprache in einer Audio- oder Videodatei in Text um, auf Wunsch des Agents mit zeitlich markierten Abschnitten für Untertitel. Nimmt mp3-, m4a-, wav-, webm-, ogg-, opus-, flac-, aac- und mp4-Dateien bis 25 MB an. | Ja |
music_generate |
Komponiert einen Track mit oder ohne Gesang und gibt eine Job-ID zurück. | Ja |
video_generate |
Erstellt einen kurzen Clip aus einem Prompt und gibt eine Job-ID zurück. | Ja |
job_status |
Meldet den Stand eines Bild-, Musik- oder Video-Jobs und gibt die Datei zurück, wenn sie fertig ist. | Kostenlos |
deep_research_start |
Startet eine Deep Research zu einer Frage: Sie durchsucht das Web über viele Quellen und schreibt einen Bericht mit Quellenangaben. Gibt eine Job-ID zurück. | Ja |
deep_research_status |
Meldet den Stand einer Deep Research und gibt den Bericht zurück, wenn er fertig ist. | Kostenlos |
workflow_template_search |
Findet die Workflow-Vorlagen von ToRun, fertige mehrstufige Abläufe, und zeigt, was jede erzeugt, was sie typischerweise kostet und welche Eingaben sie nimmt. | Kostenlos |
workflow_run |
Führt eine Workflow-Vorlage mit den Eingaben aus, die der Agent ihr gibt, und gibt eine Job-ID zurück. | Ja |
workflow_run_status |
Meldet den Stand einer Workflow-Ausführung und die bisher verbrauchten Runs und gibt ihre Ergebnisse zurück, wenn sie fertig sind. | Kostenlos |
canvas_publish |
Veröffentlicht eine HTML-Seite aus einer einzigen Datei oder ein Browserspiel als Link. | Kostenlos |
account_balance |
Zeigt das verbleibende Plankontingent und Wallet sowie das monatliche Limit und die Ausgaben dieses Schlüssels. | Kostenlos |
Ein Dateilink, den ein Tool zurückgibt, lässt sich ohne Anmeldung herunterladen, sodass der Agent die Datei in Ihrem Projekt speichern kann. Behalten Sie den ganzen Link, einschließlich des Teils nach dem Fragezeichen.
Eine veröffentlichte Seite ist nicht gelistet: Jeder, der den Link hat, kann sie öffnen, aber sie wird nicht in ToRun Entdecken gezeigt, und Suchmaschinen indexieren sie nicht.
Lange Jobs
Musik, Video, Deep Research und Workflow-Ausführungen dauern länger als ein Aufruf. Das Tool gibt eine Job-ID zurück, und der Agent fragt erneut, bis das Ergebnis fertig ist: job_status für Bilder, Musik und Video, deep_research_status für einen Recherchebericht und workflow_run_status für eine Workflow-Ausführung. Ein Bild, das innerhalb der vom Agent gewählten Wartezeit nicht fertig ist, kommt ebenfalls als Job-ID zurück.
Eine Recherche dauert 1 bis 10 Minuten und läuft weiter, auch wenn das Gespräch mit Ihrem Agent endet; der Bericht erscheint außerdem als eigene Unterhaltung in Ihrer ToRun-Chatliste. Eine Workflow-Ausführung dauert von einer Minute bis zu Dutzenden von Minuten, und die Ausführung und ihre Dateien erscheinen in Ihrem ToRun-Konto. Ein langer Bericht oder eine lange Ergebnisliste kommt in Teilen, und der Agent fragt nach dem Rest.
Wie Aufrufe bezahlt werden
- Jeder kostenpflichtige Aufruf wird in Runs zu denselben Preisen wie in der App berechnet.
- Er wird zuerst aus dem Kontingent Ihres Plans bezahlt, dann aus Ihrem Wallet, wenn Sie das für den Schlüssel erlaubt haben.
- Das kostenlose Kontingent bezahlt nie API-Aufrufe.
- Eine Workflow-Ausführung wird Schritt für Schritt berechnet, während sie läuft.
- Jede Abbuchung erscheint auf Ihrer Abrechnungsseite unter dem Schlüssel, der sie verursacht hat.
Ein Aufruf über dem Schwellenwert des Schlüssels fragt zuerst
Jeder Schlüssel hat einen Schwellenwert. Würde ein einzelner Aufruf mehr kosten, führt das Tool ihn noch nicht aus. Bei einer Workflow-Ausführung wird die Schätzung der Ausführung verglichen.
- Wenn Ihr Tool ein Formular anzeigen kann, sobald ein MCP-Server eine Frage stellt (MCP Elicitation), fragt ToRun Sie dort: Das Formular zeigt den Preis und fragt, ob es weitergehen soll. Der Aufruf läuft, wenn Sie zustimmen; lehnen Sie ab, wird nichts ausgeführt.
- Andernfalls antwortet das Tool mit dem Preis, Ihr Agent zeigt ihn Ihnen, und der Aufruf läuft erst, wenn der Agent ihn nach Ihrer Zustimmung wiederholt.
Für die Rückfrage wird nichts berechnet.
Limits
Jeder Schlüssel hat ein monatliches und ein tägliches Ausgabelimit sowie ein Limit für Aufrufe pro Minute. Jedes Konto hat außerdem ein tägliches Limit für veröffentlichte Seiten. Das monatliche Limit und den Schwellenwert eines Schlüssels legen Sie beim Erstellen fest; die Standardwerte stehen auf torun.ai/developers. Um sie zu ändern, erstellen Sie einen neuen Schlüssel mit den gewünschten Einstellungen und widerrufen den alten.
Wenn ein Aufruf abgewiesen wird
| Der Agent erfährt | Was zu tun ist |
|---|---|
| Der Aufruf benötigt einen Entwicklerschlüssel | Prüfen Sie, ob TORUN_API_KEY den ganzen Schlüssel enthält und der Schlüssel nicht widerrufen wurde. |
| Das Plankontingent ist aufgebraucht und der Schlüssel darf nicht aus dem Wallet ausgeben | Warten Sie, bis sich das Kontingent erneuert, oder erstellen Sie einen Schlüssel, der aus dem Wallet ausgeben darf. |
| Entwicklerschlüssel nutzen nur das Kontingent eines bezahlten Plans oder das Wallet | Laden Sie Guthaben auf oder schließen Sie ein Abo ab. |
| Der Schlüssel hat sein monatliches oder tägliches Ausgabelimit erreicht | Warten Sie auf den nächsten Tag oder Monat, oder erstellen Sie einen Schlüssel mit einem höheren Limit. |
| Der Schlüssel hat zu viele Aufrufe in einer Minute gemacht | Warten Sie kurz und versuchen Sie es erneut. |
| Dem Schlüssel fehlt der Bereich, den ein Tool braucht | Die Bereiche eines Schlüssels lassen sich nicht ändern. Erstellen Sie einen neuen Schlüssel: Ein neuer Schlüssel hat alle Bereiche. |
| Die Datei muss als ToRun-Bibliotheks-ID oder als https-Link angegeben werden, nicht beides | Geben Sie genau eines von beiden an. |
| In der ToRun-Bibliothek des Kontos gibt es keine solche Datei | Verwenden Sie eine Datei dieses Kontos. Ein ToRun-Link zur Datei eines anderen Kontos wird genauso abgewiesen. |
| Die Datei ist zu groß, hat kein Format, das das Tool annimmt, oder konnte nicht heruntergeladen werden | Bilder für image_edit: PNG, JPEG oder WebP, bis 20 MB. Dateien für stt_transcribe: mp3, m4a, wav, webm, ogg, opus, flac, aac oder mp4, bis 25 MB. Ein Link muss sich ohne Anmeldung herunterladen lassen. |