Jak podłączyć serwer MCP

Podłącz asystenta AI do serwera Model Context Protocol 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.

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.

• 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”.

Narzędzia MCP wywołują REST API /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

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.

Webhooki tylko przez REST API

W narzędziach MCP nie podasz adresu webhooka. Jeśli potrzebujesz webhooków, 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

Jeśli wolisz konfigurację ręczną, dodaj ten wpis do .cursor/mcp.json. W nagłówku Authorization wstaw swój klucz API:

{
  "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

Ręcznie dodasz go w pliku .vscode/mcp.json swojego workspace'u:

{
  "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:

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”.

{
  "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.

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 <code>: <message>. <next step>. Gdy zabraknie minut, dostaniesz na przykład:

insufficient_minutes: 20 minutes needed, 3 remaining. Top up at https://transcript1.com/dashboard/billing

Pełną listę znajdziesz w opisie błędów. 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.