MCP-сервер ONLYOFFICE DocSpace

Model Context Protocol (MCP) — это стандартизированный протокол для управления контекстом между большими языковыми моделями (LLM) и внешними системами. В этом репозитории представлен MCP-сервер для ONLYOFFICE DocSpace.

MCP-сервер DocSpace напрямую подключает ИИ-инструменты к ONLYOFFICE DocSpace. Это дает ИИ-агентам, помощникам и чат-ботам возможность управлять комнатами, совместно работать с файлами, настраивать права доступа и автоматизировать документооборот — и все это с помощью взаимодействия на естественном языке.

Функции

• Инструменты с детальным контролем — Доступ к инструментам, организованным в логические наборы с возможностью тонкой настройки включения/отключения и мета-инструментами.

• Несколько транспортных протоколов — Поддержка stdio, SSE и Streamable HTTP транспортов.

• Различные методы аутентификации — Поддержка API-ключей, персональных токенов доступа (PAT), базовой аутентификации и OAuth 2.0 с динамической регистрацией клиентов. См. примеры.

• Конфигурация на уровне запроса — Настройка аутентификации и выбор инструментов во время инициализации сессии с использованием пользовательских HTTP-заголовков.

• Различные форматы распространения — Доступен в виде Docker-образа, Docker MCP-сервера, MCP-бандла и Node.js приложения.

Related MCP server: LibreOffice MCP Tools

Варианты использования

• Управление комнатами: Создание, обновление и архивирование комнат. Настройка типов комнат, управление участниками и контроль уровней доступа.

• Операции с папками и файлами: Создание папок, загрузка документов, пакетное копирование или перемещение элементов, переименование или удаление контента, а также проверка сведений о файлах или папках.

• Совместная работа и права доступа: Приглашение или удаление пользователей, настройка параметров безопасности и проверка текущих прав доступа для комнат и общих пространств.

• Доступ к контенту: Получение доступа к папкам «Мои документы» или «Комнаты», просмотр содержимого папок, скачивание файлов в текстовом формате и мониторинг текущих файловых операций.

• Справочник пользователей: Просмотр всех пользователей на портале для упрощения приглашений и управления доступом.

Подключение клиентов к MCP-серверу DocSpace

Вы можете подключиться к MCP-серверу DocSpace, используя любые MCP-клиенты. Мы рассмотрели некоторые популярные клиенты, такие как Claude Desktop, Cursor, Windsurf и другие, и здесь вы можете прочитать об этом подробнее.

Удаленный MCP-сервер DocSpace

Удаленный MCP-сервер DocSpace размещен на мощностях ONLYOFFICE и предоставляет самый быстрый способ начать использование инструментов DocSpace внутри вашего ИИ-агента. Вы можете подключиться к нему мгновенно, не развертывая и не настраивая ничего на своем компьютере.

Публичный экземпляр доступен по адресу https://mcp.onlyoffice.com/mcp для клиентов, поддерживающих современный транспорт Streamable HTTP, и по адресу https://mcp.onlyoffice.com/sse для клиентов, поддерживающих только устаревший транспорт SSE. По возможности предпочтительнее использовать транспорт Streamable HTTP.

Все варианты подключения клиентов к удаленному MCP-серверу DocSpace см. здесь.

Локальный MCP-сервер DocSpace

Если ваш MCP-хост не поддерживает удаленные MCP-серверы, вы можете запустить локальную версию MCP-сервера DocSpace.

Большинство клиентов, реализующих протокол MCP, имеют общий конфигурационный файл в формате JSON, в который можно добавить локальный MCP-сервер ONLYOFFICE DocSpace.

Примечание: Общий пример ниже применим для Docker-образа, поэтому Docker должен быть установлен в вашей системе.

Шаг 1. Найдите файл конфигурации

Найдите файл конфигурации .json вашего клиента.

Шаг 2. Добавьте запись MCP-сервера DocSpace

Вставьте следующий блок в раздел mcpServers вашего конфигурационного файла .json:

{
	"mcpServers": {
		"onlyoffice-docspace": {
			"command": "docker",
			"args": [
				"run",
				"--interactive",
				"--rm",
				"--env",
				"DOCSPACE_BASE_URL",
				"--env",
				"DOCSPACE_API_KEY",
				"onlyoffice/docspace-mcp"
			],
			"env": {
				"DOCSPACE_BASE_URL": "https://your-instance.onlyoffice.com",
				"DOCSPACE_API_KEY": "your-api-key"
			}
		}
	}
}

Шаг 3. Установите значения переменных окружения

• DOCSPACE_BASE_URL — URL вашего экземпляра DocSpace (например, https://portal.onlyoffice.com).

• DOCSPACE_API_KEY — ваш персональный API-ключ, созданный в настройках DocSpace -> Инструменты разработчика -> API-ключи.

Все доступные параметры перечислены здесь.

Шаг 4. Перезапустите клиент

Закройте и снова откройте клиент. В большинстве случаев MCP-сервер DocSpace запустится автоматически, и вы сможете отдавать команды на естественном языке, например:

• Создай новую комнату проекта и пригласи Анну с правами редактора.

• Загрузи этот файл в «Мои документы».

Инструменты

MCP-сервер DocSpace реализует концепцию инструментов (Tools), описанную в спецификации MCP.

Все инструменты MCP-сервера DocSpace описаны здесь.

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

Документация доступна в директории docs.

Примеры

Следующие примеры показывают, как использовать MCP-сервер ONLYOFFICE DocSpace.

Политика конфиденциальности

Политики доступны в разделах Юридические условия и Политика конфиденциальности.

Лицензия

MCP-сервер DocSpace распространяется по лицензии MIT, которая находится в файле LICENSE.