mcp — протокол для ии-агентов

Агент расшифровывает запись сам — без вашего кода

Подключите Транскрибу к Claude, Cursor или своему агенту — и попросите его разобрать созвон человеческим языком. Ключ тот же, что и в API, баланс тот же, что на сайте: семь инструментов принимают ссылки и файлы, возвращают текст и субтитры, ищут по готовым расшифровкам и показывают остаток минут.

Claude Code, Cursor и HTTP-клиенты
{
  "mcpServers": {
    "transkriba": {
      "type": "http",
      "url": "https://transkriba.ru/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_…"
      }
    }
  }
}
Claude Desktop

Desktop запускает локальный stdio-мост к удалённому серверу. Вставьте этот блок в claude_desktop_config.json, подставьте свой ключ и перезапустите Claude.

{
  "mcpServers": {
    "transkriba": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://transkriba.ru/api/mcp",
        "--header",
        "Authorization:${TRANSKRIBA_AUTH}",
        "--transport",
        "http-only"
      ],
      "env": {
        "TRANSKRIBA_AUTH": "Bearer sk_live_…"
      }
    }
  }
}
Инструменты
transcribe_urlСсылка → расшифровка; diarize=true разделяет спикеров
create_uploadfile_name + size_bytes → PUT-ссылка до 256 МБ
transcribe_fileЗагруженный файл → расшифровка; поддерживает diarize
get_transcriptГотовый текст по job_id: реплики, SRT, VTT или JSON
list_transcriptsПоследние записи — чтобы найти вчерашнюю
search_transcriptsПоиск фразы в последних 200 расшифровках с таймкодом
get_balanceОстаток минут
Как это выглядит в работе
Разбери вчерашний созвон с подрядчиком и выпиши, что мы обещали по срокам
→ transkriba · transcribe_url
url: https://rutube.ru/video/<id>/
diarize: true
← Задача заведена
job_id = cmf8…
→ transkriba · get_transcript
job_id: cmf8…
← [00:11] Спикер 1:
Причины сдвига — подрядчик и согласование сметы…
По срокам вы обещали дважды и оба раза сдвигали.

• 00:11 — Сергей М. назвал причины: подрядчик и согласование сметы
• 00:26 — Анна К. зафиксировала третью дату как окончательную
• 00:38 — обещано разослать протокол в тот же день

Формулировка «больше к ней не возвращаемся» — самое сильное обязательство в разговоре.

Агент платит с того же баланса, что и вы на сайте. Суточный лимит ставится на каждый ключ отдельно — чтобы цикл в чужом коде не съел пакет за ночь.

О чём его просить

«Расшифруй эту лекцию и сделай конспект по темам»
«Найди в недавних созвонах, где обсуждали бюджет»
«Из этого подкаста собери статью с цитатами и таймкодами»
«Кто из участников чаще всего перебивал?»
«Выпиши все обещания со сроками и кто их дал»
«Сделай субтитры к этому ролику и переведи их»

Что стоит знать заранее

Расшифровка асинхронная

transcribe_url сначала проверяет ссылку и возвращает job_id, а не готовый текст. Агент забирает результат вторым вызовом — это описано прямо в описании инструмента, так что он делает это сам.

Поиск идёт по последним 200 записям

Этого хватает, пока расшифровок сотни. Если их станут десятки тысяч, понадобится полнотекстовый индекс — и тогда мы его сделаем.

Локальный файл — до 256 МБ

Передайте в create_upload имя и точный размер, например file_name: voice.ogg, size_bytes: 1048576. Ответ вернёт Content-Type и Content-Length: оба заголовка нужно без изменений передать в PUT. MCP загружает файл одним запросом; для файлов до 8 ГБ используйте multipart-загрузку в студии.

Расшифровка стоит минут

Минуты списываются после готового результата по фактической длительности записи. Поставьте ключу суточный лимит: перед новой задачей сервер учитывает уже списанные минуты и длительность текущих API- и MCP-задач этого аккаунта.

Ключ работает и в MCP, и в API
Создаётся в кабинете и показывается один раз. Проверьте фрагмент до 60 секунд бесплатно в студии.
HTTP APIСоздать ключ