Serwer MCP ToRun
Ostatnia aktualizacja: 11 lis 2026
Co to jest
Serwer MCP ToRun pozwala agentowi programistycznemu korzystać z ToRun podczas pracy nad Twoim projektem. Agent obsługujący zdalne serwery MCP, taki jak Claude Code, Cursor czy opencode, może tworzyć obrazy, mowę, muzykę i wideo, edytować obrazy, transkrybować audio, uruchamiać dogłębne badania i szablony przepływów pracy ToRun oraz publikować stronę HTML lub grę przeglądarkową jako link, a Ty nie musisz opuszczać edytora. To, co tworzy agent, jest opłacane z Twojego konta ToRun po tych samych cenach co w aplikacji i zapisywane na Twoim koncie ToRun jak wszystko, co tworzysz w aplikacji.
Adres i logowanie
| Adres serwera | https://mcp.torun.ai/mcp |
| Transport | HTTP (zdalny serwer MCP) |
| Logowanie | Authorization: Bearer <your developer key> |
Klucz programisty zaczyna się od trn_live_. Tworzysz go na stronie Dla programistów na swoim koncie ToRun: zobacz Klucze programisty. Konfiguracja dla każdego narzędzia:
Narzędzia
| Narzędzie | Co robi | Płatne |
|---|---|---|
image_generate |
Tworzy obrazy na podstawie promptu: sprite'y, ikony, tła, ilustracje. Zwraca obrazy albo identyfikator zadania, gdy trwa to dłużej, niż agent zdecydował się czekać. | Tak |
image_edit |
Zmienia obraz według pisemnej instrukcji: nowe tło, inny kolor, dodany lub usunięty obiekt, inny styl. Obraz to taki, który agent zrobił w ToRun, albo link do pliku PNG, JPEG lub WebP o rozmiarze do 20 MB; obraz podany linkiem jest najpierw zapisywany w Twojej bibliotece ToRun. Zwraca obrazy albo identyfikator zadania, tak jak image_generate. |
Tak |
tts_generate |
Zamienia tekst na mowę i zwraca plik audio oraz czas jego odtwarzania, zmierzony na podstawie pliku. | Tak |
stt_transcribe |
Zamienia mowę z pliku audio lub wideo na tekst, z fragmentami z oznaczeniem czasu do napisów, gdy agent o nie poprosi. Przyjmuje pliki mp3, m4a, wav, webm, ogg, opus, flac, aac i mp4 o rozmiarze do 25 MB. | Tak |
music_generate |
Komponuje utwór, z wokalem lub bez, i zwraca identyfikator zadania. | Tak |
video_generate |
Tworzy krótki klip na podstawie promptu i zwraca identyfikator zadania. | Tak |
job_status |
Informuje o postępie zadania obrazu, muzyki lub wideo i zwraca plik, gdy jest gotowy. | Bezpłatne |
deep_research_start |
Uruchamia dogłębne badanie na zadane pytanie: przeszukuje internet w wielu źródłach i pisze raport z cytowanymi źródłami. Zwraca identyfikator zadania. | Tak |
deep_research_status |
Informuje o postępie dogłębnego badania i zwraca raport, gdy jest gotowy. | Bezpłatne |
workflow_template_search |
Wyszukuje szablony przepływów pracy ToRun, czyli gotowe wieloetapowe potoki, i pokazuje, co każdy z nich zwraca, ile zwykle kosztuje i jakie dane wejściowe przyjmuje. | Bezpłatne |
workflow_run |
Uruchamia szablon przepływu pracy z danymi wejściowymi od agenta i zwraca identyfikator zadania. | Tak |
workflow_run_status |
Informuje o postępie przebiegu przepływu pracy i o tym, ile Runs już kosztował, i zwraca wyniki, gdy są gotowe. | Bezpłatne |
canvas_publish |
Publikuje jako link jednoplikową stronę HTML lub grę przeglądarkową. | Bezpłatne |
account_balance |
Pokazuje, ile zostało w limicie planu i w portfelu, oraz miesięczny limit i wydatki tego klucza. | Bezpłatne |
Link do pliku zwrócony przez narzędzie da się pobrać bez logowania, więc agent może zapisać plik w Twoim projekcie. Zachowaj cały link, łącznie z częścią po znaku zapytania.
Opublikowana strona jest niepubliczna: każdy, kto ma link, może ją otworzyć, ale nie jest pokazywana w sekcji Odkrywaj w ToRun, a wyszukiwarki jej nie indeksują.
Długie zadania
Muzyka, wideo, dogłębne badania i przebiegi przepływów pracy trwają dłużej niż jedno wywołanie. Narzędzie zwraca identyfikator zadania, a agent pyta ponownie, aż wynik będzie gotowy: job_status dla obrazów, muzyki i wideo, deep_research_status dla raportu z badania i workflow_run_status dla przebiegu przepływu pracy. Obraz, który nie jest gotowy w czasie oczekiwania wybranym przez agenta, również wraca jako identyfikator zadania.
Badanie trwa od 1 do 10 minut i trwa dalej, nawet jeśli rozmowa z agentem się zakończy; raport pojawia się też jako osobna rozmowa na Twojej liście czatów ToRun. Przebieg przepływu pracy trwa od minuty do kilkudziesięciu minut, a sam przebieg i jego pliki pojawiają się na Twoim koncie ToRun. Długi raport lub długi zestaw wyników przychodzi w częściach, a agent prosi o resztę.
Jak opłacane są wywołania
- Każde płatne wywołanie jest rozliczane w Runs po tych samych cenach co w aplikacji.
- Najpierw jest opłacane z limitu Twojego planu, potem z portfela, jeśli zezwoliłeś na to w kluczu.
- Darmowy limit nigdy nie opłaca wywołań API.
- Przebieg przepływu pracy jest rozliczany krok po kroku w trakcie działania.
- Każde obciążenie pojawia się na Twojej stronie rozliczeń pod kluczem, który je wykonał.
Wywołanie powyżej progu klucza najpierw pyta
Każdy klucz ma próg. Gdy pojedyncze wywołanie kosztowałoby więcej, narzędzie jeszcze go nie wykonuje. W przypadku przebiegu przepływu pracy porównywany jest jego szacowany koszt.
- Jeśli Twoje narzędzie potrafi pokazać formularz, gdy serwer MCP zadaje pytanie (MCP elicitation), ToRun pyta Cię tam: formularz pokazuje cenę i pyta, czy kontynuować. Wywołanie jest wykonywane, jeśli się zgodzisz; jeśli odmówisz, nic nie zostaje uruchomione.
- W przeciwnym razie narzędzie odpowiada ceną, agent Ci ją pokazuje, a wywołanie jest wykonywane dopiero wtedy, gdy agent powtórzy je po Twojej zgodzie.
Za samo pytanie nic nie jest pobierane.
Limity
Każdy klucz ma miesięczny i dzienny limit wydatków oraz limit wywołań na minutę. Każde konto ma też dzienny limit opublikowanych stron. Miesięczny limit i próg klucza ustawiasz przy jego tworzeniu; wartości domyślne są podane na torun.ai/developers. Aby je zmienić, utwórz nowy klucz z wybranymi ustawieniami i unieważnij stary.
Gdy wywołanie zostaje odrzucone
| Agent dostaje komunikat | Co zrobić |
|---|---|
| Wywołanie wymaga klucza programisty | Sprawdź, czy TORUN_API_KEY zawiera cały klucz i czy klucz nie został unieważniony. |
| Limit planu się wyczerpał, a klucz nie może wydawać z portfela | Poczekaj, aż limit się odnowi, albo utwórz klucz, który może wydawać z portfela. |
| Klucze programisty wydają tylko limit płatnego planu albo portfel | Doładuj konto lub wykup subskrypcję. |
| Klucz osiągnął miesięczny lub dzienny limit wydatków | Poczekaj do następnego dnia lub miesiąca albo utwórz klucz z wyższym limitem. |
| Klucz wykonał zbyt wiele wywołań w ciągu minuty | Poczekaj chwilę i spróbuj ponownie. |
| Klucz nie ma zakresu, którego potrzebuje narzędzie | Zakresów klucza nie można zmienić. Utwórz nowy klucz: nowy klucz ma wszystkie zakresy. |
| Plik musi być podany jako identyfikator z biblioteki ToRun albo jako link https, nie oba naraz | Podaj dokładnie jedno z nich. |
| W bibliotece ToRun tego konta nie ma takiego pliku | Użyj pliku z tego konta. Link ToRun do pliku innego konta jest odrzucany tak samo. |
| Plik jest za duży, nie jest w formacie, który przyjmuje narzędzie, albo nie dało się go pobrać | Obrazy dla image_edit: PNG, JPEG lub WebP, do 20 MB. Pliki dla stt_transcribe: mp3, m4a, wav, webm, ogg, opus, flac, aac lub mp4, do 25 MB. Link musi dać się pobrać bez logowania. |