[RU](README.md) | [EN](README.en.md)

# MCP-сервер Maticon Office DocSpace

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

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

## Возможности

- **Инструменты с детальным управлением** — доступ к [инструментам](/docs/features/tools.md), объединённым в логические наборы, с возможностью точечного включения и отключения, а также метаинструментами.
- **Несколько транспортных протоколов** — поддержка [транспортов](/docs/configuration/global-configuration.md#user-content-docspace_transport) stdio, SSE и Streamable HTTP.
- **Разные способы аутентификации** — поддерживаются API-ключи, персональные токены доступа, Basic-аутентификация и OAuth 2.0 с динамической регистрацией клиентов. См. [примеры](/docs/installation/remote-server.md#user-content-examples).
- **Настройка на уровне запроса** — аутентификацию и выбор инструментов можно настроить при инициализации сеанса с помощью [пользовательских HTTP-заголовков](/docs/configuration/request-configuration.md#user-content-header-options).
- **Различные форматы поставки** — сервер доступен как [Docker-образ](/docs/distribution/docker-hub.md#user-content-docker-image), [Docker MCP Server](/docs/distribution/docker-mcp.md#user-content-docker-mcp-server), [MCP-пакет](/docs/distribution/build-from-source.md#user-content-mcp-bundle) и [приложение Node.js](/docs/distribution/npm-registry.md#user-content-nodejs-application).

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

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

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

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

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

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

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

Все варианты подключения клиентов к удалённому MCP-серверу DocSpace описаны [здесь](/docs/installation/remote-server.md).

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

Если MCP-хост не поддерживает удалённые MCP-серверы, вместо него можно запустить [локальную версию](/docs/installation/local-server.md) MCP-сервера DocSpace.

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

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

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

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

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

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

```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-ключи».

Все доступные параметры перечислены [здесь](/docs/configuration/global-configuration.md).

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

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

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

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

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

Все инструменты MCP-сервера DocSpace описаны [здесь](docs/features/tools.md).

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

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

## Примеры

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

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

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

## Лицензия

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

<!-- Ссылки -->

[docs]: https://github.com/MaticonOffice/docspace-mcp/tree/main/docs
[LICENSE]: https://github.com/MaticonOffice/docspace-mcp/blob/main/LICENSE

[Model Context Protocol]: https://modelcontextprotocol.io/
[Maticon Office DocSpace]: https://www.maticonoffice.ru/docspace.aspx

[Юридические условия]: https://www.maticonoffice.ru/legalterms
[Политика конфиденциальности]: https://www.maticonoffice.ru/privacy

[спецификации MCP]: https://modelcontextprotocol.io/specification/2025-11-25/server/tools/

[примерах]: https://api.maticonoffice.ru/docspace/mcp-server/getting-started/