# MCP-сервер > Дайте ИИ-ассистенту доступ к транскрибации через MCP. Настройки для Claude, ChatGPT, Cursor, VS Code, Claude Code и других клиентов. Canonical: https://transcript1.com/ru/docs/mcp Language: ru Last updated: 2026-10-15 Через MCP-сервер transcript1 ИИ-ассистент может получить текст видео или аудиофайла и прочитать его. Сервер работает удалённо по [Model Context Protocol](https://modelcontextprotocol.io/). Можно отправлять ссылки на YouTube, X, TikTok, Instagram, Facebook и Bluesky, а также загружать свои аудио- и видеофайлы. Остальные поддерживаемые публичные записи и ограничения перечислены в разделе [«Источники и параметры»](https://transcript1.com/ru/docs/sources-and-options). Пост должен быть публичным. Если в нём несколько видео, расшифруем первое. YouTube и X по-прежнему поддерживают субтитры; TikTok, Bluesky, Dailymotion и LinkedIn тоже позволяют получить подходящие дорожки на языке оригинала. В режиме `auto`, если субтитры недоступны, распознаём речь с помощью ИИ. Цена за минуту не меняется. У субтитров не с YouTube есть метки только для сегментов, даже если дорожка автоматическая: `words: null`. Режим `captions` (только субтитры) не скачивает аудио и не запускает STT. Определение говорящих и `source=stt`, наоборот, сразу используют аудио, без субтитров. Подробности — в разделе [«Источники и параметры»](https://transcript1.com/ru/docs/sources-and-options). - **Адрес сервера:** `https://api.transcript1.com/mcp`, транспорт — streamable HTTP. - **Вход и доступ:** Claude и ChatGPT подключаются через OAuth 2.1 — вы входите в transcript1 и разрешаете доступ. Для Cursor, VS Code, Claude Code и ИИ-агентов передайте API-ключ в `Authorization: Bearer t1_...`. Ключ можно создать на странице [«API keys»](https://transcript1.com/dashboard/account/tokens). Инструменты обращаются к `/v1` [REST API](https://transcript1.com/ru/docs/api-reference) с вашим ключом или токеном. Проверка параметров, списание минут и коды ошибок те же, что при обычных 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`. Если такой способ недоступен, в ответе есть ссылка на страницу загрузки в личном кабинете. Протокол разобран в разделе [«Загрузка файлов»](https://transcript1.com/ru/docs/uploads). ### Если нужен вебхук MCP-инструменты не принимают параметр вебхука. Для подписанных уведомлений используйте [вебхуки REST API](https://transcript1.com/ru/docs/webhooks). ## Claude В Claude удалённый MCP-сервер подключается как собственный коннектор. 1. Перейдите в настройки коннекторов Claude и добавьте свой коннектор. 2. Назовите его `transcript1`, в адрес сервера вставьте `https://api.transcript1.com/mcp`. 3. Войдите в transcript1 и разрешите доступ. Коннектор запросит `transcriptions:read` и `transcriptions:write`. После подключения можно попросить: «Расшифруй видео https://www.youtube.com/watch?v=dQw4w9WgXcQ». Возможность добавлять свои коннекторы зависит от тарифа Claude. ## ChatGPT Для ChatGPT также нужен собственный коннектор. 1. В настройках коннекторов ChatGPT добавьте свой коннектор к MCP-серверу. 2. Вставьте адрес `https://api.transcript1.com/mcp`. 3. Авторизуйтесь в transcript1 и разрешите доступ. Собственные коннекторы доступны не на всех тарифах ChatGPT и зависят от настроек рабочего пространства. Может понадобиться режим разработчика. ## Подключение к Cursor Для быстрого подключения нажмите [«Добавить transcript1 в Cursor»](cursor://anysphere.cursor-deeplink/mcp/install?name=transcript1&config=eyJ1cmwiOiJodHRwczovL2FwaS50cmFuc2NyaXB0MS5jb20vbWNwIn0=). Для ручной настройки добавьте сервер в `.cursor/mcp.json`. В заголовке `Authorization` укажите свой API-ключ: ```json { "mcpServers": { "transcript1": { "url": "https://api.transcript1.com/mcp", "headers": { "Authorization": "Bearer t1_YOURKEY" } } } } ``` ## VS Code Для быстрого подключения нажмите [«Добавить transcript1 в 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). Либо настройте сервер вручную в файле `.vscode/mcp.json` вашего проекта: ```json { "servers": { "transcript1": { "type": "http", "url": "https://api.transcript1.com/mcp", "headers": { "Authorization": "Bearer t1_YOURKEY" } } } } ``` ## Подключение к Claude Code Вставьте свой API-ключ вместо `t1_YOURKEY` и запустите команду: ```bash 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»](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 — короткая инструкция для ИИ-агента в файле `SKILL.md`. Она объясняет, как пользоваться transcript1. Если агент поддерживает навыки, добавьте ему файл [https://transcript1.com/.well-known/agent-skills/transcript1/SKILL.md](https://transcript1.com/.well-known/agent-skills/transcript1/SKILL.md). Для автоматического поиска навыка доступен индекс: `https://transcript1.com/.well-known/agent-skills/index.json`. ## Как инструменты сообщают об ошибках При ошибке инструмент возвращает код из REST API, описание и подсказку, что делать дальше. Ассистент получает их в формате `: . `. Например, если не хватает минут: ```text insufficient_minutes: 20 minutes needed, 3 remaining. Top up at https://transcript1.com/dashboard/billing ``` Список кодов есть в разделе [«Ошибки»](https://transcript1.com/ru/docs/errors). Если ошибка произошла при самой транскрибации, ответ придёт в том же формате — например, с кодом `media_private` или `no_captions`.