Belge menüsü

MCP sunucusu

MCP sunucusu, bir yapay zekâ asistanının Evocal hesabınızda çalışmasını sağlar: video göndermek, dublajı başlatmak, segmentleri kontrol edip düzeltmek ve dosyaları indirmek. API anahtarınızı kullanır; krediler ve kurallar uygulamadakiyle aynıdır.

Güncelleme: 20 Kas 2026

Başlamadan önce

  • MCP sunucusu, API gibi Pro, Studio ve Enterprise planlarına dahildir.
  • Uygulamada Hesap, API bölümünden bir anahtar oluşturun. Asistana kendine ait bir anahtar verin; böylece başka hiçbir şeyi durdurmadan onu iptal edebilirsiniz.
  • Asistanınız, başlık içeren uzak bir MCP sunucusu eklemenize izin vermelidir. Terminalde çalışan ajanlar ve kod editörleri buna izin verir; yalnızca oturum açarak bağlanan sohbet uygulamaları henüz kullanamaz.

Bağlanma

Sunucunun adresi https://www.evocal.app/api/mcp (Streamable HTTP). Anahtarı Authorization başlığında alır. Örneğin Claude Code’da:

claude mcp add --transport http evocal https://www.evocal.app/api/mcp \
  --header "Authorization: Bearer evk_..."

Sunucularını bir JSON dosyasında tutan editörler bunun gibi bir girdi alır. Dosyanın adı ve tam biçimi için editörünüzün kılavuzuna bakın.

{
  "mcpServers": {
    "evocal": {
      "url": "https://www.evocal.app/api/mcp",
      "headers": { "Authorization": "Bearer evk_..." }
    }
  }
}

Sonra örneğin şunu isteyin: “lesson-4.mp4’ü Portekizceden İngilizceye dublajla, başlamadan önce ne kadar tutacağını söyle.”

Asistanın yapabilecekleri

AraçNe yapar
get_accountŞu anki plan ve krediler.
list_languagesŞu an açık olan dil çiftleri.
list_projectsProjeleriniz, en yeniden eskiye.
get_projectBir proje, dosyasının durumu ve dublajlarıyla.
create_projectHer hedef dil için bir dublajı olan bir proje oluşturur.
start_uploadDosyanın yüklemesini açar ve ilk parçaların adreslerini verir.
get_upload_part_urlsDiğer parçalar için adresler veya başarısız olan parçalar için yenileri.
complete_uploadYüklemeyi bitirir; ardından dosya kontrol edilir.
start_dubBir dublaj başlatır. Kredi harcar.
get_jobBir işin durumu ve ilerlemesi.
get_dubBir dublaj ve üzerinde çalışan son iş.
get_segmentsDublajın segmentleri: süreler, metinler ve uyarılar. Yalnızca uyarılı veya düzenlenmiş olanları gösterebilir.
edit_segmentBir segment için yeni bir metin kaydeder.
quote_regenerationBazı segmentleri yeniden oluşturmanın maliyeti.
regenerate_segmentsSegmentleri kayıtlı metinleriyle yeniden oluşturur. Kredi harcar.
finish_dubDüzenlemeyi bitirir ve indirmeleri açar.
get_download_linksDublaj dosyalarının bağlantıları, 5 dakika geçerli.
get_subtitlesAltyazılar metin olarak, SRT veya WebVTT biçiminde.
delete_projectBir projeyi dosyaları ve dublajlarıyla birlikte siler.

Dosyayı gönderme

Asistan dosyayı bilgisayarınızda okur ve parçalar halinde gönderir; bu yüzden dosyanın bulunduğu yerde, bir terminalle ya da dosyalarınıza erişimle çalışması gerekir. Dosyayı part_size baytlık parçalara böler ve her birini PUT ile kendi adresine gönderir.

Dosyalarınıza erişemeyen bir asistan da uygulamada gönderdiğiniz projeler üzerinde çalışabilir: segmentleri okur, düzeltir, yeniden oluşturur ve indirir.

Krediler ve güvenlik

  • Asistan kredilerinizi harcar: bir dublaj video saniyesi başına bir kredi (en az 30), bir yeniden oluşturma ise segmentlerinin saniyeleri kadar (en az 15) tutar. Sunucu ona, ikisinden önce de maliyeti size söylemesini ve onayınızı beklemesini söyler; ama anahtarınızla yapılan her çağrıdan siz sorumlusunuz.
  • Bir dublajı bitirmek ve bir projeyi silmek geri alınamaz. Asistana önce size sorması söylenir.
  • Her dosya uygulamadakiyle aynı kurallara uyar: yalnızca size ait olan veya konuşan kişilerin yazılı izin verdiği sesleri gönderin. Anahtarın ses onayı her dosyayı kapsar.
  • Çağrıları API’nin sınırlarına sayılır: tüm hesap için dakikada 120, saatte 3.600.
  • Asistan, API’nin gösterdiklerini görür: projeleriniz, dublajlarınız, segmentleriniz ve kredileriniz. Anahtar sızarsa Hesap, API bölümünden iptal edin.

Bunları da okuyun