ToRun MCP sunucusu
Son güncelleme: 11 Kas 2026
Nedir
ToRun MCP sunucusu, bir kodlama ajanının projeniz üzerinde çalışırken ToRun'u kullanmasını sağlar. Claude Code, Cursor veya opencode gibi uzak MCP sunucularını destekleyen bir ajan; görsel, ses, müzik ve video üretebilir, görselleri düzenleyebilir, ses yazıya dökebilir, derin araştırma ve ToRun'un iş akışı şablonlarını çalıştırabilir ve bir HTML sayfasını ya da tarayıcı oyununu bağlantı olarak yayımlayabilir; üstelik siz editörünüzden hiç çıkmadan. Ajanın ürettikleri uygulamadaki fiyatlarla ToRun hesabınızdan ödenir ve uygulamada ürettiğiniz her şey gibi ToRun hesabınıza kaydedilir.
Adres ve oturum açma
| Sunucu adresi | https://mcp.torun.ai/mcp |
| Aktarım | HTTP (uzak MCP sunucusu) |
| Oturum açma | Authorization: Bearer <your developer key> |
Geliştirici anahtarı trn_live_ ile başlar. Anahtarı ToRun hesabınızın Geliştiriciler sayfasında oluşturursunuz: bkz. Geliştirici anahtarları. Her aracın kurulumu:
Araçlar
| Araç | Ne yapar | Ücretli |
|---|---|---|
image_generate |
Bir istemden görsel üretir: sprite, simge, arka plan, illüstrasyon. Görselleri döndürür; ajanın beklemeyi seçtiği süreden uzun sürerse bir iş kimliği döndürür. | Evet |
image_edit |
Bir görseli yazılı bir talimata göre değiştirir: yeni bir arka plan, başka bir renk, eklenen ya da kaldırılan bir nesne, başka bir stil. Görsel, ajanın ToRun ile ürettiği bir görsel ya da 20 MB'a kadar bir PNG, JPEG veya WebP dosyasının bağlantısıdır; bağlantıyla verilen bir görsel önce ToRun kütüphanenize kaydedilir. image_generate gibi görselleri ya da bir iş kimliğini döndürür. |
Evet |
tts_generate |
Metni konuşmaya dönüştürür; ses dosyasını ve dosyadan ölçülen çalma süresini döndürür. | Evet |
stt_transcribe |
Bir ses ya da video dosyasındaki konuşmayı metne dönüştürür; ajan isterse alt yazı için zamanlanmış bölümler de verir. 25 MB'a kadar mp3, m4a, wav, webm, ogg, opus, flac, aac ve mp4 dosyalarını kabul eder. | Evet |
music_generate |
Vokalli ya da vokalsiz bir parça besteler ve bir iş kimliği döndürür. | Evet |
video_generate |
Bir istemden kısa bir klip üretir ve bir iş kimliği döndürür. | Evet |
job_status |
Bir görsel, müzik ya da video işinin durumunu bildirir ve hazır olduğunda dosyayı döndürür. | Ücretsiz |
deep_research_start |
Bir soru üzerine derin araştırma başlatır: web'de birçok kaynakta arama yapar ve kaynakları belirtilmiş bir rapor yazar. Bir iş kimliği döndürür. | Evet |
deep_research_status |
Bir derin araştırmanın durumunu bildirir ve hazır olduğunda raporu döndürür. | Ücretsiz |
workflow_template_search |
ToRun'un iş akışı şablonlarını, yani hazır çok adımlı akışları bulur; her birinin ne ürettiğini, genellikle ne kadara mal olduğunu ve hangi girdileri aldığını gösterir. | Ücretsiz |
workflow_run |
Bir iş akışı şablonunu ajanın verdiği girdilerle çalıştırır ve bir iş kimliği döndürür. | Evet |
workflow_run_status |
Bir iş akışı çalıştırmasının durumunu ve şimdiye kadar kaç Runs tuttuğunu bildirir; hazır olduğunda sonuçlarını döndürür. | Ücretsiz |
canvas_publish |
Tek dosyalık bir HTML sayfasını ya da tarayıcı oyununu bağlantı olarak yayımlar. | Ücretsiz |
account_balance |
Kalan plan payını ve cüzdanı, bu anahtarın aylık sınırını ve harcamasını gösterir. | Ücretsiz |
Bir aracın döndürdüğü dosya bağlantısı oturum açmadan indirilir; böylece ajan dosyayı projenize kaydedebilir. Soru işaretinden sonraki kısım da dahil olmak üzere bağlantının tamamını koruyun.
Yayımlanan bir sayfa listelenmez: bağlantıya sahip olan herkes açabilir, ancak ToRun Keşfet'te gösterilmez ve arama motorları onu dizine eklemez.
Uzun işler
Müzik, video, derin araştırma ve iş akışı çalıştırmaları tek bir çağrıdan uzun sürer. Araç bir iş kimliği döndürür ve ajan sonuç hazır olana kadar yeniden sorar: görsel, müzik ve video için job_status, araştırma raporu için deep_research_status, iş akışı çalıştırması için workflow_run_status. Ajanın seçtiği bekleme süresi içinde hazır olmayan bir görsel de iş kimliği olarak döner.
Bir araştırma 1 ila 10 dakika sürer ve ajanınızla olan konuşma bitse bile devam eder; rapor ayrıca ToRun sohbet listenizde ayrı bir konuşma olarak görünür. Bir iş akışı çalıştırması bir dakikadan onlarca dakikaya kadar sürer; çalıştırma ve dosyaları ToRun hesabınızda görünür. Uzun bir rapor ya da uzun bir sonuç kümesi parçalar halinde gelir ve ajan geri kalanını ister.
Çağrılar nasıl ödenir
- Her ücretli çağrı uygulamadaki fiyatlarla Runs olarak ücretlendirilir.
- Önce planınızın payından, anahtarda buna izin verdiyseniz ardından cüzdanınızdan ödenir.
- Ücretsiz pay API çağrılarını hiçbir zaman ödemez.
- Bir iş akışı çalıştırması çalıştığı sürece adım adım ücretlendirilir.
- Her ücret, faturalama sayfanızda onu yapan anahtarın altında görünür.
Anahtarın eşiğini aşan bir çağrı önce sorar
Her anahtarın bir eşiği vardır. Tek bir çağrı bundan daha pahalıya mal olacaksa araç onu henüz çalıştırmaz. Bir iş akışı çalıştırmasında karşılaştırılan, çalıştırmanın tahminidir.
- Aracınız bir MCP sunucusu soru sorduğunda form gösterebiliyorsa (MCP elicitation), ToRun size orada sorar: form fiyatı gösterir ve devam edilip edilmeyeceğini sorar. Evet derseniz çağrı çalışır; reddederseniz hiçbir şey çalıştırılmaz.
- Aksi halde araç fiyatı söyler, ajanınız bunu size gösterir ve çağrı yalnızca siz onay verdikten sonra ajan onu yinelediğinde çalışır.
Sormak için hiçbir ücret alınmaz.
Sınırlar
Her anahtarın aylık ve günlük bir harcama sınırı ile dakika başına çağrı sınırı vardır. Her hesabın ayrıca yayımlanan sayfalar için günlük bir sınırı vardır. Bir anahtarın aylık sınırını ve eşiğini oluştururken belirlersiniz; varsayılanlar torun.ai/developers sayfasında listelenir. Bunları değiştirmek için istediğiniz ayarlarla yeni bir anahtar oluşturun ve eskisini iptal edin.
Bir çağrı reddedildiğinde
| Ajana söylenen | Ne yapmalı |
|---|---|
| Çağrı bir geliştirici anahtarı gerektiriyor | TORUN_API_KEY değişkeninin anahtarın tamamını içerdiğini ve anahtarın iptal edilmediğini kontrol edin. |
| Plan payı bitti ve anahtarın cüzdandan harcamasına izin yok | Payın yenilenmesini bekleyin ya da cüzdandan harcayabilen bir anahtar oluşturun. |
| Geliştirici anahtarları yalnızca ücretli planın payını ya da cüzdanı harcar | Bakiye yükleyin ya da abone olun. |
| Anahtar aylık ya da günlük harcama sınırına ulaştı | Ertesi günü ya da ayı bekleyin veya daha yüksek sınırlı bir anahtar oluşturun. |
| Anahtar bir dakikada çok fazla çağrı yaptı | Biraz bekleyip tekrar deneyin. |
| Anahtarda bir aracın ihtiyaç duyduğu kapsam yok | Bir anahtarın kapsamları değiştirilemez. Yeni bir anahtar oluşturun: yeni bir anahtar tüm kapsamları taşır. |
| Dosya, ToRun kütüphane kimliği ya da https bağlantısı olarak verilmeli, ikisi birden değil | İkisinden yalnızca birini verin. |
| Hesabın ToRun kütüphanesinde böyle bir dosya yok | Bu hesaba ait bir dosya kullanın. Başka bir hesabın dosyasına giden bir ToRun bağlantısı da aynı şekilde reddedilir. |
| Dosya çok büyük, aracın kabul ettiği bir biçimde değil ya da indirilemedi | image_edit için görseller: PNG, JPEG veya WebP, en fazla 20 MB. stt_transcribe için dosyalar: mp3, m4a, wav, webm, ogg, opus, flac, aac veya mp4, en fazla 25 MB. Bağlantı oturum açmadan indirilebilmelidir. |