Serwer MCP Voxdub

Co robi serwer MCP

Kto może z niego korzystać

Serwer MCP jest dostępny z aktywnym planem Voxdub lub w okresie próbnym. Okres próbny trwa 7 dni i wymaga karty. Potem plan kosztuje 12,99 € miesięcznie lub 99 € rocznie.

Uzyskanie tokenu dostępu

1. Należy zalogować się do Voxdub i otworzyć Ustawienia → Deweloper.
2. Następnie utworzyć osobisty token dostępu i nadać mu nazwę (na przykład „Claude Code”).
3. Token trzeba od razu skopiować. Voxdub pokazuje go tylko raz.
4. Token należy trzymać w tajemnicy, jak hasło. W razie zgubienia trzeba go unieważnić i utworzyć nowy.

https://app-3.voxdub.com/settings?tab=developer

Konfiguracja agenta

Serwer używa transportu Streamable HTTP pod adresem https://mcp.voxdub.com/mcp. Każde żądanie wysyła token w nagłówku Authorization: Bearer <token>. W miejsce <token> należy wstawić własny token.

claude mcp add --transport http voxdub https://mcp.voxdub.com/mcp \
  --header "Authorization: Bearer <token>"

# ~/.codex/config.toml
[mcp_servers.voxdub]
url = "https://mcp.voxdub.com/mcp"
bearer_token_env_var = "VOXDUB_TOKEN"

export VOXDUB_TOKEN="<token>"

{
  "mcpServers": {
    "voxdub": {
      "url": "https://mcp.voxdub.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:VOXDUB_TOKEN}"
      }
    }
  }
}

Logowanie OAuth (konektory claude.ai i ChatGPT) nie jest jeszcze dostępne. Na razie należy użyć klienta, który przyjmuje nagłówek Authorization.

Przykład krok po kroku

Wystarczy opisać agentowi oczekiwany wynik. Na przykład:

„Za pomocą Voxdub utwórz taśmę rytmiczną dla scena.mp4 (po polsku, 2 postacie), popraw literówki, zastosuj styl studio i wyeksportuj w 9:16.”

1. 1

   Sprawdzenie konta

   get_account pokazuje e-mail, stan planu i limity. Agent wywołuje je jako pierwsze.

2. 2

   Wysłanie wideo

   create_upload przyjmuje nazwę pliku, jego dokładny rozmiar w bajtach, typ (video/mp4, video/quicktime lub video/x-matroska) i język mówiony. Zwraca put_url ważny przez 15 minut. Agent wysyła plik pod ten adres, a potem wywołuje complete_upload, które zwraca project_id.

   curl -X PUT -H "Content-Type: video/mp4" \
     --upload-file scene.mp4 "<put_url>"

3. 3

   Transkrypcja

   transcribe uruchamia automatyczną transkrypcję. Język jest wykrywany automatycznie, a rozpoznawanie mówców tworzy jedną postać na każdy głos. Można ustawić min_speakers i max_speakers (od 1 do 20). Agent śledzi zadanie za pomocą wait_for_job, aż finished ma wartość true.

4. 4

   Poprawki kwestii

   get_project podaje id taśmy źródłowej i postacie. list_lines odczytuje kwestie (strony do 200). update_lines poprawia do 100 kwestii naraz: tekst, start_ms, end_ms i postać. assign_character i update_character ustawiają postacie, ich nazwy i kolory.

5. 5

   Ustawienie stylu

   set_band_style stosuje gotowy zestaw (standard, large, studio, comic lub reset) albo dokładne ustawienia: czcionkę, rozmiar, kolor, prędkość przewijania, liczbę ścieżek i wysokość taśmy. translate_band może też utworzyć taśmy w 1 do 5 innych językach.

6. 6

   Eksport

   export_video renderuje wideo z wtopioną taśmą rytmiczną, w formacie 16:9, 9:16 lub kwadratowym, w 720p lub 1080p, przy 24, 25, 30 lub 60 klatkach na sekundę. Opcja remove_voice usuwa oryginalne głosy.

7. 7

   Pobieranie

   Gdy wait_for_job pokaże, że eksport jest gotowy, get_download_url poda link do pobrania ważny przez 1 godzinę.

Opis narzędzi

Limity

• Najwyżej 1 eksport w toku i 2 otwarte zadania jednocześnie na konto.
• Wideo do 5 GB, w formacie mp4, mov lub mkv.
• Eksport do 1080p.
• Tylko wysyłanie plików: import z adresu URL nie jest jeszcze dostępny.

Rozwiązywanie problemów