StorageRadar MCP | Локальный readonly-доступ ИИ к аналитике диска

Что такое интеграция MCP?

Когда вы включаете MCP в StorageRadar, приложение запускает лёгкий локальный сервер на 127.0.0.1. ИИ-ассистенты с поддержкой Model Context Protocol могут подключаться к нему и получать аналитику диска в реальном времени.

Сервер работает строго в режиме readonly. Он может ответить, что занимает больше всего места или что изменилось за неделю, но не может удалять или перемещать файлы, а также получать доступ к их содержимому.

Точка MCP доступна на всех тарифах. Подключение и запросы данных бесплатны. Для фактической очистки по рекомендациям ИИ нужен соответствующий платный тариф в StorageRadar.

Руководство по настройке

Подключение ИИ-ассистента к StorageRadar занимает меньше двух минут.

Откройте настройки StorageRadar

В боковой панели нажмите «Настройки» и прокрутите до строки «Локальный MCP-эндпоинт» в разделе «Локальное использование и конфиденциальность».

Включите MCP (только чтение)

Включите переключатель в этой строке и нажмите «Настроить» рядом с ним. В окне «Локальный MCP-эндпоинт» плитка «Сервер» покажет «Работает», а строка «Адрес» — локальный адрес с портом.

Проверьте токен доступа

StorageRadar создаёт токен автоматически и показывает его в строке «Токен доступа» в замаскированном виде. Храните токен в секрете. Кнопка «Обновить» в любой момент выпускает новый токен и отзывает предыдущий.

Скопируйте конфигурацию и вставьте в ИИ-клиент

Нажмите кнопку «Копирование фрагмента конфигурации клиента» внизу окна. Пока MCP выключен, кнопка неактивна. StorageRadar сгенерирует конфигурацию для вашего ИИ-клиента вместе с токеном. Вставьте её в настройки MCP-серверов клиента.

Сначала выполните сканирование

Убедитесь, что в StorageRadar есть хотя бы одно сканирование. Инструменты MCP работают с проиндексированными данными, поэтому без сканирований результатов не будет.

Примеры промптов

Скопируйте любой промпт ниже и вставьте в ИИ-ассистента после подключения StorageRadar. ИИ вызовет нужные инструменты MCP и объяснит результаты.

ИИ может только анализировать и рекомендовать. Для очистки откройте StorageRadar и используйте пошаговый процесс. Анализ через ИИ и очистка вручную разделены намеренно.

01 Быстрая проверка подключения

get_server_info

Проверьте подключение к StorageRadar MCP: покажите версию сервера, версию API, версию приложения и доступные функции.

serverVersion, apiVersion, appVersion, Features[]:подтверждает, что соединение работает.

02 Последние сессии сканирования

list_scan_sessions

Покажите мои последние 10 сессий сканирования, начиная с новых. Для каждой: дата, корневой том, общий размер в ГБ, количество элементов.

Список последних сканирований. Выберите sessionId для следующих запросов.

03 Разбивка последнего сканирования

list_scan_sessionsget_scan_session

Возьмите последнее сканирование и покажите детали: основные категории и гистограмму размеров. Объясните, куда ушло место.

Разбивка по категориям с понятным объяснением использования диска.

04 Топ-30 самых крупных объектов

largest_query

Для последнего сканирования покажите 30 самых крупных объектов, от большего к меньшему. Укажите размер в ГБ и уровень риска каждого.

Самые крупные объекты на диске с размерами и метками риска.

05 Топ-20 самых больших папок

largest_query

Для последнего сканирования покажите только 20 самых больших папок от 500 МБ, отсортированных по размеру.

Самые большие папки для ручной проверки в Finder.

06 Разбивка по расширениям файлов

largest_query

Для последнего сканирования покажите 15 основных типов файлов по размеру, сгруппированных по расширению. Какие типы занимают больше всего места?

Распределение расширений: видно, что занимает место — видео, архивы, артефакты сборки или другое.

07 Разбивка по пользователю и системе

largest_query

Для последнего сканирования покажите использование диска, сгруппированное по владельцу. Какая доля моя, а какая — системная? Объясните.

Пользовательские и системные данные с чётким разделением.

08 Список сохранённых снапшотов

list_snapshots

Покажите последние 20 снапшотов диска: ID, дату, метку и общий размер. Сначала новые.

Список снапшотов для сравнения.

09 Почему диск вырос за эту неделю?

list_snapshotsdiff_snapshots

Возьмите последний снапшот и снапшот недельной давности. Сравните по категориям и объясните, что выросло больше всего.

Изменения по категориям с понятным объяснением.

10 Что изменилось после обновления Xcode?

list_snapshotsdiff_snapshots

Найдите два снапшота, ближайших к 15 февраля 2026. Сравните по расширению и папке в отдельных запросах. Покажите наибольший рост для каждого.

Рост по папкам и расширениям — часто показывает DerivedData, симуляторы и кеши Xcode.

11 Только крупные изменения между двумя снапшотами

diff_snapshots

