Połącz asystenta AI przez MCP

Połącz asystenta AI

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

Zainstaluj ręcznie

Lokalny serwer MCP CaptionBolt to pakiet npm @captionbolt/mcp. Działa z klientami AI, które mogą uruchomić lokalny serwer MCP przez STDIO, takimi jak Codex, Claude Code, Claude Desktop, Cursor i VS Code. Wymaga Node.js 22.12 lub nowszego. Integracje dostępne są w subskrypcjach Max.

Najpierw zaloguj się raz w terminalu na komputerze z filmami. Przy okazji pobierze się pakiet:

npx --yes @captionbolt/mcp@0.3.3 login

1. CaptionBolt otworzy się w przeglądarce. Jeśli nie, otwórz URL autoryzacji wyświetlony w terminalu.
2. Zaloguj się na konto projektów i dokończ konfigurację, jeśli wymagana.
3. Sprawdź uprawnienia i wybierz Zezwól na dostęp.
4. Poczekaj, aż terminal potwierdzi weryfikację konta.

Następnie dodaj serwer do konfiguracji MCP klienta. Wiele klientów używa tego formatu:

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

Format zależy od klienta; użyj tego samego polecenia i argumentów. Jeśli w natywnym Windows klient nie może uruchomić npx bezpośrednio, użyj polecenia cmd z argumentami /c npx --yes @captionbolt/mcp@0.3.3.

WSL liczy się jako ten sam komputer: zainstaluj serwer w kliencie AI działającym w WSL, a pliki Windows wskazuj ścieżkami takimi jak /mnt/c/Users/<name>/Videos/interview.mp4. Link logowania otworzy się w przeglądarce Windows.

Na koniec uruchom ponownie klienta lub zacznij nową rozmowę, aby wczytał narzędzia CaptionBolt.

Autoryzacja jest zapisana w systemowym magazynie poświadczeń i odnawia się automatycznie. W Linuksie i WSL bez pęku kluczy trafia do ~/.config/captionbolt/mcp-credentials.json, czytelnego tylko dla Ciebie. Nie potrzeba klucza API ani kopiowania tokenu. Aby usunąć ją z tego komputera, uruchom to samo polecenie z logout zamiast login.

Sprawdź połączenie

Poproś asystenta:

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

Działające połączenie czyta limity i dostępne projekty. Pusta lista jest normalna bez odpowiednich projektów wideo.

Dodaj napisy do filmu z komputera

Poproś własnymi słowami i wskaż plik:

Add captions to ~/Videos/interview.mp4

Asystent zaczyna przesyłać ten plik. W trakcie przesyłania pyta, jakiego stylu napisów użyć, i proponuje kilka polecanych stylów oraz presety zapisane w CaptionBolt. Odpowiedz numerem, opisz wygląd, jakiego chcesz, albo pozwól asystentowi wybrać.

Po przetworzeniu film z napisami zostaje zapisany obok oryginału, na przykład jako interview.captioned.mp4. Istniejący plik nigdy nie jest zastępowany; używana jest numerowana nazwa. Asystent podaje też link do projektu w edytorze. Otwórz go, aby poprawić słowa lub zmienić styl, a następnie ponownie wyeksportuj w CaptionBolt.

Pliki napisów, np. SRT, VTT, ASS i TXT, są eksportowane razem z filmem. Poproś o nie w tej samej prośbie lub później:

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

Aby sprawdzić napisy w edytorze przed eksportem, poproś najpierw o sprawdzenie.

Lokalny serwer czyta tylko wskazany plik. Nie przeszukuje folderów, a film trafia bezpośrednio do magazynu CaptionBolt, a nie do rozmowy z AI. Obsługiwane są pliki MP4, MOV, WebM i AVI. Przetwarzanie korzysta z minut i limitów konta, tak jak przesyłanie na stronie.

Używaj narzędzi CaptionBolt

Lokalny serwer udostępnia:

| Zadanie | Narzędzia | | --- | --- | | Przesłanie filmu z komputera | upload_file, get_upload_progress | | Wstrzymanie, wznowienie lub anulowanie przesyłania | pause_upload, resume_upload, get_upload, abort_upload | | Zapis gotowego eksportu na komputerze | download_result, get_download_progress | | Minuty i limity | get_account | | Style i zapisane presety | list_styles, list_presets | | Projekty i postęp | list_projects, get_project | | Oczekiwanie na koniec przetwarzania | wait_for_project | | Sprawdzenie akcji | get_operation | | Projekt z ukończonego przesyłania | create_project | | Eksport zapisanych zmian | export_project | | Ponowienie lub anulowanie | retry_project, cancel_project | | Linki gotowych eksportów | get_result |

Możesz też pracować z projektami utworzonymi na stronie. Na przykład:

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

Po sprawdzeniu i zapisaniu w CaptionBolt:

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.

Zastąp <project-id> otrzymanym ID. Operacja completed potwierdza akcję, lecz film może nadal być przetwarzany. Sprawdzaj do ready dla kontroli lub completed dla pobrania. Przy błędzie zatrzymaj się, przestrzegaj pollAfterSeconds i zakończ odpytywanie po anulowaniu.

