rclone — MCP-сервер для Claude Code: управление облаком через RC API
Даёт ИИ-ассистенту доступ к демону rclone RC: смотреть ремоуты, копировать и синхронизировать файлы, листать каталоги. Пригодится, когда хранилище нужно подцепить к агенту без ручных команд.
claude mcp add --env RCLONE_URL=<RCLONE_URL> --env RCLONE_USER=<RCLONE_USER> --env RCLONE_PASS=<RCLONE_PASS> --env RCLONE_TOOLSETS=<RCLONE_TOOLSETS> --env RCLONE_READ_ONLY=<RCLONE_READ_ONLY> --transport stdio rclone -- npx -y rclone-mcpЧто делает rclone
Сервер работает поверх rclone RC API. Инструменты сгенерированы из спецификации rclone-openapi через клиент rclone-sdk: всего 98 эндпоинтов, разбитых на наборы по префиксу пути (core, config, operations, sync, jobs, mount, serve и другие). Каждый набор включается отдельно, чтобы список инструментов у агента не разрастался. Без запущенного демона ничего не заработает: сначала rclone rcd --rc-no-auth или тот же запуск с --rc-user и --rc-pass.
Адрес демона задаётся в RCLONE_URL, по умолчанию там http://localhost:5572. Логин и пароль — RCLONE_USER и RCLONE_PASS. Наборы перечисляются через RCLONE_TOOLSETS, есть особые значения default (четыре набора: core, config, operations, sync) и all. Флаг --read-only или RCLONE_READ_ONLY=1 оставляет только инструменты без изменения данных. Копирование, перенос, удаление, sync и mount при этом отключаются — в этом режиме безопасно пускать агента к рабочему хранилищу.
Транспорт stdio годится для Cursor, Claude и Claude Desktop, для удалённого хостинга есть Streamable HTTP с командой rclone-mcp http --port 3000. Если запускаете демон без авторизации, ограничьте доступ к порту 5572: кто дотянется до RC API, тот распоряжается вашими ремоутами.
Какие задачи решает
- посмотреть список настроенных ремоутов и их параметры
- скопировать каталог между двумя облачными хранилищами
- синхронизировать локальную папку с удалённой без ручных вызовов
- найти файлы в бакете и показать дерево каталогов
- дать агенту доступ к хранилищу без права что-либо удалить
Примеры запросов агенту
- Покажи все ремоуты в rclone и скажи, какие из них сейчас смонтированы
- Скопируй папку
photosиз ремоутаgdriveвs3-backup - Синхронизируй
~/projects/siteс ремоутомyadiskи покажи отчёт по изменениям
Как установить rclone
Командой платформы
claude mcp add --env RCLONE_URL=<RCLONE_URL> --env RCLONE_USER=<RCLONE_USER> --env RCLONE_PASS=<RCLONE_PASS> --env RCLONE_TOOLSETS=<RCLONE_TOOLSETS> --env RCLONE_READ_ONLY=<RCLONE_READ_ONLY> --transport stdio rclone -- npx -y rclone-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add rclone --env RCLONE_URL=<RCLONE_URL> --env RCLONE_USER=<RCLONE_USER> --env RCLONE_PASS=<RCLONE_PASS> --env RCLONE_TOOLSETS=<RCLONE_TOOLSETS> --env RCLONE_READ_ONLY=<RCLONE_READ_ONLY> -- npx -y rclone-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"rclone": {
"command": "npx",
"args": [
"-y",
"rclone-mcp"
],
"env": {
"RCLONE_URL": "<RCLONE_URL>",
"RCLONE_USER": "<RCLONE_USER>",
"RCLONE_PASS": "<RCLONE_PASS>",
"RCLONE_TOOLSETS": "<RCLONE_TOOLSETS>",
"RCLONE_READ_ONLY": "<RCLONE_READ_ONLY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"rclone": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"rclone-mcp"
],
"env": {
"RCLONE_URL": "<RCLONE_URL>",
"RCLONE_USER": "<RCLONE_USER>",
"RCLONE_PASS": "<RCLONE_PASS>",
"RCLONE_TOOLSETS": "<RCLONE_TOOLSETS>",
"RCLONE_READ_ONLY": "<RCLONE_READ_ONLY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e RCLONE_URL=<RCLONE_URL> -e RCLONE_USER=<RCLONE_USER> -e RCLONE_PASS=<RCLONE_PASS> -e RCLONE_TOOLSETS=<RCLONE_TOOLSETS> -e RCLONE_READ_ONLY=<RCLONE_READ_ONLY> rclone npx -y rclone-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о rclone
Как установить rclone MCP-сервер в Claude Code?
Полная команда: `claude mcp add --env RCLONE_URL=<RCLONE_URL> --env RCLONE_USER=<RCLONE_USER> --env RCLONE_PASS=<RCLONE_PASS> --env RCLONE_TOOLSETS=<RCLONE_TOOLSETS> --env RCLONE_READ_ONLY=<RCLONE_READ_ONLY> --transport stdio rclone -- npx -y rclone-mcp. Перед этим поднимите демон rclone rcd`.
Что делает этот MCP-сервер?
Превращает RC API rclone в инструменты для ИИ-ассистента: работа с конфигом, файловые операции, sync и другие эндпоинты по выбранным наборам.
Чем режим --read-only отличается от обычного?
Регистрируются только инструменты, которые не меняют данные. Копирование, удаление, sync и монтирование из списка исчезают, так что агент ничего не испортит.
