AI asistanını MCP ile bağlayın

AI asistanınızı bağlayın

Set up CaptionBolt's local MCP server for me and connect my account. Do the steps you can perform instead of only explaining them, and reply in the language I use in this conversation.

Facts:
- Server name: captionbolt. It is a local STDIO MCP server started with the command npx and the arguments --yes @captionbolt/mcp@0.3.3
- It must run on the computer that has my videos and my browser; WSL on that computer counts. It needs Node.js 22.12 or later and an active CaptionBolt Max subscription.
- Sign-in command: npx --yes @captionbolt/mcp@0.3.3 login
  It prints an authorization URL and tries to open it in my browser, waits up to five minutes for me to approve access, then saves the authorization on this computer. Running it first also downloads the package. The URL returns to a local address, so it only works in a browser on this computer.
- On native Windows, a client that cannot start npx directly needs the command cmd with the arguments /c npx --yes @captionbolt/mcp@0.3.3
- Verify with the read-only get_account tool; remaining minutes = credits.availableCreditsSec / 60.
- Clients that cannot run local servers use the remote server https://api.captionbolt.com/mcp instead; it cannot upload files from my computer or save results there.

Steps:
1. Identify my AI client, operating system and shell, and adapt every command, configuration format and file path to them. Check the Node.js version. If you are not running on my computer (for example over SSH, in a container or in a cloud workspace), tell me the smallest step to run there.
2. Start the sign-in command in the background and read its output. As soon as it shows the authorization URL, send me a message that contains that exact URL as plain text, before you run any other command or read any file. Tell me to approve access in the browser window it opened, or to open the URL on this computer if none appeared. I cannot see command output, so never refer to "the link above". Then let the command keep running until it reports success; if you cannot keep a command running, ask me to run it in my own terminal. If it reports that CaptionBolt is already authorized, continue. If it reports that an eligible integration account is required, tell me a Max subscription is needed and stop.
3. Add the server to my client's personal MCP configuration and keep other servers; prefer the client's own command for adding MCP servers. Update a captionbolt entry that uses another @captionbolt/mcp version; ask before replacing one that points elsewhere. A typical entry, to adapt to my client: {"mcpServers": {"captionbolt": {"command": "npx", "args": ["--yes", "@captionbolt/mcp@0.3.3"]}}}
4. Reload the MCP tools as my client requires, then call get_account and report my remaining minutes. If I must restart the client or open a new conversation first, tell me exactly what to do and give me one sentence to send there, such as "Call CaptionBolt get_account and show my remaining minutes."
5. Tell me what succeeded and anything left for me. Once it works, tell me I can ask in my own words, for example "Add captions to <path to my video>".

Rules:
- Do not upload, create, export, retry or cancel anything during setup.
- Ask before installing or upgrading software such as Node.js.
- Do not invent a login URL or ask for my password, an API key or a copied token. If a sandbox blocks network access, the browser or the credential store, ask me for permission or ask me to run the command myself.
- A saved configuration or a finished sign-in is not proof; only a successful get_account call is.

Reference: https://captionbolt.com/integrations/mcp

Elle kurulum

CaptionBolt yerel MCP sunucusu @captionbolt/mcp npm paketidir. Codex, Claude Code, Claude Desktop, Cursor ve VS Code gibi yerel STDIO MCP sunucusu çalıştırabilen AI istemcileriyle çalışır. Node.js 22.12 veya üzeri gerekir. Entegrasyonlar Max aboneliklerinde kullanılabilir.

Önce videolarınızın bulunduğu bilgisayardaki bir terminalden bir kez giriş yapın. Bu, paketi de indirir:

npx --yes @captionbolt/mcp@0.3.3 login

1. Tarayıcı CaptionBolt’u açar. Açmazsa terminalde gösterilen yetkilendirme URL’sini açın.
2. Projelerin hesabına girip gerekirse kurulumu tamamlayın.
3. İzinleri inceleyip Erişime izin ver seçin.
4. Terminal hesabınızın doğrulandığını bildirene kadar bekleyin.

Ardından sunucuyu istemcinin MCP yapılandırmasına ekleyin. Birçok istemci bu biçimi kullanır:

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

Biçim istemciye göre değişebilir; aynı komutu ve bağımsız değişkenleri kullanın. Yerel Windows’ta npx komutunu doğrudan başlatamayan istemcilerde komut olarak cmd, bağımsız değişken olarak /c npx --yes @captionbolt/mcp@0.3.3 kullanın.

WSL aynı bilgisayar sayılır: sunucuyu WSL içinde çalışan AI istemcisine kurun ve Windows dosyalarını /mnt/c/Users/<name>/Videos/interview.mp4 gibi yollarla belirtin. Giriş bağlantısı Windows tarayıcısında açılır.

Son olarak CaptionBolt araçlarının yüklenmesi için istemciyi yeniden başlatın veya yeni bir sohbet açın.

