MCP-сервер | transcript1 docs

Через MCP-сервер transcript1 ИИ-ассистент может получить текст видео или аудиофайла и прочитать его. Сервер работает удалённо по Model Context Protocol. Можно отправлять ссылки на YouTube, X, TikTok, Instagram, Facebook и Bluesky, а также загружать свои аудио- и видеофайлы. Остальные поддерживаемые публичные записи и ограничения перечислены в разделе «Источники и параметры».

Пост должен быть публичным. Если в нём несколько видео, расшифруем первое. YouTube и X по-прежнему поддерживают субтитры; TikTok, Bluesky, Dailymotion и LinkedIn тоже позволяют получить подходящие дорожки на языке оригинала. В режиме auto, если субтитры недоступны, распознаём речь с помощью ИИ. Цена за минуту не меняется.

У субтитров не с YouTube есть метки только для сегментов, даже если дорожка автоматическая: words: null. Режим captions (только субтитры) не скачивает аудио и не запускает STT. Определение говорящих и source=stt, наоборот, сразу используют аудио, без субтитров. Подробности — в разделе «Источники и параметры».

Адрес сервера: https://api.transcript1.com/mcp, транспорт — streamable HTTP.
Вход и доступ: Claude и ChatGPT подключаются через OAuth 2.1 — вы входите в transcript1 и разрешаете доступ. Для Cursor, VS Code, Claude Code и ИИ-агентов передайте API-ключ в Authorization: Bearer t1_.... Ключ можно создать на странице «API keys».

Инструменты обращаются к /v1 REST API с вашим ключом или токеном. Проверка параметров, списание минут и коды ошибок те же, что при обычных API-запросах. MCP расходует общий баланс минут и общий лимит запросов аккаунта.

Инструменты

Инструмент	Как использовать
`transcribe`	Передайте поддерживаемую ссылку в `url`. При необходимости укажите `platform`, `source`, `language`, `diarize`, `format`, `wait_seconds`. Платформа определяется по адресу. Инструмент ждёт готового текста и возвращает его первую страницу; если не успел дождаться — `id` задачи.
`get_transcription`	Передайте `id`, чтобы узнать статус или прочитать текст. Дополнительно доступны `wait_seconds`, `format`, `from_seconds`, `max_chars`.
`list_transcriptions`	Получите список задач от новых к старым, без текста транскриптов. Необязательные параметры: `status`, `platform`, `limit`, `cursor`.
`create_upload`	Подготовьте загрузку локального файла по частям. Обязательны `filename`, `size`, `request_id` — UUID, который нужно сгенерировать. Дополнительно можно указать `mime_type`, `language`, `diarize`.
`get_upload_status`	Проверьте, какие части уже получены, чтобы продолжить загрузку.
`complete_upload`	Завершите загрузку: инструмент проверит части и поставит транскрибацию в очередь.
`delete_transcription`	Отмените текущую задачу с возвратом минут или удалите завершённую вместе с транскриптом.
`get_account`	Проверьте баланс минут, текущий тариф и дату продления.

Формат ответа и ожидание

По умолчанию format=text: каждый сегмент занимает одну строку с временной меткой. Если включено определение говорящих, добавляется метка участника, например [00:01:02] Speaker 1: Good morning. Другие форматы — srt, vtt, json.
Инструмент ждёт wait_seconds секунд: по умолчанию 50, допустимо от 0 до 55. Если задача ещё выполняется, ответ сообщит об этом и вернёт id. Передайте его в get_transcription, чтобы продолжить ожидание.
Длинный текст приходит по страницам. Параметр max_chars задаёт размер: по умолчанию 60 000, можно от 1 000 до 100 000. Страница заканчивается на границе сегмента. Чтобы получить следующую, передайте значение next_from_seconds из ответа в параметр from_seconds.
Источник текста всегда указан в transcript_source: youtube_captions, x_captions, tiktok_captions, bluesky_captions, dailymotion_captions, linkedin_captions или speech_to_text. Так ассистент различает субтитры и распознавание речи. Значение caption_kind: null означает, что происхождение дорожки неизвестно. Считать её субтитрами автора нельзя.

Не создавайте задачу заново, если она уже есть

