Инструменты MCP

Справочник предназначен для настройки AI-клиентов и понимания того, какие данные они получают. Все семь инструментов Slovix требуют авторизации и работают только для чтения.

Список инструментов

Инструмент	Назначение	Параметры
`list_recordings`	Список своих записей и состояние обработки	`query` — необязательная часть названия; `limit` — 1–100, по умолчанию 25
`get_recording`	Метаданные одной записи, папки и контекст встречи	`recording_id`
`get_summary`	Итоги в Markdown и состояние обработки	`recording_id`
`get_transcript`	Сохранённый итоговый транскрипт и состояние обработки	`recording_id`
`get_raw_transcript`	Страница событий исходного распознавания речи	`recording_id`; `offset` от 0; `limit` — 1–100, по умолчанию 100; `include_partial` — по умолчанию false
`list_folders`	Папки и количество записей	`favorites_only` — по умолчанию false
`get_folder_recordings`	Записи одной папки	`folder_id`; `limit` — 1–100, по умолчанию 50

Идентификатор записи recording_id можно взять из ответа list_recordings или скопировать в приложении, если действие доступно. Идентификаторы папок берите из ответов сервера: название папки нельзя передать вместо её folder_id.

Используйте ID из приложения

В открытой встрече нажмите «Скопировать ID встречи» в блоке сведений. Другой путь: «Записи» → «Действия» с тремя точками у нужной строки → «Скопировать ID встречи». Дождитесь сообщения «ID встречи скопирован.».

Скопированное значение — внутренний ID встречи (session_id в приложении), который MCP принимает как recording_id. Подставьте его вместо строки-заглушки в аргументы get_recording, чтобы проверить название и дату:

{
  "recording_id": "<скопированный ID встречи>"
}

Те же аргументы передайте в get_summary, чтобы прочитать итоги. ID не заменяет авторизацию и не открывает чужие записи.

При сообщении «Не удалось скопировать ID встречи. Попробуйте ещё раз.» повторите копирование. Если ошибка сохраняется или действия нет в вашей версии приложения, используйте list_recordings, как описано ниже. Подробнее — работа с библиотекой.

Найдите запись по названию

Пример аргументов list_recordings:

{
  "query": "планирование",
  "limit": 10
}

Поиск не учитывает регистр и проверяет вхождение текста в название. Ответ содержит recordings и total. Список включает метаданные, а не полные итоги или расшифровки: для содержания нужен отдельный вызов.

У list_recordings и get_folder_recordings нет параметра offset. При total, превышающем возвращённое число записей, нельзя обещать полный обход библиотеки. Сузьте запрос по названию или выберите подходящую папку; лимит одного списка всё равно не превышает 100.

Прочитайте итоги и транскрипт

Передайте recording_id в get_summary или get_transcript. Ответ включает состояние status, сообщение error_message, если оно есть, и соответствующее текстовое поле summary либо transcript.

Название get_transcript не означает, что текст обязательно улучшен отдельной моделью: фактическое содержание зависит от выбранного для встречи режима обработки. Для исходных событий распознавания используйте get_raw_transcript.

Если данные пока не готовы, клиент должен сообщить об этом, а не интерпретировать отсутствие текста как пустую встречу. Исправление и повторный запуск обработки выполняются в desktop-приложении.

Прочитайте длинную исходную расшифровку

Первый вызов get_raw_transcript:

{
  "recording_id": "<id из списка записей>",
  "offset": 0,
  "limit": 100,
  "include_partial": false
}

Ответ содержит events, total и next_offset. События включают источник, время начала и конца в миллисекундах, текст, признак завершённости и другие сведения о распознавании.

Если next_offset не равен null, повторите вызов с этим значением в offset. Продолжайте до null. Лимит относится к числу событий, а не символов или минут.

По умолчанию возвращаются завершённые фрагменты. include_partial: true включает промежуточные результаты, которые могут повторять или уточнять друг друга. Для анализа законченного разговора обычно оставляйте false.

Работа с папками

Вызовите list_folders с favorites_only: true, если нужны только избранные.
Выберите папку по названию и получите её folder_id.
Передайте его в get_folder_recordings.
Для выбранных встреч отдельно запросите итоги или транскрипты.

Пометка папки избранной не сужает права токена. Она лишь фильтрует результат одного запроса.

Ошибки и ограничения доступа

Отозванное или просроченное подключение нужно обновить по инструкции подключения. Чужая или удалённая запись недоступна, даже если известен её идентификатор.

Запись аудио, экспорт бинарных файлов, редактирование, пересборка итогов и удаление данных не входят в эти семь инструментов. Не ожидайте таких действий от MCP Slovix.