Nextcloud·cbcoutinho
Nextcloud MCP — подключение и инструкция
Nextcloud MCP соединяет агента с файлами и поддерживаемыми приложениями Nextcloud для чтения и разрешённых операций.
Что умеет этот сервер
Nextcloud MCP соединяет агента с файлами и поддерживаемыми приложениями Nextcloud для чтения и разрешённых операций.
Community-сервер поддерживает local stdio и Docker HTTP.
Найди один тестовый файл по пути и прочитай его 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.
- 01
Подготовь окружение
Nextcloud instance, отдельный пользователь/app password и uv/uvx либо Docker.
- 02
Установи и настрой
Добавь uvx nextcloud-mcp-server run --transport stdio. Настрой NEXTCLOUD_HOST, NEXTCLOUD_USERNAME и NEXTCLOUD_PASSWORD как app password из Security → Devices & sessions. Для Docker подключай фактический /mcp endpoint.
- 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-серверов Нейролюба.