Połącz asystenta AI przez MCP

Połącz asystenta AI

Set up and connect CaptionBolt remote MCP now. Carry out the setup steps you can perform instead of only explaining them.
Communicate with me in the language I use in this conversation.

Connection details:
- Server name: captionbolt
- Server URL: https://api.captionbolt.com/mcp (no trailing slash)
- Transport: Streamable HTTP
- Authentication: OAuth browser sign-in
- Account requirement: an active CaptionBolt Max subscription

1. Identify the AI client and version you are configuring. Use the current environment when it identifies the client. Ask which client I use only if you cannot determine it. If you are running on a different machine from my client, explain the smallest step I need to perform on my machine.

2. Inspect the client's existing MCP configuration. Reuse a correct CaptionBolt entry. Otherwise, add this remote server using the client's supported command or configuration format. Prefer personal/user configuration and preserve other servers. If a conflicting CaptionBolt entry points elsewhere, ask before replacing it.

For Codex CLI, use:
codex mcp add captionbolt --url https://api.captionbolt.com/mcp

For Claude Code, use:
claude mcp add --transport http --scope user captionbolt https://api.captionbolt.com/mcp

Check the installed client's help before running commands. Run the add command only when the server is not already configured correctly. If this Claude Code version has no MCP login command, direct me to /mcp and its authentication action. For Cursor, use its supported remote MCP settings or mcp.json format with this server URL, then guide me through its connection and authorization action.

3. First try the read-only CaptionBolt get_account tool. If it succeeds, reuse the existing MCP authorization and do not start another login. If it reports authorization is required, start the client's native OAuth flow (Codex: codex mcp login captionbolt; Claude Code: claude mcp login captionbolt, or /mcp if this version has no login command). Open the browser or show the actual authorization URL produced by the client, then wait for me to sign in to CaptionBolt and approve access. Keep the login process running while it waits for the callback. An existing website session may avoid password entry but does not replace MCP consent. Do not invent or manually construct a login URL. No API key, manually copied access token or local CaptionBolt package is needed. Let the client handle callbacks and credential storage. If the client requires explicit scopes, use projects:read projects:write exports:write offline_access.

4. Once authorization succeeds, reconnect or reload the MCP tools as required by the client. If a restart or new conversation is required, tell me exactly how to continue verification there.

5. Verify the connection with the read-only CaptionBolt get_account tool (reuse the successful result from step 3 if already called). Report my remaining processing minutes. Do not upload, create, export, retry or cancel anything during setup. Configuration saved or login completed alone is not proof that this tool works.

6. Report which steps succeeded and any remaining step. If a permission or client limitation prevents execution, explain it and give me the smallest required action. Do not claim the connection works until the verification calls succeed.

Reference: https://captionbolt.com/integrations/mcp
Client documentation:
- Codex: https://developers.openai.com/codex/mcp
- Claude Code: https://code.claude.com/docs/en/mcp
- Cursor: https://cursor.com/docs/mcp

Połącz ręcznie

Użyj klienta obsługującego zdalne MCP przez Streamable HTTP i logowanie OAuth w przeglądarce. Integracje dostępne są w subskrypcjach Max.

Dodaj serwer z tymi danymi:

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.

Nie potrzeba klucza API ani kopiowania tokenu. Klient obsługuje OAuth. Klient tylko z kluczami API w nagłówkach nie połączy się.

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. Prześlij film w CaptionBolt i sprawdź ponownie.

Używaj narzędzi CaptionBolt

Serwer udostępnia:

| Zadanie | Narzędzia | | --- | --- | | Minuty i limity | get_account | | Style i zapisane ustawienia | list_styles, list_presets | | Projekty i postęp | list_projects, get_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 |

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 give me the download link
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.

Najpierw zapisz w edytorze. Gotowe projekty zachowują eksport; do zmian utwórz edytowalną kopię. Linki ważne do dziesięciu minut, odnawialne w 14 dniach dostępu.

Pracuj z nowym filmem

Najłatwiej przesłać na stronie i użyć MCP do podglądu oraz eksportu zapisanych zmian.

Automatyzacja wymaga ukończenia przesyłania REST. Przekaż ID jako uploadSessionId do create_project.

mode: "review" czeka na sprawdzenie; wyraźnie wybierz mode: "auto-export" dla MP4 po przetwarzaniu. 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.

Zdalne MCP nie przesyła lokalnych plików, nie przyjmuje URL filmu ani nie zarządza sesjami przesyłania. Nie edytuje napisów lub 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. Wylogowanie ze strony nie odłącza MCP. Żadna akcja nie anuluje przyjętych zadań; zażądaj anulowania projektu.

Rozwiąż problemy

| Problem | Sprawdź | | --- | --- | | Brak narzędzi | Streamable HTTP, OAuth, dokładny URL i ukończone logowanie | | Żądany klucz API | Wybierz OAuth; klucze są dla REST | | Dostęp odłączony lub wygasły | 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 |

Jeśli klient pokazuje scope OAuth: projects:read, projects:write, exports:write. Dołącz offline_access do automatycznego odnawiania, zwykle obsługiwanego przez klienta. Bez tego może być potrzebne ponowne logowanie.

Tworzenie, eksport, ponowienie i anulowanie wymaga idempotencyKey: 1–128 drukowalnych znaków ASCII bez spacji. Nowa akcja, nowy klucz. 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.