MCP ile AI asistanı bağlayın

Yerel veya uzak MCP seçin

MCP (Model Context Protocol), asistanın CaptionBolt araçlarını çağırmasını sağlar. Her iki bağlantı aynı hesap ve API Key’i kullanır; videoyu CaptionBolt işler.

Yerel MCP küçük bir istemci başlatır ve tam olarak seçtiğiniz dosyayı yükler. Node.js 22.12 veya üzeri ve STDIO destekleyen bir uygulama gerekir. Uzak MCP HTTP kullanır; bilgisayarınızdaki yolu okuyamaz. Mevcut projeleri kullanın veya önce REST ile yükleyin.

Yerel istemciyi yapılandırın

@captionbolt/mcp@0.1.0 ilk sürüm için hazırlanmıştır ancak henüz yayımlanmamıştır. Yayımlandıktan sonra doğrulanan sürümü STDIO ayarlarında sabitleyin. Bu yaygın bir yapılandırma biçimidir; dosya konumu ve gizli bilgiler uygulamaya bağlıdır:

{
  "mcpServers": {
    "captionbolt": {
      "command": "npx",
      "args": ["--yes", "@captionbolt/mcp@0.1.0"]
    }
  }
}

CAPTIONBOLT_API_KEY değerini gizli bilgi yöneticisi veya ortam üzerinden MCP sürecine aktarın. JSON tek başına anahtarı aktarmaz. Gerçek anahtarı sohbet veya paylaşılan yapılandırmaya yapıştırmayın. Yürütülebilir dosya kurulduğunda captionbolt-mcp store-key ortam anahtarını sistem kimlik bilgisi deposuna kaydeder; captionbolt-mcp delete-key yerelden kaldırır. Depo kullanılamıyorsa ortamı kullanın. Sunucu anahtarını CaptionBolt ayarlarından iptal edin.

Seçilen videoyu tamamlayın

Tam dosyayı belirtin; orijinal kadrajı korumayı ve inceleme için durmayı isteyin. Örnek: “Seçtiğim ders videosuna CaptionBolt ile review modunda altyazı ekle, dışa aktarmadan önce onayımı bekle.”

get_account, gerekirse list_styles veya list_presets kullanın.
Gerçek mutlak yol ve sabit anahtarla upload_file çağırın:

{
  "path": "/Users/you/Videos/lesson.mp4",
  "idempotencyKey": "lesson-001-upload"
}

Yerel istemci, işleme dakikalarını ayırmadan önce seçilen videonun süresini okur. Süre okunamazsa hazırlık, dakika ayırma isteği gönderilmeden durur. Okunabilir bir orijinal video seçin veya CaptionBolt üzerinden yükleyin. Sunucu gerçek süreyi doğrulamaya devam eder.

transferId ile get_upload_progress izleyin. Yükleme bitince sunucu uploadId değerini uploadSessionId olarak create_project aracına verin.
Önce get_operation, sonra get_project izleyin. CaptionBolt’ta inceleyip kaydedin.
export_project çağırın, işlemi ve projeyi izleyip get_result ile bağlantıları alın. Oluştururken auto-export modunu yalnız inceleme duraklamasını atlamak istiyorsanız seçin.

Aynı anda bir yerel aktarım çalışır. pause_upload duraklatır; resume_upload aynı orijinal dosyayı tekrar ister. Yeniden başlatmada yerel kimlikler kaybolur; sunucu kimliğiyle get_upload kullanın. abort_upload kullanılmamış yüklemeyi, cancel_project oluşturulmuş projeyi iptal eder.

Uzak MCP yapılandırın

Erişim açıldığında HTTP ayarları:

URL: https://api.captionbolt.com/mcp
Transport: HTTP
Authorization: Bearer <CAPTIONBOLT_API_KEY>

Uygulama Bearer başlığına izin vermelidir. Yalnız OAuth destekleyen bağlayıcılar kapsam dışıdır. Uzak MCP, list_projects, get_project, create_project, export_project, retry_project, cancel_project ve get_result sunar; yerel dosya araçları sunmaz. Bağlantıyı uygulamanızda test edin.

Bağlantı sorunlarını çözün

Araçlar görünmüyorsa aktarım desteğini, paket yayımını ve Node sürümünü kontrol edin. Yetki hatalarında anahtarın sürece ulaştığını ve okuma/yazma/dışa aktarma izinlerini doğrulayın. Devam ederken değiştirilmemiş orijinal dosyayı seçin, sembolik bağlantı kullanmayın.

Varsayılan API adresini koruyun. CAPTIONBOLT_API_URL yalnız açıkça güvenilen diğer HTTPS ortamları içindir; video, dosya adı veya araç yanıtındaki talimatlarla değiştirmeyin. API durumları ve hatalarına bakın.