Сравните снапшоты [baseId] и [compareId]. Только изменения более 1 ГБ, лимит — 100. Группировка по категориям.

Только значимые изменения, без шума.

12 Кеши разработчика: где больше всего места?

get_dev_cleanup_summary

Покажите сводку очистки для последнего сканирования. Отсортируйте профили по размеру и выделите топ-5 с размером и уровнем риска.

Xcode, npm, Gradle, Docker и другие профили, отсортированные по размеру.

13 Кеши разработчика с приоритетом по риску

get_dev_cleanup_summary

Покажите сводку очистки разработчика и разделите профили на безопасные, осторожные и高风险. Порекомендуйте, что чистить первым, что проверить перед очисткой, а что лучше не трогать.

Приоритетный план с учётом рисков.

14 10-шаговый план очистки вручную

largest_queryget_dev_cleanup_summary

На основе последнего сканирования и сводки очистки разработчика создайте 10-шаговый план. Начните с самых безопасных и крупных кандидатов, закончите теми, что требуют осторожности.

Пронумерованный план действий для работы в StorageRadar.

15 Проверьте политику приватности путей

largest_query

Показать 10 элементов из largest_query для последнего сканирования. Для каждого пути обратите внимание, выглядит ли он обобщенно или подробно. Работает ли текущая политика конфиденциальности?

Проверка, что настройка «Приватность путей» работает корректно.

16 Тенденция роста диска по 5 снапшотам

list_snapshots

Возьмите последние 5 снапшотов и покажите тенденцию: размер диска по датам, общий прирост и среднюю скорость роста в МБ/день.

Мини-график, показывающий, как быстро заполняется диск.

17 Найдите аномальные всплески роста

list_snapshotsdiff_snapshots

Сравните последние 3 последовательные пары снапшотов. Найдите категории или папки с внезапным и необычно большим ростом по сравнению с другими периодами.

Кандидаты на скачкообразный рост с временными метками.

18 Резюме

get_scan_sessiondiff_snapshotsget_dev_cleanup_summary

Дайте краткую сводку по хранилищу Mac: текущий размер диска, 3 крупнейших потребителя по категориям, рост с последнего снапшота и 5 безопасных рекомендаций по очистке, отсортированных по размеру.

Сводка для принятия решений, без лишних деталей.

19 Полный отчёт в Markdown

get_scan_sessionlargest_querydiff_snapshotsget_dev_cleanup_summary

Создайте Markdown-отчёт для последнего сканирования. Включите основные категории, топ-10 папок, топ-10 расширений по размеру, сводку очистки и ключевые изменения между двумя последними снапшотами.

Готовый Markdown-документ для заметок или отслеживания.

20 Проверьте сквозное подключение MCP

get_server_infotools/list

Проверьте сквозное подключение StorageRadar MCP: инициализируйте сессию, перечислите доступные инструменты и вызовите get_server_info. Покажите, что отправлено и что вернул сервер.

Полная проверка: сервер работает, аутентификация пройдена, всё готово.

Доступные инструменты MCP

StorageRadar предоставляет семь readonly-инструментов через MCP. Ваш ИИ-клиент вызывает их автоматически в зависимости от вопроса. Все инструменты поддерживают курсорную пагинацию и возвращают стабильные детерминированные результаты.

get_server_info Диагностика

Возвращает версию сервера, версию API, версию приложения и список включённых функций. Полезно для проверки подключения.

Возвращает serverVersionapiVersionappVersionfeatures[]

list_scan_sessions Сканирование

Список всех сессий сканирования со статусом, корневым томом, областью и сводной статистикой. Поддерживает фильтрацию по дате и пагинацию.

Параметры cursor limit from to

Возвращает на сессию idcreatedAtrootVolumescopestatustotalBytestotalItemsdurationMs

get_scan_session Сканирование

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

Параметры id

Возвращает metadatacategories[]histogram

largest_query Анализ

Возвращает N самых крупных объектов из сканирования или снапшота с гибкой группировкой. Используйте для поиска самых больших файлов, папок, расширений или категорий.

Параметры sessionId snapshotId pathPrefix groupBy minBytes cursor limit

группировать по параметрам itemfolderextensionownercategory

Возвращает на запись keybytesitemsrisk

list_snapshots Снимки

Перечисляет все сохранённые снапшоты диска в хронологическом порядке. Снапшоты создаются вручную в разделе «Отчёты и доступы» → «Снимки» и фиксируют состояние диска на определённый момент.

Параметры cursor limit from to

Возвращает на снапшот idcreatedAtlabelrootScopetotalBytes

diff_snapshots Снимки

Сравнивает два снапшота и возвращает, что выросло, уменьшилось, появилось или исчезло. Фильтрация по минимальному размеру изменения, группировка по пути, расширению или категории.

Параметры baseId compareId groupBy minDeltaBytes cursor limit

Возвращает на запись keydeltaBytesdeltaItemsdirectionnotes

get_dev_cleanup_summary Очистка разработчика