Инструмент transcribe всегда передаёт reuse_recent. Если полная ссылка ведёт на то же видео и параметры не изменились, в течение 24 часов вы получите предыдущую транскрибацию без повторного списания. В ответе будет отмечено, что использована прежняя задача. Для коротких ссылок этот механизм не работает.

Если задача уже создана, лучше проверить её через get_transcription или найти через list_transcriptions, а не отправлять видео снова.

Как отправить файл

Сами байты файла через MCP не передаются. Сначала ассистент вызывает create_upload и получает id задачи, список частей, шаблон URL и X-Upload-Token. Затем отправляет части обычными HTTP-запросами PUT, вне MCP, и вызывает complete_upload. Если такой способ недоступен, в ответе есть ссылка на страницу загрузки в личном кабинете. Протокол разобран в разделе «Загрузка файлов».

Если нужен вебхук

MCP-инструменты не принимают параметр вебхука. Для подписанных уведомлений используйте вебхуки REST API.

Claude

В Claude удалённый MCP-сервер подключается как собственный коннектор.

Перейдите в настройки коннекторов Claude и добавьте свой коннектор.
Назовите его transcript1, в адрес сервера вставьте https://api.transcript1.com/mcp.
Войдите в transcript1 и разрешите доступ. Коннектор запросит transcriptions:read и transcriptions:write.

После подключения можно попросить: «Расшифруй видео https://www.youtube.com/watch?v=dQw4w9WgXcQ». Возможность добавлять свои коннекторы зависит от тарифа Claude.

ChatGPT

Для ChatGPT также нужен собственный коннектор.

В настройках коннекторов ChatGPT добавьте свой коннектор к MCP-серверу.
Вставьте адрес https://api.transcript1.com/mcp.
Авторизуйтесь в transcript1 и разрешите доступ.

Собственные коннекторы доступны не на всех тарифах ChatGPT и зависят от настроек рабочего пространства. Может понадобиться режим разработчика.

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

Для быстрого подключения нажмите «Добавить transcript1 в Cursor».

Для ручной настройки добавьте сервер в .cursor/mcp.json. В заголовке Authorization укажите свой API-ключ:

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

VS Code

Для быстрого подключения нажмите «Добавить transcript1 в VS Code».

Либо настройте сервер вручную в файле .vscode/mcp.json вашего проекта:

{
  "servers": {
    "transcript1": {
      "type": "http",
      "url": "https://api.transcript1.com/mcp",
      "headers": {
        "Authorization": "Bearer t1_YOURKEY"
      }
    }
  }
}

Подключение к Claude Code

Вставьте свой API-ключ вместо t1_YOURKEY и запустите команду:

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

Подключение других клиентов

Если клиент поддерживает удалённые MCP-серверы, укажите https://api.transcript1.com/mcp и добавьте заголовок Authorization: Bearer t1_....

Запуск через команду в Claude Desktop и других клиентах

Если клиент умеет запускать MCP-сервер только командой, используйте npx -y @transcript1/mcp. Передайте API-ключ через TRANSCRIPT1_API_KEY. Этот пакет подключается к удалённому серверу transcript1; для запуска нужен Node.js 18 или новее.

Для Claude Desktop добавьте конфигурацию ниже в claude_desktop_config.json. Вместо t1_YOURKEY укажите ключ со страницы «API keys».

{
  "mcpServers": {
    "transcript1": {
      "command": "npx",
      "args": ["-y", "@transcript1/mcp"],
      "env": { "TRANSCRIPT1_API_KEY": "t1_YOURKEY" }
    }
  }
}

Agent Skill

Agent Skill — короткая инструкция для ИИ-агента в файле SKILL.md. Она объясняет, как пользоваться transcript1. Если агент поддерживает навыки, добавьте ему файл https://transcript1.com/.well-known/agent-skills/transcript1/SKILL.md.

Для автоматического поиска навыка доступен индекс: https://transcript1.com/.well-known/agent-skills/index.json.

Как инструменты сообщают об ошибках

При ошибке инструмент возвращает код из REST API, описание и подсказку, что делать дальше. Ассистент получает их в формате <code>: <message>. <next step>. Например, если не хватает минут:

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

Список кодов есть в разделе «Ошибки». Если ошибка произошла при самой транскрибации, ответ придёт в том же формате — например, с кодом media_private или no_captions.