# MCP-транскрибация для ваших ИИ-ассистентов

> MCP-транскрибация видео из соцсетей и файлов в Claude, ChatGPT или редакторе кода: OAuth или API-ключ для подключения, текст с временными метками.

Canonical: https://transcript1.com/ru/features/mcp-transkribatsiya
Language: ru
Last updated: 2026-10-19

MCP-транскрибация позволяет поручить ассистенту расшифровку видео или записи. Подойдут ссылки YouTube, X, TikTok, Instagram, Facebook, Bluesky, Dailymotion, видеопосты LinkedIn и Snapchat Spotlight, клипы и завершённые VOD с Twitch, видеопины Pinterest, а также загруженные файлы. Claude и ChatGPT подключаются через OAuth, Cursor, VS Code и Claude Code — с API-ключом.

- Для Claude, ChatGPT, Cursor, VS Code и Claude Code
- Общая с REST API квота минут и те же ограничения
- Полная ссылка позволяет повторно использовать транскрипт за последние 24 часа

## Подключите сервер и поручите ассистенту работу с записью

### Без локального сервера

Подключитесь к https://api.transcript1.com/mcp по streamable HTTP. Устанавливать сервер на свой компьютер не нужно.

### Вход или API-ключ

В Claude и ChatGPT пройдите вход через OAuth. Для Cursor, VS Code, Claude Code и своих агентов передайте API-ключ как Bearer-токен.

### Инструменты для всего процесса

Доступны transcribe, get_transcription, list_transcriptions, create_upload, get_upload_status, complete_upload, delete_transcription и get_account.

### Длинные записи читаются частями

Транскрипт делится на страницы по границам сегментов. По умолчанию ассистент получает текст с временной меткой в начале каждой строки.

### Готовый текст можно использовать повторно

Для полной ссылки transcribe ищет подходящую транскрибацию за последние 24 часа. Короткие ссылки так сопоставить нельзя. Если ID уже известен, читайте задачу через get_transcription.

## Подключите MCP к Cursor для расшифровки видео

Добавьте адрес сервера и API-ключ в .cursor/mcp.json. Для VS Code используйте тот же адрес в .vscode/mcp.json, но формат настроек будет другим. В [инструкции по MCP](https://transcript1.com/ru/docs/mcp) есть установка в один клик для обоих редакторов.

Клиент должен поддерживать удалённые MCP-серверы по streamable HTTP и передавать заголовок Authorization в запросах. Копируйте настройки именно для своего приложения: переименовать файл Cursor в файл VS Code недостаточно.

После подключения попросите ассистента вызвать get_account или list_transcriptions. Так вы проверите доступ без платной транскрибации. Если инструменты не появились, проверьте, загрузил ли клиент настройки и включён ли сервер. При ошибке авторизации проверьте ключ в настройках клиента.

### .cursor/mcp.json

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

## Как подключить Claude Code, Claude и ChatGPT

В Claude Code выполните claude mcp add с адресом сервера и API-ключом. В Claude добавьте пользовательский коннектор с этим адресом и войдите в аккаунт; ChatGPT использует тот же URL. [Пошаговая настройка](https://transcript1.com/ru/docs/mcp#claude) зависит от клиента.

Коннекторы Claude и ChatGPT используют OAuth. Их доступность зависит от тарифа ассистента и настроек рабочей области. Подключение редактора кода по API-ключу устроено иначе, поэтому следуйте инструкции для своего приложения.

Когда инструменты появятся, дайте ассистенту публичную ссылку и конкретную задачу. Например, попросите расшифровать ролик Instagram, а затем выделить из текста инструкции. transcript1 передаст слова из записи. Что показано в кадре, ассистент по одному транскрипту не узнает.

### Claude Code

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

## Сначала получите транскрипт, затем работайте с текстом

Ассистент вызывает transcribe, ждёт и читает первую страницу. Если запись ещё обрабатывается, получает ID для get_transcription. Параметры есть в [справочнике инструментов](https://transcript1.com/ru/docs/mcp#tools), а порядок работы — в [руководстве для ИИ-агентов](https://transcript1.com/ru/use-cases/transkripty-dlya-ii-agentov).

По умолчанию приходит текст с временными метками. Если есть next_from_seconds, передайте его как from_seconds, чтобы прочитать следующую страницу. Первая страница может быть лишь началом записи: до чтения остальных нужных фрагментов нельзя выдавать пересказ всего видео.

Полные поддерживаемые ссылки позволяют использовать подходящую транскрибацию за последние 24 часа. Для короткой ссылки такого сопоставления при отправке нет. В любом случае чтение известного ID через get_transcription не создаёт новую задачу. В примере ниже замените заглушку реальной публичной ссылкой TikTok.

### Пример вызовов ассистента

```
transcribe(url="[public TikTok video URL]")

get_transcription(id="tr_8fK2Lm0PqRsTuVwXyZaBcD", format="srt")
```

## Что нужно для расшифровки локального файла

Через MCP передаются параметры и ответы, а не байты записи. Инструмент create_upload создаёт загрузку и возвращает план частей. Затем агент должен сам прочитать файл, отправить части по HTTP вне MCP и вызвать complete_upload. Эта граница подробно описана в [инструкции по файлам](https://transcript1.com/ru/docs/mcp#files).

Не каждый ассистент умеет читать локальные файлы и отправлять бинарные данные по HTTP. В таком случае загрузите запись в личном кабинете и передайте ассистенту ID готовой транскрибации. Одного имени файла в чате недостаточно, чтобы transcript1 получил его содержимое.

Для вебхуков используйте REST API: инструменты MCP не принимают этот параметр. В диалоге удобнее подождать ограниченное время, затем проверить get_transcription. Если клиент отключился, найдите задачу в списке или продолжите по ID. Обрыв вызова не означает, что задача не создалась.

Через то же подключение можно разобрать [видео Bluesky](https://transcript1.com/ru/features/rasshifrovka-video-bluesky) или [текст ролика TikTok](https://transcript1.com/ru/features/rasshifrovka-tiktok). Правила источников не меняются: пост должен быть публичным, а содержание кадра нельзя выводить из слов, если никто не просмотрел само видео.

## Частые вопросы

### С какими ассистентами работает сервер?

С Claude и ChatGPT через пользовательские коннекторы, с Cursor и VS Code через установку в один клик, с Claude Code через одну команду. Подойдёт и другой клиент с поддержкой удалённых MCP-серверов.

### Где нужен API-ключ, а где достаточно входа?

Claude и ChatGPT используют вход через OAuth. Другие клиенты отправляют ключ с префиксом t1_ в заголовке Authorization. Создать ключ можно на странице «API keys» в личном кабинете.

### Ассистент сможет расшифровать файл с компьютера?

Да, если он умеет читать файл и отправлять его байты по HTTP. Сначала create_upload создаёт загрузку, затем ассистент передаёт части вне MCP, а complete_upload ставит запись в очередь на обработку.

### Для MCP нужна отдельная квота минут?

Нет. Инструменты обращаются к тому же API с вашими учётными данными. Квота минут, тарификация, ограничения частоты запросов и коды ошибок совпадают с REST API.

## Читайте также

- [ИИ-агенты и LLM](https://transcript1.com/ru/use-cases/transkripty-dlya-ii-agentov)
- [MCP-сервер (документация)](https://transcript1.com/ru/docs/mcp)
- [Текст из TikTok](https://transcript1.com/ru/features/rasshifrovka-tiktok)
- [API для аудио и видео](https://transcript1.com/ru/features/speech-to-text-api)
