Слово
Войти

Документация

MCP Слова

Подключите Слово к AI-ассистенту: он отправит запись по ссылке и прочитает текст с участниками и таймкодами. Сервер работает по Streamable HTTP, вход — через OAuth.

Содержание

Подключение

https://slowo.io/api/mcp

  1. Добавьте сервер

    Укажите адрес в настройках MCP ассистента. Клиент должен поддерживать удалённые серверы и вход через OAuth. Для Claude Code и Codex — команды по их документации:

    Добавить сервер · Claude Code
    claude mcp add --transport http slowo --scope user https://slowo.io/api/mcp

    Работу с конкретным клиентом проверьте у себя. Только для чтения в Codex укажите --scopes slowo:read.

  2. Разрешите доступ

    Ассистент откроет страницу Слова. Войдите, проверьте название и адрес возврата и подтвердите разрешения, которые запросил ассистент. Если он подключился только для чтения, то при первой отправке записи попросит разрешение slowo:transcribe — подтвердите его или переподключите ассистента.

  3. Проверьте

    Попросите ассистента вызвать slowo_get_usage: он покажет доступное время.

Если ассистент умеет настраивать себя сам, дайте ему эту инструкцию:

Инструкция для ассистента
Подключи Слово как MCP-сервер: https://slowo.io/api/mcp
Транспорт — Streamable HTTP, вход — OAuth.
Если такой сервер уже есть, используй его и не меняй другие настройки MCP.
Вход и разрешения я подтвержу в браузере сам.
Не проси ключи и пароли в чате и не сохраняй их в файлах проекта.
Проверь список инструментов и вызови slowo_get_usage.
Не отправляй запись на распознавание во время настройки.

Права доступа

РазрешениеЧто можно
slowo:readСписок записей, статус, текст, экспорт и расход времени.
slowo:transcribeЕщё и отправка записей на распознавание — за счёт вашего баланса. Запрашивается вместе с чтением.

Ассистент видит только записи, отправленные через API и MCP. Доступ действует до 90 дней. Не вставляйте ключ API в адрес сервера или в чат: вход проходит в браузере.

Как работать с записью

Ассистент передаёт audio_url — прямую публичную HTTPS-ссылку на файл, путь которой заканчивается расширением медиафайла. Ссылка должна оставаться доступной до 15 минут после отправки. Страница YouTube или VK — не прямая ссылка.

Аргументы slowo_create_transcription
{
  "audio_url": "https://example.com/interviews/interview-7.mp3",
  "idempotency_key": "a7e32d24-a18c-4e65-93fb-4f04e5b0856c",
  "language": "auto",
  "external_id": "interview-7"
}

В ответ приходит id и статус, а не текст. Ассистент запрашивает slowo_get_transcription с паузами, пока статус не станет ready или failed. Готовый текст приходит частями: следуйте next_segment_offset, пока он не станет null.

Сервер не видит файлов на вашем компьютере. Загрузите файл через API, а затем прочитайте результат через MCP, или выложите файл по прямой ссылке.

Инструменты

Незнакомые аргументы отклоняются. Звёздочкой отмечены обязательные.

ИнструментАргументыРезультат
slowo_create_transcriptionaudio_url*, idempotency_key* (UUID), language (auto, ru, en), external_id (до 200 символов)Запись и её статус. Нужно разрешение slowo:transcribe.
slowo_list_transcriptionspage (с 1), page_size (до 50, по умолчанию 20)Список записей и total.
slowo_get_transcriptionid*, segment_offset (с 0), segment_limit (до 500, по умолчанию 100)Статус; для готовой записи — text, segments, speakers и next_segment_offset.
slowo_export_transcriptionid*, format (txt или srt)Файл до 1 МиБ. DOCX — через API.
slowo_get_usageбез аргументовДоступное время, расход по API и MCP, лимиты аккаунта.

Повторы и лимиты

Для каждой новой записи ассистент создаёт UUID. Если ответ потерялся, он повторяет вызов с тем же UUID и теми же аргументами — и получает ту же запись без второго списания; изменённые аргументы вернут IDEMPOTENCY_CONFLICT. Повтор работает 24 часа, через 30 дней ключ забывается; API и MCP используют общий набор этих ключей.

Лимиты аккаунта общие для API и MCP, текущие значения возвращает slowo_get_usage. Ошибки приходят как {error: {code, message}} с признаком isError. Если доступ истёк или отозван, подключитесь заново; если не хватает разрешения, переподключитесь с нужным.

Экспорт больше 1 МиБ отклоняется — читайте текст частями или скачайте файл через API. Если у клиента маленький контекст, запрашивайте меньше реплик за раз.

Отключение

Откройте Профиль → «API и MCP» и нажмите «Отключить» рядом с ассистентом. Его доступ сразу перестанет работать, а уже принятые записи будут распознаны.

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