# AIquila — Nextcloud MCP Server

MCP-сервер, который открывает ИИ-клиенту доступ к вашему Nextcloud: файлы, календарь, почта, заметки, карты и ещё десятки приложений.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 39
- Автор: elgorro
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/elgorro/aiquila/tree/HEAD/mcp-server
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/mcp/aiquila-nextcloud-mcp-server

## Что делает

Сервер подключается к вашему инстансу Nextcloud по адресу и логину с паролем приложения, а дальше отдаёт клиенту 342 инструмента в 44 категориях. Базовый набор — файлы, общие ресурсы, приложения, теги, пользователи, группы, уведомления, корзина, поиск, версии, активность — доступен всегда. Остальное подтягивается по мере того, какие приложения установлены у вас в Nextcloud: Maps, Social, Forms, Polls, News, Bookmarks, Deck, Photos, Mail, Talk, Circles, Calendar, Tasks, Contacts, Cookbook, Notes, Text и другие.

Своего ИИ у сервера нет. Он ничего не генерирует сам, а просто выставляет Nextcloud тому MCP-клиенту, который к нему подключится, — модель приносит клиент. Выбор провайдера относится к отдельному компоненту, приложению AIquila для Nextcloud, и к этому серверу отношения не имеет.

Понадобится Node.js 26+ и пароль приложения из Nextcloud (Settings → Security → Devices & sessions). Обязательных переменных три: `NEXTCLOUD_URL`, `NEXTCLOUD_USER`, `NEXTCLOUD_PASSWORD`. Транспорт по умолчанию — `stdio`, для удалённых клиентов есть `http` с OAuth. Если открываете сервер наружу, задайте `MCP_AUTH_ENABLED=true` и секрет из `openssl rand -hex 32` — без этого удалённый доступ останется без авторизации.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://{hostname}/mcp`
- Переменные окружения: `NEXTCLOUD_URL`, `NEXTCLOUD_USER`, `NEXTCLOUD_PASSWORD` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы**
```bash
claude mcp add --env NEXTCLOUD_URL=<NEXTCLOUD_URL> --env NEXTCLOUD_USER=<NEXTCLOUD_USER> --env NEXTCLOUD_PASSWORD=<NEXTCLOUD_PASSWORD> --transport stdio mcp-server -- npx -y aiquila-mcp
```
Вместо <…> подставьте свои значения

2. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http aiquila-mcp https://{hostname}/mcp
```

### Codex

1. **Командой платформы**
```bash
codex mcp add mcp-server --env NEXTCLOUD_URL=<NEXTCLOUD_URL> --env NEXTCLOUD_USER=<NEXTCLOUD_USER> --env NEXTCLOUD_PASSWORD=<NEXTCLOUD_PASSWORD> -- npx -y aiquila-mcp
```
Вместо <…> подставьте свои значения

2. **Командой платформы: удалённый сервер**
```bash
codex mcp add mcp-server --url https://{hostname}/mcp
```

### Cursor

1. **Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "aiquila-mcp"
            ],
            "env": {
                "NEXTCLOUD_URL": "<NEXTCLOUD_URL>",
                "NEXTCLOUD_USER": "<NEXTCLOUD_USER>",
                "NEXTCLOUD_PASSWORD": "<NEXTCLOUD_PASSWORD>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

2. **Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server": {
            "url": "https://{hostname}/mcp"
        }
    }
}
```

### GitHub Copilot

1. **Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "aiquila-mcp"
            ],
            "env": {
                "NEXTCLOUD_URL": "<NEXTCLOUD_URL>",
                "NEXTCLOUD_USER": "<NEXTCLOUD_USER>",
                "NEXTCLOUD_PASSWORD": "<NEXTCLOUD_PASSWORD>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

2. **Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server": {
            "type": "http",
            "url": "https://{hostname}/mcp"
        }
    }
}
```

### Gemini CLI

1. **Командой платформы**
```bash
gemini mcp add -e NEXTCLOUD_URL=<NEXTCLOUD_URL> -e NEXTCLOUD_USER=<NEXTCLOUD_USER> -e NEXTCLOUD_PASSWORD=<NEXTCLOUD_PASSWORD> mcp-server npx -y aiquila-mcp
```
Вместо <…> подставьте свои значения

2. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http mcp-server https://{hostname}/mcp
```

## Когда брать
- разобрать файлы в Nextcloud из чата с агентом
- создать задачу в Tasks, не открывая веб-интерфейс
- найти письмо или контакт через MCP-клиент
- опубликовать заметку или опрос из редактора
- посмотреть занятость в календаре перед планированием

## Примеры запросов агенту
- Покажи список файлов в корне моего Nextcloud
- Создай задачу в Tasks на завтра с напоминанием
- Найди контакт по фамилии в адресной книге

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47392
- [mcp-server](https://affpapa.org/nevibecode/mcp/mcp-server.md) — MCP-сервер · ★ 43872

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md