RU | EN

MCP-сервер Maticon Office DocSpace

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

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

Возможности

• Инструменты с детальным управлением — доступ к инструментам, объединённым в логические наборы, с возможностью точечного включения и отключения, а также метаинструментами.
• Несколько транспортных протоколов — поддержка транспортов stdio, SSE и Streamable HTTP.
• Разные способы аутентификации — поддерживаются API-ключи, персональные токены доступа, Basic-аутентификация и OAuth 2.0 с динамической регистрацией клиентов. См. примеры.
• Настройка на уровне запроса — аутентификацию и выбор инструментов можно настроить при инициализации сеанса с помощью пользовательских HTTP-заголовков.
• Различные форматы поставки — сервер доступен как Docker-образ, Docker MCP Server, MCP-пакет и приложение Node.js.

Сценарии использования

• Управление комнатами: создание, обновление и архивирование комнат; настройка типов комнат, состава участников и уровней доступа.
• Операции с папками и файлами: создание папок, загрузка документов, пакетное копирование и перемещение объектов, переименование и удаление содержимого, получение сведений о файлах и папках.
• Совместная работа и разрешения: приглашение и удаление пользователей, изменение параметров безопасности, просмотр текущих прав доступа к комнатам и общим пространствам.
• Доступ к содержимому: получение папок «Мои документы» и «Комнаты», просмотр содержимого папок, скачивание файлов в текстовом виде и отслеживание выполняющихся файловых операций.
• Каталог пользователей: получение списка всех пользователей портала для упрощения приглашений и управления доступом.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Шаг 3. Задайте значения переменных окружения

• DOCSPACE_BASE_URL — URL экземпляра DocSpace, например https://portal.maticonoffice.ru.
• DOCSPACE_API_KEY — персональный API-ключ, созданный в настройках DocSpace: «Инструменты разработчика» → «API-ключи».

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

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

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

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

Инструменты

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

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

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

Документация находится в каталоге docs.

Примеры

В примерах показано, как использовать MCP-сервер Maticon Office DocSpace.

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

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

Лицензия

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