# Serwer MCP do transkrypcji wideo dla twojego asystenta AI

> Serwer MCP do transkrypcji wideo i plików dla Claude, ChatGPT i edytorów kodu. OAuth lub klucz API, gotowy tekst ze znacznikami czasu.

Canonical: https://transcript1.com/pl/features/serwer-mcp-do-transkrypcji-wideo
Language: pl
Last updated: 2026-10-19

Podłącz serwer MCP do transkrypcji wideo i zleć asystentowi pracę z nagraniem. Przyjmujemy linki z YouTube, X, TikToka, Instagrama, Facebooka i Bluesky, klipy i zakończone VOD-y z Twitcha, filmy z Dailymotion i LinkedIn, piny z filmami z Pinteresta oraz Snapchat Spotlight. Możesz też dodać własny plik. Claude i ChatGPT łączysz przez OAuth, a Cursor, VS Code i Claude Code kluczem API.

- Claude, ChatGPT, Cursor, VS Code i Claude Code
- Te same minuty i limity co w REST API
- Pełny link pozwala ponownie użyć transkrypcji z ostatnich 24 godzin

## Podłącz asystenta i daj mu nagranie do przeczytania

### Bez stawiania lokalnego serwera

Podłącz https://api.transcript1.com/mcp przez streamable HTTP. Serwer działa u nas. Potrzebujesz klienta, który obsługuje zdalne MCP.

### Zaloguj się albo podaj klucz

W Claude i ChatGPT użyj OAuth. W Cursor, VS Code, Claude Code i własnych agentach wyślij klucz API jako Bearer token.

### Asystent ma dostęp do 8 narzędzi

Może wywołać transcribe, get_transcription, list_transcriptions, create_upload, get_upload_status, complete_upload, delete_transcription i get_account.

### Długie nagranie przeczyta po kawałku

Dzielimy tekst na strony między segmentami, bez urywania fragmentu w połowie. Domyślnie każda linijka ma znacznik czasu.

### Nie musi przepisywać tego samego filmu ponownie

Dla pełnego linku transcribe może użyć pasującej transkrypcji z ostatnich 24 godzin. Krótkiego linku nie dopasujemy w ten sposób. Zapisane ID odczytasz przez get_transcription.

## Jak podłączyć MCP w Cursor i VS Code