Yetkilendirme sistemin kimlik bilgisi deposunda saklanır ve otomatik yenilenir. Anahtar zinciri olmayan Linux ve WSL’de yalnızca sizin okuyabildiğiniz ~/.config/captionbolt/mcp-credentials.json dosyasına kaydedilir. API anahtarı veya token kopyalamak gerekmez. Bu bilgisayardan kaldırmak için aynı komutu login yerine logout ile çalıştırın.

Bağlantıyı doğrulayın

Asistana şunu isteyin:

Show my remaining CaptionBolt processing minutes and recent projects.
Do not create, export, retry or cancel anything.

Çalışan bağlantı limitleri ve erişilebilir projeleri okur. Uygun video projesi yoksa boş liste normaldir.

Bilgisayarınızdaki videoya altyazı ekleyin

Kendi cümlelerinizle isteyin ve dosyayı belirtin:

Add captions to ~/Videos/interview.mp4

Asistan dosyayı yüklemeye başlar. Yükleme sürerken hangi altyazı stilini kullanacağınızı sorar; birkaç önerilen stil ve CaptionBolt’ta kaydettiğiniz ön ayarları sunar. Bir numarayla yanıt verin, istediğiniz görünümü tarif edin veya seçimi asistana bırakın.

İşlem bitince altyazılı video orijinalin yanına kaydedilir, örneğin interview.captioned.mp4 olarak. Var olan dosya asla değiştirilmez; numaralı bir ad kullanılır. Asistan ayrıca projenin editör bağlantısını paylaşır. Kelimeleri düzeltmek veya stili değiştirmek için açın, ardından CaptionBolt’ta yeniden dışa aktarın.

SRT, VTT, ASS ve TXT gibi altyazı dosyaları videoyla birlikte dışa aktarılır. Bunları aynı istekte ya da sonradan isteyin:

Add captions to ~/Videos/interview.mp4 and also save the SRT file.

Dışa aktarmadan önce altyazıları editörde incelemek isterseniz önce inceleme isteyin.

Yerel sunucu yalnızca belirttiğiniz dosyayı okur. Klasörlerinizi taramaz; video AI sohbetine değil, doğrudan CaptionBolt depolamasına gider. MP4, MOV, WebM ve AVI dosyaları desteklenir. İşleme, sitedeki yükleme gibi hesabınızın dakikalarını ve sınırlarını kullanır.

CaptionBolt araçlarını kullanın

Yerel sunucu şu araçları sağlar:

| Görev | Araçlar | | --- | --- | | Bilgisayardan video yükleme | upload_file, get_upload_progress | | Yüklemeyi duraklatma, sürdürme veya iptal etme | pause_upload, resume_upload, get_upload, abort_upload | | Tamamlanan çıktıyı bilgisayara kaydetme | download_result, get_download_progress | | Dakikaları ve sınırları sorgulama | get_account | | Stil ve kayıtlı ön ayar bulma | list_styles, list_presets | | Proje ve ilerleme okuma | list_projects, get_project | | İşlemenin bitmesini bekleme | wait_for_project | | İşlemi kontrol etme | get_operation | | Tamamlanan yüklemeden proje oluşturma | create_project | | Kaydedilen değişiklikleri dışa aktarma | export_project | | Yeniden deneme veya iptal | retry_project, cancel_project | | Tamamlanan çıktı linkleri | get_result |

Sitede oluşturulan projelerle de çalışabilirsiniz. Örneğin:

List my CaptionBolt projects that are ready for review.
Show their IDs and file names. Do not export them yet.

CaptionBolt’ta inceleyip kaydettikten sonra:

Export project <project-id> as MP4 using its saved changes.
Check the operation, then the project status, and save the video on my
computer when the project is completed. If either fails, show the error and stop.

<project-id> yerine dönen ID’yi koyun. İşlem completed ise eylem başarılıdır; video hâlâ işlenebilir. İnceleme için ready, indirme için completed bekleyin. Hata varsa durun, pollAfterSeconds uygulayın; iptal edilmiş projeyi sorgulamayı bırakın.

mode: "review" projeyi CaptionBolt’ta incelemeniz için ready durumunda bekler; mode: "auto-export" işlemden sonra bu durak olmadan MP4’ü ve planınızdaki altyazı dosyalarını dışa aktarır. Oluşturma ve değiştirme yazma, dışa aktarma ayrıca dışa aktarma izni ister.

Otomatik dışa aktarma ready durumunda kalırsa get_project ile autoExport.state ve autoExport.error okuyun. Başarısızsa bildirip durun; süresiz beklemeyin veya talimatsız başka dışa aktarma başlatmayın.

Önce editörde kaydedin. Tamamlanan proje çıktısını korur; değiştirmek için düzenlenebilir kopya oluşturun. Eksik bir biçimi istemek hemen hata döndürür. Linkler en fazla on dakika sürer, 14 günlük erişimde yenilenir.

Yerel kurulum olmadan bağlanın

İstemciniz yerel sunucu çalıştıramıyorsa, örneğin web tabanlı bir asistansa, uzak MCP kullanın. Uzak MCP aynı proje araçlarını sunar ancak bilgisayarınızdan dosya yükleyemez veya sonuçları oraya kaydedemez. İstemcinin Streamable HTTP üzerinden uzak MCP ve tarayıcı OAuth girişini desteklemesi gerekir.

