Nextcloud·cbcoutinho

Nextcloud MCP — подключение и инструкция

Nextcloud MCP соединяет агента с файлами и поддерживаемыми приложениями Nextcloud для чтения и разрешённых операций.

Файлы и документыЛокальноAPI-ключ

Что умеет этот сервер

01

Nextcloud MCP соединяет агента с файлами и поддерживаемыми приложениями Nextcloud для чтения и разрешённых операций.

02

Community-сервер поддерживает local stdio и Docker HTTP.

03

Найди один тестовый файл по пути и прочитай его metadata/content.

Задача для знакомства

Через Nextcloud MCP прочитай тестовый файл и его metadata. Содержимое, ссылки доступа и другие приложения не меняй.

Уточнить результат

Сверь instance, пользователя и файл. Search index может обновляться не сразу и не подтверждает наличие всех данных пользователя.

Как подключить

Выберите подходящий способ

Подключить Nextcloud MCP

Добавь uvx nextcloud-mcp-server run --transport stdio. Настрой NEXTCLOUD_HOST, NEXTCLOUD_USERNAME и NEXTCLOUD_PASSWORD как app password из Security → Devices & sessions. Для Docker подключай фактический /mcp endpoint.

Что понадобится

  • Nextcloud instance, отдельный пользователь/app password и uv/uvx либо Docker.
  1. 01

    Подготовь окружение

    Nextcloud instance, отдельный пользователь/app password и uv/uvx либо Docker.

  2. 02

    Установи и настрой

    Добавь uvx nextcloud-mcp-server run --transport stdio. Настрой NEXTCLOUD_HOST, NEXTCLOUD_USERNAME и NEXTCLOUD_PASSWORD как app password из Security → Devices & sessions. Для Docker подключай фактический /mcp endpoint.

  3. 03

    Открой новую сессию

    Убедись, что клиент видит инструменты именно этого сервера, и выполни первый небольшой сценарий.

Пример MCP-конфигурации на основе README

{
  "mcpServers": {
    "nextcloud": {
      "command": "uvx",
      "args": [
        "nextcloud-mcp-server",
        "run",
        "--transport",
        "stdio"
      ],
      "env": {
        "NEXTCLOUD_HOST": "https://your.nextcloud.instance.com",
        "NEXTCLOUD_USERNAME": "your_username",
        "NEXTCLOUD_PASSWORD": "your_app_password"
      }
    }
  }
}

Первый запрос — пример для чата агента

Через Nextcloud MCP прочитай тестовый файл и его metadata. Содержимое, ссылки доступа и другие приложения не меняй.

Как проверить

Сверь instance, пользователя и файл. Search index может обновляться не сразу и не подтверждает наличие всех данных пользователя.

Подставь собственные пути, адреса и доступы только в локальные настройки. Команды запуска, MCP-конфигурация и текст первого запроса вводятся в разных местах; их назначение указано над примером.

README и установка автора

Что умеет Nextcloud

Nextcloud MCP соединяет агента с файлами и поддерживаемыми приложениями Nextcloud для чтения и разрешённых операций.

Community-сервер поддерживает local stdio и Docker HTTP. Полный feature set, включая semantic search, имеет дополнительные зависимости.

Что подготовить перед подключением

Nextcloud instance, отдельный пользователь/app password и uv/uvx либо Docker.

Как установить и подключить

Добавь uvx nextcloud-mcp-server run --transport stdio. Настрой NEXTCLOUD_HOST, NEXTCLOUD_USERNAME и NEXTCLOUD_PASSWORD как app password из Security → Devices & sessions. Для Docker подключай фактический /mcp endpoint.

Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.

Как пользоваться: первый сценарий

Найди один тестовый файл по пути и прочитай его metadata/content. Для изменения сначала сохрани исходную версию и проверь shared access.

Как проверить результат и решить проблемы

Сверь instance, пользователя и файл. Search index может обновляться не сразу и не подтверждает наличие всех данных пользователя.

Если инструмент не появился, проверь запуск процесса или доступность endpoint, журнал клиента и права доступа. Если соединение есть, но операция не выполняется, сверяй входные параметры и ограничения сервиса; повторять изменяющий запрос без проверки результата не стоит.

Ограничения

Пароль приложения наследует разрешения аккаунта. Общие файлы и календарь могут затрагивать коллег; semantic search не входит автоматически в лёгкий stdio setup.

Исходники и документация

Репозиторий: cbcoutinho/nextcloud-mcp-server. В README доступны актуальные варианты установки, требования и примеры настройки. Перед обновлением сохрани рабочую конфигурацию и проверь изменения версии.

Другие подключения — в каталоге MCP-серверов Нейролюба.

Вопросы о Nextcloud

Nextcloud MCP соединяет агента с файлами и поддерживаемыми приложениями Nextcloud для чтения и разрешённых операций.
Вернуться в библиотеку