W Cursor dodaj adres serwera i klucz API do .cursor/mcp.json. VS Code używa .vscode/mcp.json. Dla obu edytorów mamy też [instalację jednym kliknięciem](https://transcript1.com/pl/docs/mcp).

Klient musi obsługiwać zdalny serwer przez streamable HTTP i wysyłać nagłówek Authorization. Cursor i VS Code mają różne formaty konfiguracji. Skopiuj przykład dla swojego edytora, zamiast tylko zmieniać nazwę pliku.

Po podłączeniu poproś asystenta o wywołanie get_account lub list_transcriptions. Sprawdzisz w ten sposób dostęp do konta bez tworzenia płatnej transkrypcji.

Nie widać narzędzi? Sprawdź, czy klient wczytał konfigurację i włączył serwer. Jeśli wywołanie zwraca błąd autoryzacji, sprawdź klucz w ustawieniach klienta.

### .cursor/mcp.json

```
{
  "mcpServers": {
    "transcript1": {
      "url": "https://api.transcript1.com/mcp",
      "headers": {
        "Authorization": "Bearer t1_YOURKEY"
      }
    }
  }
}
```

## Jak podłączyć Claude Code, Claude i ChatGPT

W Claude Code uruchom claude mcp add z adresem serwera i kluczem API. W Claude dodaj własny konektor, podaj ten sam adres i zaloguj się. ChatGPT korzysta z tego samego URL. [Sprawdź instrukcję dla swojego klienta](https://transcript1.com/pl/docs/mcp#claude).

Konektory Claude i ChatGPT korzystają z OAuth. Ich dostępność zależy od planu asystenta i ustawień twojego zespołu. Klucz API w edytorze to inny sposób połączenia, więc trzymaj się instrukcji dla aplikacji, której używasz.

Gdy narzędzia są już dostępne, podaj publiczny link i konkretne zadanie. Możesz najpierw poprosić o transkrypcję rolki z Instagrama, a potem o wypisanie instrukcji, które ktoś w niej mówi.

Asystent dostaje od nas tekst z nagrania. Jeśli nie obejrzał filmu, nie wie, co pokazano bez słów.

### Claude Code

```
claude mcp add --transport http transcript1 https://api.transcript1.com/mcp --header "Authorization: Bearer t1_YOURKEY"
```

## Asystent zleca transkrypcję i czyta kolejne strony

Asystent wywołuje transcribe, czeka i odczytuje pierwszą stronę tekstu. Jeśli przetwarzanie jeszcze trwa, dostaje ID do get_transcription. [Sprawdź parametry narzędzi](https://transcript1.com/pl/docs/mcp#tools) i [zasady pracy agenta z transkrypcją](https://transcript1.com/pl/use-cases/transkrypcje-dla-agentow-ai).

Domyślnie dostaje tekst ze znacznikami czasu. Przy długim nagraniu następna strona zaczyna się od granicy segmentu. Wartość next_from_seconds trzeba przekazać jako from_seconds w kolejnym odczycie.

Pierwsza strona to nie zawsze cała rozmowa. Zanim asystent podsumuje nagranie, powinien przeczytać wszystkie potrzebne fragmenty.

Pełne linki pozwalają dopasować transkrypcję z ostatnich 24 godzin. Krótkie linki do udostępniania nie dają takiego dopasowania przy zlecaniu. Niezależnie od rodzaju linku, znane ID możesz odczytać przez get_transcription bez tworzenia nowej transkrypcji.

W przykładzie poniżej zastąp tekst w nawiasach prawdziwym linkiem do publicznego filmu z TikToka.

### Przykładowe wywołania asystenta

```
transcribe(url="[public TikTok video URL]")

get_transcription(id="tr_8fK2Lm0PqRsTuVwXyZaBcD", format="srt")
```

## Kiedy asystent może wysłać plik z dysku

Przez MCP przesyłamy parametry i odpowiedzi, nie bajty nagrania. Narzędzie create_upload rezerwuje transkrypcję i zwraca plan części. Asystent musi umieć odczytać plik, wysłać części przez HTTP poza MCP i na koniec wywołać complete_upload. [Sprawdź, jak działa wysyłanie plików](https://transcript1.com/pl/docs/mcp#files).

Nie każdy asystent ma dostęp do lokalnego dysku lub potrafi wysłać dane binarne. Wtedy wrzuć nagranie w panelu i podaj mu ID gotowej transkrypcji. Sama nazwa pliku w rozmowie nie udostępnia nam jego zawartości.

Jeśli potrzebujesz webhooka, użyj REST API. Narzędzia MCP nie mają tego parametru. W rozmowie asystent może poczekać przez ograniczony czas, a potem wracać do transkrypcji przez get_transcription.

Po utracie połączenia sprawdź ostatnie transkrypcje lub wróć do znanego ID. Przerwane wywołanie nie oznacza, że nic nie zostało utworzone. Ten sam serwer wykorzystasz do pracy z [filmem z Bluesky](https://transcript1.com/pl/features/transkrypcja-wideo-bluesky) lub [tekstem z TikToka](https://transcript1.com/pl/features/transkrypcja-tiktok). Post musi być publiczny. Transkrypcja opisuje to, co słychać, nie to, co widać.

## Najczęstsze pytania

### Jakiego asystenta mogę podłączyć?

Claude i ChatGPT przez własne konektory, Cursor i VS Code instalacją jednym kliknięciem, a Claude Code jedną komendą. Możesz też użyć innego klienta, który obsługuje zdalne serwery MCP.

### Muszę tworzyć klucz API?

W Claude i ChatGPT logujesz się przez OAuth. W innych aplikacjach podajesz klucz z prefiksem t1_ w nagłówku Authorization. Utworzysz go w panelu na stronie „API keys”.

### Asystent przepisze nagranie z mojego komputera?

Tak, jeśli potrafi odczytać plik i wysłać go przez HTTP. Najpierw wywołuje create_upload, potem wysyła części poza MCP i potwierdza upload przez complete_upload. Jeśli nie ma takich możliwości, wrzuć plik w panelu i podaj mu ID transkrypcji.

### Czy MCP zużywa tę samą pulę minut?

Tak. Narzędzia korzystają z tego samego API i twojego konta. Obowiązują te same opłaty, limity, limity requestów i kody błędów.

## Sprawdź też

- [Agenci AI i LLM](https://transcript1.com/pl/use-cases/transkrypcje-dla-agentow-ai)
- [Jak podłączyć serwer MCP (dokumentacja)](https://transcript1.com/pl/docs/mcp)
- [Tekst z TikToka](https://transcript1.com/pl/features/transkrypcja-tiktok)
- [Pliki przez API](https://transcript1.com/pl/features/speech-to-text-api)