Name: CaptionBolt
Server URL: https://api.captionbolt.com/mcp
Transport: Streamable HTTP
Authentication: OAuth

Bunlar bağlantı bilgileri, yapılandırma dosyası değil. Alanlar ve biçim istemciye göre değişir; bazıları aktarımı HTTP olarak adlandırır. Sonunda eğik çizgi olmayan tam URL’yi kullanın.

1. İstemcinin MCP ayarlarında sunucuyu ekleyin.
2. Giriş veya yetkilendirmeyi başlatın; tarayıcı CaptionBolt’u açar.
3. Projelerin hesabına girip gerekirse kurulumu tamamlayın.
4. İzinleri inceleyip Erişime izin ver seçin.
5. İstemciye dönüp araçların göründüğünü doğrulayın.

OAuth’u istemci yönetir; yalnız API anahtarı başlıkları destekleyenler bu uç noktaya bağlanamaz. Uzak MCP ile videoyu siteden yükleyin, ardından MCP ile inceleyip kaydedilenleri dışa aktarın. Otomasyon için önce REST yüklemesini bitirin ve ID’yi create_project aracına uploadSessionId olarak verin.

Uzak MCP uzak video URL’si kabul etmez ve yükleme oturumlarını yönetmez. Sunucuların hiçbiri altyazı veya görsel ayarları değiştirmez; editörü kullanın. Bildirimleri Webhooks ile ayarlayın.

Bağlantınızı yönetin

Ayarlar → Entegrasyonlar altında yetkili bağlantıları görün veya kesin.

Kesmek, kayıtlı tokenlar dahil yeni istekleri engeller. logout yalnızca yerel sunucunun yetkisini bilgisayarınızdan siler; yetkiyi iptal etmek için bağlantıyı Ayarlar’da kesin. Web sitesinden çıkmak MCP’yi kesmez. Bu eylemlerin hiçbiri kabul edilmiş işi iptal etmez; durdurmak için proje iptali isteyin.

Sorunları giderin

| Sorun | Kontrol | | --- | --- | | Araçlar görünmüyor | Yerel sunucu: Node.js 22.12 veya üzeri, komut ve bağımsız değişkenler, ardından istemciyi yeniden başlatın. Uzak MCP: Streamable HTTP, OAuth ve doğru URL | | Bir araç AUTH_REQUIRED döndürüyor | Terminalde login komutunu yeniden çalıştırıp tekrar deneyin | | Giriş, kimlik bilgisi deposunun kullanılamadığını bildiriyor | macOS Anahtar Zinciri’nin veya Windows Kimlik Bilgileri Yöneticisi’nin kilidini açın ya da uzak MCP ile bağlanın | | Tarayıcı açılmıyor | Terminalde gösterilen yetkilendirme URL’sini aynı bilgisayarda açın | | Erişime izin verdikten sonra tarayıcı 127.0.0.1 adresine ulaşamıyor | Bağlantıyı login komutunun çalıştığı bilgisayarda, komut hâlâ çalışırken açın; komut durduysa login komutunu yeniden çalıştırın | | İstemci npx veya node başlatamıyor | Masaüstü uygulamaları terminalinizin PATH değerini kullanmayabilir. npx için tam yolu girin veya Node.js klasörünü sunucunun PATH değerine ekleyin; yerel Windows’ta cmd komutunu /c npx … argümanlarıyla kullanın | | API anahtarı isteniyor | Yerel sunucuyu veya istemcinin OAuth girişini kullanın; API anahtarları REST içindir | | Erişim kesilmiş veya dolmuş | Yerel sunucu için login komutunu yeniden çalıştırın ya da istemcide tekrar yetkilendirin | | Eylem reddedilmiş | Verilen izinler ve güncel sınırlar | | İstekler sınırlandırılmış | Dönen aralığı bekleyin | | Proje başarısız | Yeniden denemeden hatayı okuyun; durumlar ve hatalara bakın |

Yerel sunucu projects:read, projects:write ve exports:write ile otomatik yenileme için offline_access ister. Uzak istemci OAuth scope seçimi sunuyorsa aynılarını kullanın; offline_access olmazsa süre sonunda yeniden giriş gerekebilir.

Oluşturma, dışa aktarma, yeniden deneme ve iptal idempotencyKey ister: boşluksuz 1–128 yazdırılabilir ASCII karakteri. Her yeni eylem için UUID gibi yeni bir rastgele değer kullanın. Zaman aşımında bilinen işlemi sorgulayın veya aynı araç çağrısını özgün anahtarla tekrarlayın. Kesin hata sonrası retry_project yeni eylemdir ve yeni anahtar ister.

Araç hatalarında structuredContent.error, message ve kind içerir; varsa status, code, requestId, retryAfterSeconds de döner. Aralığı bekleyin, başarısız aracı sürekli çağırmayın.