Сервер AI Drive MCP

Поиск и чтение документов Keural Drive из внешних клиентов MCP, таких как Claude Desktop.

Drive Keural также предоставляется как сервер MCP. Внешний клиент MCP, подключившийся к этому серверу, может искать документы Drive, доступные пользователю с ключом, и читать их постранично. Плагины подключают внешнюю систему к Keural, а этот сервер подключает документы Keural к внешнему ИИ.

Для аутентификации используется ключ API организации. Ключ API организации выдаёт операционная сторона Keural, поэтому запросите его у контактного лица при подключении. Ключ работает с правами одного пользователя, которому он выдан, и требует разрешения drive:read. Если ключ отозвать, уже существующие подключения блокируются в течение 1 минуты.

Данные подключения

Параметр	Значение
Способ передачи	MCP Streamable HTTP
Адрес	`https://<домен сервера агентов для среды>/core/v1/mcp-drive`
Аутентификация	`Authorization: Bearer <ключ API организации>` (в каждом запросе)

Способы запроса

Метод	Назначение
`POST`	Один запрос JSON-RPC. Ответ всегда один, в формате `application/json`. Уведомления (`notifications/*`) возвращают `202` без тела.
`GET`	Поток событий сервера. Требует `Accept: text/event-stream` и `Mcp-Session-Id`. Отправляет keepalive каждые 15 секунд и продолжает приём с `Last-Event-ID`.
`DELETE`	Завершение сеанса. Требует `Mcp-Session-Id` и возвращает `204`.

При успешном initialize ID сеанса возвращается в заголовке ответа Mcp-Session-Id. Сеанс необязателен: можно отправлять только POST, без сеанса. Сеанс сохраняется 1 час после последнего запроса и привязан к ключу, которым был создан.
Заголовок MCP-Protocol-Version необязателен, но если он отправлен, его значение должно быть 2025-06-18.
Информация о сервере: keural-ai-drive, единственная предоставляемая возможность: tools.

Ошибки HTTP

Ошибки уровня HTTP не имеют формата JSON-RPC, поэтому сначала проверяйте код состояния.

Состояние	Причина
`401`	Ключ отсутствует или неверен, ключ отозван или истёк
`403`	У ключа нет разрешения `drive:read`
`400`	Неподдерживаемый `MCP-Protocol-Version`, ошибка разбора JSON (`-32700`), отсутствует ID сеанса для `GET` или `DELETE`
`404`	Неизвестный или истёкший ID сеанса
`405`	В `GET` нет `Accept: text/event-stream`

Ошибки уровня JSON-RPC возвращаются с кодом 200 в виде error. Неизвестный метод или инструмент: -32601, неверный формат запроса: -32600.

Инструменты

Инструмент	Вход	Описание
`list_files`	Нет	Список доступных документов (название, id, дата загрузки, дата изменения, а если загрузил другой человек, то загрузивший). Документы Drive и файлы, прикреплённые в чатах, выводятся вместе и различаются по `origin`. До 500 элементов; если их больше, добавляется `truncated: true`
`search_drive`	`query`	Ищет по смыслу в содержимом документов и возвращает подходящие фрагменты и сведения для цитирования
`read_document_page`	`file_id`, `page`	Читает полный текст указанной страницы документа. `file_id` берётся из результатов двух инструментов выше, `page` отсчитывается с 1

Результат инструмента передаётся как JSON-строка в content[0].text.

Инструмент	JSON внутри `text`
`list_files`	`{"files":[{"name","id","created_date","modified_date","owner_name","origin"}], "truncated": false}`. Даты в формате `yyyy-MM-dd HH:mm`
`search_drive`	`{"sources":[{"id","name","url","contents":[…]}]}`
`read_document_page`	`{"file_id","page","rows":[…]}`

Если выполнение инструмента завершилось ошибкой, возвращается isError: true и {"error": "…"} (это не ошибка JSON-RPC). Документы, которые нельзя просмотреть, и несуществующие документы всегда получают ответ file not found or not accessible.

Пример настройки клиента

Зарегистрируйте адрес и заголовок в клиенте, который поддерживает удалённые серверы MCP. Формат настройки отличается в зависимости от клиента, поэтому следуйте инструкции вашего клиента по добавлению удалённого сервера MCP.

{
  "mcpServers": {
    "keural-drive": {
      "type": "http",
      "url": "https://<домен сервера агентов для среды>/core/v1/mcp-drive",
      "headers": { "Authorization": "Bearer <ключ API организации>" }
    }
  }
}

Поддерживаемая версия протокола MCP: 2025-06-18.

Сервер AI Drive MCP

Данные подключенияКопировать ссылку на раздел

Способы запросаКопировать ссылку на раздел

Ошибки HTTPКопировать ссылку на раздел

ИнструментыКопировать ссылку на раздел

Пример настройки клиентаКопировать ссылку на раздел

На этой странице

Данные подключения

Способы запроса

Ошибки HTTP

Инструменты

Пример настройки клиента