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.
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_projects | Projeleriniz, en yeniden eskiye. |
get_project | Bir proje, dosyasının durumu ve dublajlarıyla. |
create_project | Her hedef dil için bir dublajı olan bir proje oluşturur. |
start_upload | Dosyanın yüklemesini açar ve ilk parçaların adreslerini verir. |
get_upload_part_urls | Diğer parçalar için adresler veya başarısız olan parçalar için yenileri. |
complete_upload | Yüklemeyi bitirir; ardından dosya kontrol edilir. |
start_dub | Bir dublaj başlatır. Kredi harcar. |
get_job | Bir işin durumu ve ilerlemesi. |
get_dub | Bir dublaj ve üzerinde çalışan son iş. |
get_segments | Dublajın segmentleri: süreler, metinler ve uyarılar. Yalnızca uyarılı veya düzenlenmiş olanları gösterebilir. |
edit_segment | Bir segment için yeni bir metin kaydeder. |
quote_regeneration | Bazı segmentleri yeniden oluşturmanın maliyeti. |
regenerate_segments | Segmentleri kayıtlı metinleriyle yeniden oluşturur. Kredi harcar. |
finish_dub | Düzenlemeyi bitirir ve indirmeleri açar. |
get_download_links | Dublaj dosyalarının bağlantıları, 5 dakika geçerli. |
get_subtitles | Altyazılar metin olarak, SRT veya WebVTT biçiminde. |
delete_project | Bir 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.