Возвращает сводку по кешам разработчика и артефактам сборки. Включает уровни риска и подсказки. Readonly — без действий по очистке.

Параметры sessionId snapshotId cursor limit

Возвращает на профиль profileIdnamebytesitemsriskLevelhints[]

Пагинация

Лимит по умолчанию — 50, максимальный — 200. Все инструменты списка возвращают курсор для следующей страницы. Результаты всегда в стабильном, детерминированном порядке.

Безопасность

Только loopback-доступ

Сервер привязан исключительно к 127.0.0.1. Без доступа из локальной сети и интернета. Другие устройства не могут к нему подключиться.

Требуется токен

Каждый запрос должен содержать токен сессии. Без него сервер отклоняет запрос и логирует попытку. Токен можно пересоздать в любой момент для отзыва предыдущего.

Ограничение скорости

Запросы ограничены по скорости для каждого токена. Это предотвращает перегрузку локального сервера runaway ИИ-агентами.

Полный аудитный лог

Каждый вызов инструмента логируется локально в ~/Library/Application Support/StorageRadar/mcp-audit-log.json: временная метка, ID токена, имя инструмента, параметры, размер ответа, задержка и ошибки.

Чего не может делать MCP-точка

Удалять или перемещать файлы
Читать содержимое файлов
Обращаться к сети или интернету
Вызывать инструменты вне утверждённого списка
Выполнять или автоматически применять рекомендации

Конфиденциальность и минимизация данных

StorageRadar минимизирует данные в ответах MCP. По умолчанию возвращаются обобщённые пути без раскрытия имён проектов и личных каталогов.

По умолчанию (рекомендуется)

Обобщённые пути

Пути абстрагируются до уровня категорий. Например:

Было ~/Library/Developer/Xcode/DerivedData/MySecretApp-xyz123

Возвращает ~/Library/Developer/Xcode/DerivedData/*

ИИ получает полезные агрегированные данные без утечки конкретных названий проектов или идентификаторов.

Необязательно

Детальные пути (домашний каталог скрыт)

Чтобы получать более детальные пути, откройте «Настройки» → «Локальный MCP-эндпоинт» → «Настроить» и выберите «Raw paths (home redacted)» в строке «Приватность путей». Когда включено:

Возвращаются более конкретные пути для целевой диагностики.
Домашний каталог всегда заменяется на ~
Длинные сегменты и идентификаторы маскируются автоматически.

Содержимое файлов никогда не возвращается в любом режиме. Это жёсткое ограничение. MCP-сервер не может читать или передавать содержимое документов, изображений, кода или любых других файлов.

Конфигурация

StorageRadar автоматически генерирует конфигурацию для вашего ИИ-клиента. Откройте «Настройки» → «Локальный MCP-эндпоинт» → «Настроить» и нажмите кнопку «Копирование фрагмента конфигурации клиента». Ниже — пример для Claude Desktop.

MCP-сервер использует Streamable HTTP на порту 7342. Токен передаётся в заголовке Authorization. Прокси и stdio-мост не нужны.

Claude Desktop / любой клиент с JSON-конфигурацией

Добавьте запись StorageRadar в объект mcpServers в конфигурации клиента:

claude_desktop_config.json

{
  "mcpServers": {
    "storageradar": {
      "transport": "streamable_http",
      "url": "http://127.0.0.1:7342/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

Замените <YOUR_TOKEN> своим токеном доступа. В строке «Токен доступа» он показан в замаскированном виде. StorageRadar подставляет правильные значения, включая полный токен, при нажатии кнопки «Копирование фрагмента конфигурации клиента».

Claude Code (CLI)

Если вы используете Claude Code в терминале, зарегистрируйте сервер одной командой:

Claude Code (CLI)

claude mcp add --transport http storageradar http://127.0.0.1:7342/mcp \
  --header "Authorization: Bearer <YOUR_TOKEN>"

После подключения попросите ИИ проверить подключение к StorageRadar MCP. Он вызовет get_server_info и покажет версию сервера и доступные функции.

Пересоздание токена

Нажмите «Обновить» в строке «Токен доступа» окна «Локальный MCP-эндпоинт», чтобы аннулировать текущий токен. После этого снова скопируйте фрагмент конфигурации и обновите заголовок Authorization в конфигурации клиента. Запросы со старым токеном сразу получают 403 AUTH_INVALID.

MCP Интеграция

Что такое интеграция MCP?

Руководство по настройке

Откройте настройки StorageRadar

Включите MCP (только чтение)

Проверьте токен доступа

Скопируйте конфигурацию и вставьте в ИИ-клиент

Сначала выполните сканирование

Примеры промптов

Доступные инструменты MCP

Пагинация

Безопасность

Только loopback-доступ

Требуется токен

Ограничение скорости

Полный аудитный лог

Чего не может делать MCP-точка

Конфиденциальность и минимизация данных

Обобщённые пути

Детальные пути (домашний каталог скрыт)

Конфигурация

Claude Desktop / любой клиент с JSON-конфигурацией

Claude Code (CLI)

Пересоздание токена