mode: "review" czeka w ready, aby można było sprawdzić projekt w CaptionBolt; mode: "auto-export" eksportuje po przetworzeniu, bez tego zatrzymania, MP4 i pliki napisów z Twojego planu. Tworzenie i zmiana wymaga zapisu; eksport i autoeksport także prawa eksportu.

Jeśli autoeksport pozostaje w ready, sprawdź autoExport.state i autoExport.error przez get_project. Zgłoś błąd i zatrzymaj się; nie czekaj bez końca ani nie eksportuj ponownie bez polecenia.

Najpierw zapisz w edytorze. Gotowe projekty zachowują eksport; do zmian utwórz edytowalną kopię. Żądanie brakującego formatu od razu zwraca błąd. Linki ważne do dziesięciu minut, odnawialne w 14 dniach dostępu.

Połącz bez instalacji lokalnej

Użyj zdalnego MCP, gdy klient nie może uruchamiać lokalnych serwerów, np. asystent w przeglądarce. Zdalne MCP ma te same narzędzia projektów, ale nie może przesyłać plików z komputera ani zapisywać na nim wyników. Klient musi obsługiwać zdalne MCP przez Streamable HTTP i logowanie OAuth w przeglądarce.

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

To dane połączenia, nie plik konfiguracyjny. Pola i format zależą od klienta; część nazywa transport HTTP. Użyj dokładnego URL bez końcowego ukośnika.

1. Dodaj serwer w ustawieniach MCP klienta.
2. Uruchom logowanie lub autoryzację; CaptionBolt otworzy się w przeglądarce.
3. Zaloguj się na konto projektów i dokończ konfigurację, jeśli wymagana.
4. Sprawdź uprawnienia i wybierz Zezwól na dostęp.
5. Wróć do klienta i sprawdź dostępne narzędzia.

Klient obsługuje OAuth; klient tylko z kluczami API w nagłówkach nie połączy się. Przy zdalnym MCP prześlij film na stronie i użyj MCP do podglądu oraz eksportu zapisanych zmian. Automatyzacja wymaga najpierw ukończenia przesyłania REST i przekazania ID jako uploadSessionId do create_project.

Zdalne MCP nie przyjmuje URL filmu ani nie zarządza sesjami przesyłania. Żaden z serwerów nie edytuje napisów ani ustawień wizualnych; użyj edytora. Powiadomienia konfiguruj przez Webhooks.

Zarządzaj połączeniem

Zobacz i odłącz autoryzowane połączenia w Ustawienia → Integracje.

Odłączenie blokuje żądania, także zapisane tokeny. logout usuwa tylko autoryzację lokalnego serwera z Twojego komputera; aby ją cofnąć, odłącz połączenie w ustawieniach. Wylogowanie ze strony nie odłącza MCP. Żadna z tych akcji nie anuluje przyjętych zadań; zażądaj anulowania projektu.

Rozwiąż problemy

| Problem | Sprawdź | | --- | --- | | Brak narzędzi | Serwer lokalny: Node.js 22.12 lub nowszy, polecenie i argumenty, potem restart klienta. Zdalne MCP: Streamable HTTP, OAuth i dokładny URL | | Narzędzie zwraca AUTH_REQUIRED | Uruchom ponownie login w terminalu i spróbuj jeszcze raz | | Logowanie zgłasza brak magazynu poświadczeń | Odblokuj pęk kluczy macOS lub Menedżera poświadczeń Windows albo połącz się przez zdalne MCP | | Przeglądarka się nie otwiera | Otwórz na tym samym komputerze URL autoryzacji z terminala | | Po zezwoleniu przeglądarka nie łączy się z 127.0.0.1 | Otwórz link na komputerze, na którym działa login, dopóki polecenie działa; jeśli się zakończyło, uruchom login ponownie | | Klient nie może uruchomić npx ani node | Aplikacje desktopowe mogą nie używać PATH z terminala. Podaj pełną ścieżkę do npx lub dodaj folder Node.js do PATH serwera; w natywnym Windows użyj cmd z /c npx … | | Żądany klucz API | Użyj lokalnego serwera lub logowania OAuth klienta; klucze są dla REST | | Dostęp odłączony lub wygasły | Uruchom ponownie login dla serwera lokalnego lub autoryzuj ponownie w kliencie | | Akcja odmówiona | Przyznane prawa i aktualne limity | | Żądania ograniczone | Poczekaj podany czas | | Projekt zawiódł | Czytaj błąd przed ponowieniem; zobacz stany i błędy |

Lokalny serwer prosi o projects:read, projects:write i exports:write oraz offline_access do automatycznego odnawiania. Jeśli zdalny klient pokazuje scope OAuth, użyj tych samych; bez offline_access może być potrzebne ponowne logowanie.

Tworzenie, eksport, ponowienie i anulowanie wymaga idempotencyKey: 1–128 drukowalnych znaków ASCII bez spacji. Dla każdej nowej akcji użyj nowej losowej wartości, np. UUID. Po timeout sprawdź znaną operację lub wyślij identyczne wywołanie z pierwotnym kluczem. retry_project po potwierdzonym błędzie jest nową akcją i wymaga nowego klucza.

Błędy zawierają structuredContent.error z message i kind, dodatkowo dostępne status, code, requestId, retryAfterSeconds. Przestrzegaj czasu oczekiwania zamiast ciągle wywoływać błędne narzędzie.