MCP-сервер Transcript Dock

MCP-сервер даёт ИИ-агенту тот же API, что и ваш ключ: он может находить видео, транскрибировать их и читать результаты прямо во время разговора. Он списывает ваши кредиты. Ничего устанавливать не нужно: укажите клиенту удалённый сервер https://www.transcriptdock.com/mcp.

Подключение#

Claude (claude.ai, Desktop, мобильное приложение)#

• Откройте Customize, Connectors и выберите Add custom connector.
• Назовите коннектор Transcript Dock и вставьте https://www.transcriptdock.com/mcp как URL сервера. Расширенные настройки оставьте пустыми.
• Нажмите Add, затем Connect. Войдите в Transcript Dock и выберите Allow access.

API-ключ не нужен: коннектор входит через ваш аккаунт и может отправлять задачи, читать их и читать транскрипты, но никогда не получает доступа к ключам, оплате или настройкам аккаунта. На тарифах Team и Enterprise владелец (Owner) добавляет коннектор один раз в разделе Organization settings, Connectors, а каждый участник подключается сам.

Claude Code#

Добавьте сервер, затем в Claude Code выполните /mcp и выберите Authenticate, чтобы войти.

claude mcp add --transport http transcriptdock https://www.transcriptdock.com/mcp

Для CI и скриптов передавайте API-ключ вместо входа в аккаунт:

claude mcp add --transport http transcriptdock https://www.transcriptdock.com/mcp \
  --header "Authorization: Bearer td_live_YOUR_KEY"

Cursor и другие клиенты#

{
  "mcpServers": {
    "transcriptdock": {
      "url": "https://www.transcriptdock.com/mcp",
      "headers": { "Authorization": "Bearer td_live_YOUR_KEY" }
    }
  }
}

Windsurf использует serverUrl вместо url, а VS Code перечисляет серверы в поле servers с "type": "http". Точные файлы есть на страницах клиентов ниже.

• Claude CodeОдна команда в терминале.
• Приложение Claudeclaude.ai, Desktop и мобильное приложение: добавьте пользовательский коннектор.
• CursorДобавьте в mcp.json.
• WindsurfДобавьте в mcp_config.json.
• OpenClawАвтономные агенты через stdio.

Локальный сервер#

Для клиентов, которые работают только через stdio, например OpenClaw, запустите тот же сервер локально с Node.js 22.15 или новее. Обе переменные обязательны.

{
  "mcpServers": {
    "transcriptdock": {
      "command": "npx",
      "args": ["-y", "@transcriptdock/mcp"],
      "env": {
        "TRANSCRIPTDOCK_API_KEY": "td_live_YOUR_KEY",
        "TRANSCRIPTDOCK_BASE_URL": "https://www.transcriptdock.com"
      }
    }
  }
}

Инструменты#

get_video_transcript#

Инструмент, к которому агент должен обращаться, когда его спрашивают, что говорится в видео.

urlstringОбязательный

URL видео на YouTube или TikTok.

mode"captions_only" | "auto" | "transcribe"Необязательный

По умолчанию captions_only (1 кредит). auto переходит на ИИ-транскрипцию, если у видео нет субтитров. transcribe всегда использует ИИ-транскрипцию (2 кредита за каждую начатую минуту, платные тарифы).

format"text" | "srt" | "vtt" | "segments"Необязательный

text (по умолчанию) самый компактный формат для агента. segments возвращает JSON с таймингами.

timeout_secondsintegerНеобязательный

По умолчанию 120. По истечении времени вместо результата возвращаются состояние задачи и её id.

{ "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }

Добро пожаловать на канал
Сегодня мы разберём субтитры
…

Повторный запрос того же видео в том же режиме получает ответ из сохранённого результата рабочего пространства, бесплатно.

transcribe, wait_for_job, get_transcript#

Трёхшаговый вариант для агентов, которым нужен контроль: transcribe принимает url, mode, необязательные language и max_credits, а также idempotency_key (любая постоянная строка длиной от 8 до 128 символов, чтобы повторный вызов никогда не отправлял задачу дважды), и возвращает задачу. wait_for_job принимает job_id и необязательный timeout_seconds. get_transcript принимает result_id задачи как transcript_id и format.

Поиск видео#

Инструменты поиска и списков возвращают видео с url, названием, длительностью и количеством просмотров. Их можно сразу передать в get_video_transcript. Параметр channel принимает @никнейм, id канала или ссылку на канал; playlist принимает id или ссылку на плейлист; user принимает @user TikTok или ссылку на профиль. Инструменты YouTube листаются постранично с параметрами limit (по умолчанию 20) и cursor. TikTok возвращает не больше 10 видео и без дополнительных страниц; include_details добавляет для каждого видео лайки, комментарии, хэштеги и языки субтитров.

Ошибки#

Неудачный вызов возвращает isError: true с кодом ошибки API, сообщением и request id, чтобы агент мог объяснить ошибку или изменить действия. Коды те же, что в справочнике API.

Решение проблем#

• Unauthorized: в Claude удалите коннектор и добавьте его заново, чтобы войти заново. С ключом он указывается в конфигурации сервера (в заголовке или в переменных окружения), а не в терминале. Проверьте, что ключ не отозван.
• Couldn't reach the MCP server: используйте точный URL https://www.transcriptdock.com/mcp, включая www.
• Tool not found: перезапустите клиент после изменения его конфигурации.
• Локальный сервер не запускается: установите Node.js 22.15 или новее и задайте обе переменные: TRANSCRIPTDOCK_API_KEY и TRANSCRIPTDOCK_BASE_URL.
• NO_CAPTIONS: у видео нет субтитров. На платном тарифе запросите mode: "auto".