Подключение ONLYOFFICE Apps MCP Server к Mistral
Введение
ONLYOFFICE Apps MCP Server — это инструмент для управления взаимодействием с языковыми моделями, который повышает эффективность работы, упрощает рабочие процессы на основе ИИ, управление документами и задачами и помогает раскрыть весь потенциал ONLYOFFICE Apps.
ONLYOFFICE Apps MCP Server можно подключить к клиентам, которые поддерживают подключение к MCP-серверам, работающим на удаленной машине.
Публичный экземпляр доступен по адресу https://mcp.onlyoffice.com/mcp для клиентов, поддерживающих современный транспорт Streamable HTTP, и по адресу https://mcp.onlyoffice.com/sse для клиентов, поддерживающих только устаревший транспорт SSE. Мы рекомендуем по возможности использовать транспорт Streamable HTTP.
Для подключения ONLYOFFICE Apps MCP Server к Mistral можно использовать два способа аутентификации: OAuth и API Token Authentication (аутентификация по API-токену). Второй способ применяется с клиентами, которые позволяют передавать конфигурацию в пользовательских заголовках и параметрах запроса. Мы рекомендуем по возможности использовать аутентификацию OAuth.
Чтобы добавить коннектор ONLYOFFICE Apps MCP Server в Mistral:
-
Войдите в свою учетную запись Mistral Chat.
-
Перейдите в Intelligence → Connectors на левой панели и нажмите кнопку Add connector.
-
Выберите Custom MCP Connector в правом верхнем углу и настройте параметры MCP-сервера:
Аутентификация OAuth
-
Введите название коннектора.
-
Connector Server — вставьте URL-адрес сервера ONLYOFFICE MCP:
https://mcp.onlyoffice.com/mcp -
Description — кратко опишите MCP-сервер, чтобы его было проще определить. Этот параметр необязателен.
-
Authorization Method — выберите OAuth2.1 как способ авторизации для Apps MCP Server и нажмите Connect.
-
Завершите процесс аутентификации OAuth:
-
Введите свои учетные данные от Apps.
-
Разрешите удаленному MCP-серверу доступ к вашей учетной записи Apps.
-
Аутентификация по API-токену
Используйте этот способ аутентификации, только если по какой-то причине не можете использовать OAuth, так как он менее безопасен. Он позволяет подключить MCP-сервер, передав API-ключ в заголовке по умолчанию, а базовый URL-адрес — в параметре запроса.
-
Создайте собственный API-ключ Apps. Не рекомендуется использовать API-ключи владельца или менеджера комнаты. Чтобы создать API-ключ, перейдите в Apps. Откройте вкладку «Инструменты разработчика» на левой панели. Выберите вкладку «Ключи API» вверху и нажмите кнопку «Создать новый секретный ключ». Скопируйте созданный ключ.
-
Введите название коннектора.
-
Connector Server — добавьте базовый URL-адрес вашего экземпляра Apps к URL-адресу ONLYOFFICE Apps MCP Server и передайте его через параметры запроса, соблюдая следующую структуру:
https://mcp.onlyoffice.com/mcp?base_url=https://your-instance.onlyoffice.com -
Description — кратко опишите MCP-сервер, чтобы его было проще определить. Этот параметр необязателен.
-
Authorization Method — выберите API Token Authentication как способ авторизации для Apps MCP Server.
Default header — добавьте свой API-ключ Apps в заголовок Authorization как токен Bearer. Этот параметр обязателен, так как данный заголовок используется для авторизации запросов к Apps.
Authorization: Bearer sk-a499e... -
Нажмите Create, чтобы добавить Apps MCP Server в коннекторы Mistral.
Использование ONLYOFFICE MCP Server
-
После успешной аутентификации коннектор Apps появится среди доступных коннекторов.
-
Нажмите на него, чтобы открыть обзор коннектора и его функции. На вкладке Overview отображается описание коннектора, которое вы указали при настройке, а по нажатию на многоточие можно удалить коннектор.
-
На вкладке Functions можно просмотреть доступные инструменты и включить нужные.
-
Откройте чат и введите запрос. В списке Connectors убедитесь, что выбран Apps (или назначенное вами имя).
-
Нажмите Continue, чтобы подтвердить список инструментов, используемых для ответа на ваш запрос.
