# Jak podłączyć serwer MCP > Podłącz transcript1 do Claude, ChatGPT, Cursor, VS Code lub Claude Code. Asystent AI zleci transkrypcję i przeczyta gotowy tekst. Canonical: https://transcript1.com/pl/docs/mcp Language: pl Last updated: 2026-10-15 Podłącz asystenta AI do serwera [Model Context Protocol](https://modelcontextprotocol.io/) transcript1. Asystent będzie mógł zlecić transkrypcję filmu z YouTube, X, TikToka, Instagrama, Facebooka lub Bluesky, a potem przeczytać tekst. Może też korzystać z przesłanych plików audio i wideo. [Sprawdź pozostałe obsługiwane publiczne nagrania i ograniczenia](https://transcript1.com/pl/docs/sources-and-options). Post musi być publiczny. Jeśli zawiera kilka filmów, przepiszemy tylko pierwszy. Na YouTube, X, TikToku, Bluesky, Dailymotion i LinkedIn w trybie auto najpierw sprawdzamy napisy w języku nagrania. Jeśli nie da się z nich skorzystać, AI przepisuje dźwięk w tej samej cenie za minutę. Poza YouTube napisy zawierają czasy całych fragmentów, bez czasów słów (`words: null`), także gdy platforma wygenerowała je automatycznie. Tryb `captions` (tylko napisy) nie pobiera audio i nie uruchamia STT. Podział na rozmówców oraz `source=stt` od razu kierują nagranie do transkrypcji audio. Szczegóły znajdziesz [w opisie źródeł i opcji](https://transcript1.com/pl/docs/sources-and-options). - **Endpoint:** `https://api.transcript1.com/mcp` (streamable HTTP) - **Dostęp:** w Claude i ChatGPT zaloguj się do transcript1 i zatwierdź połączenie przez OAuth 2.1. W Cursor, VS Code, Claude Code i u agentów użyj klucza API w nagłówku `Authorization: Bearer t1_...`. Klucz utworzysz na stronie [„API keys”](https://transcript1.com/dashboard/account/tokens). Narzędzia MCP wywołują [REST API](https://transcript1.com/pl/docs/api-reference) `/v1` z twoim kluczem lub tokenem. API tak samo sprawdza parametry, rozlicza minuty i zwraca kody błędów. MCP korzysta z tej samej puli minut i limitu requestów co reszta konta. ## Narzędzia | Narzędzie | Do czego służy | |---|---| | `transcribe` | Zleca transkrypcję filmu z obsługiwanego linku. Podaj `url`; opcjonalnie dodaj `platform`, `source`, `language`, `diarize`, `format` i `wait_seconds`. API rozpoznaje platformę z adresu. Narzędzie czeka na tekst, po czym zwraca jego pierwszą stronę. Jeśli transkrypcja nadal trwa, zwraca `id`. | | `get_transcription` | Sprawdza status lub pobiera tekst transkrypcji o podanym `id`. Możesz dodać `wait_seconds`, `format`, `from_seconds` i `max_chars`. | | `list_transcriptions` | Zwraca historię od najnowszej transkrypcji, bez tekstu nagrań. Opcjonalne filtry i parametry to `status`, `platform`, `limit` i `cursor`. | | `create_upload` | Przygotowuje upload pliku z dysku w częściach. Podaj `filename`, `size` i samodzielnie wygenerowany UUID w `request_id`. Możesz też dodać `mime_type`, `language` i `diarize`. | | `get_upload_status` | Sprawdza, które części pliku już dotarły. Dzięki temu wznawiasz upload od brakujących części. | | `complete_upload` | Sprawdza kompletność części pliku i dodaje transkrypcję do kolejki. | | `delete_transcription` | Anuluje trwającą transkrypcję i zwraca minuty. Zakończoną usuwa razem z tekstem. | | `get_account` | Sprawdza, ile masz minut, jaki masz plan i kiedy się odnowi. | ### Formaty, oczekiwanie i podział tekstu - Domyślny `format` to `text`. Każdy fragment dostajesz w osobnej linii ze znacznikiem czasu. Jeśli transkrypcja ma podział na rozmówców, linia zawiera też etykietę, np. `[00:01:02] Speaker 1: Good morning.` Możesz wybrać również `srt`, `vtt` lub `json`. - Narzędzie czeka domyślnie 50 sekund. Parametrem `wait_seconds` ustawisz czas od 0 do 55 sekund. Jeśli tekst nie będzie jeszcze gotowy, odpowiedź poinformuje o tym i poda `id`. Przekaż je do `get_transcription`, żeby znów poczekać. - Długi tekst odbierasz stronami. Parametr `max_chars` przyjmuje od 1000 do 100 000 znaków, domyślnie 60 000. Strona kończy się zawsze na granicy fragmentu. Odpowiedź zawiera `next_from_seconds`; przekaż tę wartość w `from_seconds`, żeby pobrać dalszy tekst. - Asystent rozpoznaje źródło tekstu po polu `transcript_source`: `youtube_captions`, `x_captions`, `tiktok_captions`, `bluesky_captions`, `dailymotion_captions`, `linkedin_captions` lub `speech_to_text`. Wartość `caption_kind: null` oznacza, że nie znamy pochodzenia napisów. Nie oznacza, że dodał je twórca. ### Zanim ponownie zlecisz transkrypcję Najpierw sprawdź istniejące zadanie przez `get_transcription` lub `list_transcriptions`. Narzędzie `transcribe` zawsze włącza `reuse_recent`: jeśli w ciągu 24 godzin podasz pełny link do tego samego filmu z tymi samymi opcjami, dostaniesz wcześniejszą transkrypcję bez ponownej opłaty. Przy krótkich linkach to nie działa. Odpowiedź informuje, gdy korzystasz z wcześniejszej transkrypcji. ### Jak wysłać własny plik Samego pliku nie wyślesz przez MCP. Wywołaj `create_upload`, żeby dostać `id` transkrypcji, szablon URL-i do wysyłania części, `X-Upload-Token` i listę części. Asystent wysyła je przez HTTP `PUT` poza MCP, a na koniec wywołuje `complete_upload`. Odpowiedź zawiera też link do strony uploadu w panelu, jeśli zechcesz wysłać plik tą drogą. Szczegóły protokołu znajdziesz [w dokumentacji uploadu](https://transcript1.com/pl/docs/uploads). ### Webhooki tylko przez REST API W narzędziach MCP nie podasz adresu webhooka. Jeśli potrzebujesz [webhooków](https://transcript1.com/pl/docs/webhooks), skorzystaj z REST API. ## Claude W Claude dodaj transcript1 jako custom connector do zdalnego serwera MCP. 1. W ustawieniach konektorów Claude wybierz dodanie custom connectora. 2. Wpisz nazwę `transcript1` i adres serwera `https://api.transcript1.com/mcp`. 3. Zaloguj się do transcript1 i zatwierdź dostęp z uprawnieniami `transcriptions:read` i `transcriptions:write`. Po połączeniu możesz napisać do Claude: „Zrób transkrypcję https://www.youtube.com/watch?v=dQw4w9WgXcQ”. Dostępność custom connectorów zależy od twojego planu Claude. ## ChatGPT W ChatGPT również dodaj custom connector. 1. W ustawieniach konektorów ChatGPT dodaj custom connector dla serwera MCP. 2. Podaj adres serwera: `https://api.transcript1.com/mcp`. 3. Zaloguj się na konto transcript1 i zatwierdź połączenie. Połączenie może wymagać trybu dewelopera. Dostępność custom connectorów zależy od planu ChatGPT i ustawień workspace'u. ## Jak podłączyć MCP w Cursor Kliknij, żeby dodać serwer: [Podłącz transcript1 w Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=transcript1&config=eyJ1cmwiOiJodHRwczovL2FwaS50cmFuc2NyaXB0MS5jb20vbWNwIn0=) Jeśli wolisz konfigurację ręczną, dodaj ten wpis do `.cursor/mcp.json`. W nagłówku `Authorization` wstaw swój klucz API: ```json { "mcpServers": { "transcript1": { "url": "https://api.transcript1.com/mcp", "headers": { "Authorization": "Bearer t1_YOURKEY" } } } } ``` ## VS Code Kliknij, żeby dodać serwer: [Podłącz transcript1 w VS Code](vscode:mcp/install?%7B%22name%22%3A%22transcript1%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.transcript1.com%2Fmcp%22%7D) Ręcznie dodasz go w pliku `.vscode/mcp.json` swojego workspace'u: ```json { "servers": { "transcript1": { "type": "http", "url": "https://api.transcript1.com/mcp", "headers": { "Authorization": "Bearer t1_YOURKEY" } } } } ``` ## Jak podłączyć MCP w Claude Code Wstaw swój klucz API zamiast `t1_YOURKEY` i uruchom polecenie: ```bash claude mcp add --transport http transcript1 https://api.transcript1.com/mcp --header "Authorization: Bearer t1_YOURKEY" ``` ## Inne aplikacje z obsługą MCP Jeśli klient obsługuje zdalne serwery MCP, podaj w nim adres `https://api.transcript1.com/mcp` i nagłówek `Authorization: Bearer t1_...`. ## Gdy aplikacja wymaga polecenia zamiast adresu Jeśli klient uruchamia serwer MCP poleceniem, użyj `npx -y @transcript1/mcp`. Ustaw `TRANSCRIPT1_API_KEY` na swój klucz API. Pakiet połączy klienta ze zdalnym serwerem transcript1. Potrzebujesz Node.js 18 lub nowszego. W Claude Desktop dodaj poniższy wpis do `claude_desktop_config.json`. W miejsce `t1_YOURKEY` wklej klucz ze strony [„API keys”](https://transcript1.com/dashboard/account/tokens). ```json { "mcpServers": { "transcript1": { "command": "npx", "args": ["-y", "@transcript1/mcp"], "env": { "TRANSCRIPT1_API_KEY": "t1_YOURKEY" } } } } ``` ## Agent Skill Agent Skill to plik `SKILL.md` z krótką instrukcją korzystania z transcript1. Jeśli twój agent obsługuje Agent Skills, dodaj mu plik z adresu [https://transcript1.com/.well-known/agent-skills/transcript1/SKILL.md](https://transcript1.com/.well-known/agent-skills/transcript1/SKILL.md). Agent może też znaleźć instrukcję sam przez indeks `https://transcript1.com/.well-known/agent-skills/index.json`, jeśli obsługuje automatyczne wykrywanie Agent Skills. ## Jak narzędzia zgłaszają błędy Jeśli narzędzie nie wykona operacji, zwróci błąd z takim samym `code` jak REST API. Do komunikatu dołączy wskazówkę, co asystent powinien zrobić dalej. Odpowiedź ma format `: . `. Gdy zabraknie minut, dostaniesz na przykład: ```text insufficient_minutes: 20 minutes needed, 3 remaining. Top up at https://transcript1.com/dashboard/billing ``` Pełną listę znajdziesz [w opisie błędów](https://transcript1.com/pl/docs/errors). Jeśli sama transkrypcja się nie uda, narzędzie zgłosi to w tym samym formacie z odpowiednim kodem, np. `media_private` lub `no_captions`.