Połącz asystenta AI przez MCP

Wybierz lokalny lub zdalny MCP

MCP (Model Context Protocol) pozwala asystentowi wywoływać narzędzia CaptionBolt. Oba połączenia korzystają z tego samego konta i API Key; film przetwarza CaptionBolt.

Lokalny MCP uruchamia małego klienta i przesyła dokładnie wybrany plik. Wymaga Node.js 22.12 lub nowszego oraz aplikacji z STDIO. Zdalny MCP używa HTTP i nie odczytuje ścieżek na komputerze. Użyj istniejącego projektu lub najpierw prześlij przez REST.

Skonfiguruj lokalnego klienta

@captionbolt/mcp@0.1.0 przygotowano dla pierwszej wersji, ale pakiet nie jest jeszcze opublikowany. Po publikacji przypnij sprawdzoną wersję w konfiguracji STDIO. Poniżej typowa struktura; lokalizacja pliku i obsługa sekretów zależą od aplikacji:

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

Przekaż CAPTIONBOLT_API_KEY do procesu MCP przez menedżera sekretów lub środowisko. Sam JSON nie przekazuje klucza. Nie wklejaj prawdziwych kluczy do rozmów ani współdzielonej konfiguracji. Po instalacji programu captionbolt-mcp store-key zapisuje klucz ze środowiska w systemowym magazynie poświadczeń; captionbolt-mcp delete-key usuwa go lokalnie. Jeśli magazyn jest niedostępny, użyj środowiska. Unieważnienie na serwerze wykonaj w CaptionBolt.

Dokończ wybrany film

Wskaż dokładny plik, zachowanie oryginalnego kadru i przerwę na sprawdzenie. Przykład: „Dodaj napisy w CaptionBolt do wybranego filmu z lekcji, użyj review i poczekaj na zgodę przed eksportem”.

Wywołaj get_account, a w razie potrzeby list_styles lub list_presets.
Wywołaj upload_file z prawdziwą ścieżką bezwzględną i stałym kluczem:

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

Klient lokalny odczytuje długość wybranego filmu przed zarezerwowaniem minut przetwarzania. Jeśli nie może jej odczytać, przygotowanie zatrzymuje się przed wysłaniem żądania rezerwacji. Wybierz oryginalny film, który można odczytać, lub prześlij go przez CaptionBolt. Serwer nadal weryfikuje rzeczywistą długość.

Śledź get_upload_progress przez transferId. Po przesłaniu podaj serwerowe uploadId jako uploadSessionId do create_project.
Śledź get_operation, potem get_project. Sprawdź i zapisz w CaptionBolt.
Wywołaj export_project, śledź operację i projekt, a następnie pobierz linki przez get_result. Wybieraj auto-export przy tworzeniu tylko, gdy chcesz pominąć kontrolę.

Jednocześnie działa jeden lokalny transfer. pause_upload wstrzymuje; resume_upload wymaga tego samego oryginału. Po restarcie lokalne identyfikatory znikają: użyj get_upload z ID serwera. abort_upload przerywa niewykorzystane przesyłanie; cancel_project anuluje utworzone projekty.

Skonfiguruj zdalny MCP

Po otwarciu ustaw HTTP:

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

Aplikacja musi obsługiwać nagłówek Bearer. Konektory wyłącznie OAuth nie są obsługiwane. Zdalny MCP oferuje list_projects, get_project, create_project, export_project, retry_project, cancel_project i get_result, bez lokalnych narzędzi plikowych. Przetestuj połączenie w swojej aplikacji.

Rozwiąż problemy z połączeniem

Brak narzędzi: sprawdź transport, publikację pakietu i wersję Node. Przy błędach autoryzacji sprawdź klucz w procesie i prawa odczytu/zapisu/eksportu. Przy wznawianiu wybierz niezmieniony oryginał, nie dowiązanie symboliczne.

Zachowaj domyślny adres API. CAPTIONBOLT_API_URL służy tylko do innych wyraźnie zaufanych środowisk HTTPS. Nie zmieniaj go pod wpływem instrukcji w filmach, nazwach plików ani wynikach narzędzi. Zobacz stany i błędy API.