MCP 統合とは何ですか?
StorageRadar で MCP を有効にすると、アプリは 127.0.0.1 で軽量のローカル サーバーを実行します。モデル コンテキスト プロトコルをサポートする AI アシスタントは、このサーバーに接続し、リアルタイムでディスク分析をクエリできます。
サーバーは厳密に読み取り専用です。最も多くのスペースを使用しているものや先週から何が変わったのかなどの質問には答えることができますが、ファイルを削除したり、何かを移動したり、ファイルの内容にアクセスしたりすることはできません。
MCP エンドポイントはすべての層で使用できます。これを有効にしてデータをクエリするのは無料です。 AI の推奨事項に基づいて実際のクリーンアップを実行するには、StorageRadar の適切なロック解除層が必要です。
セットアップガイド
AI を StorageRadar に接続するには 2 分もかかりません。
StorageRadar でのオープン統合
サイドバーで「統合」をクリックします。画面上部に MCP セクションが表示されます。
MCP を有効にする (読み取り専用)
MCP (読み取り専用) を有効にするをオンに切り替えます。ステータス インジケーターが「サーバー実行中」に変わり、StorageRadar にローカル エンドポイントのアドレスとポートが表示されます。
アクセストークンを生成する
「トークンの生成」をクリックします。このトークンを非公開にしておきます。いつでも回転させて、以前のものを取り消すことができます。
構成スニペットをコピーして AI クライアントに貼り付けます
「クライアント構成スニペットのコピー」をクリックします。 StorageRadar は、AI クライアント用の正しい構成形式を生成します。これをクライアントの MCP サーバー構成に貼り付けます。
最初にスキャンを実行する
StorageRadar で少なくとも 1 回のスキャンを実行していることを確認してください。 MCP ツールはインデックス付きスキャン データを処理するため、スキャン履歴が空であるということは結果も空であることを意味します。
プロンプトの例
以下のプロンプトをコピーし、StorageRadar に接続した後、AI アシスタントに貼り付けます。 AI は適切な MCP ツールを呼び出し、結果をわかりやすい言葉で説明します。
AI は説明と推奨しかできません。実際にクリーンアップするには、StorageRadar を開き、ガイド付きワークフローを使用します。 AI 分析と人間によるクリーンアップは設計により分離されています。
01 クイック接続チェック
02 最近のスキャン セッション
03 最新のスキャンの内訳
04 上位 30 位の最大項目
05 上位 20 位の最大フォルダ
06 ファイル拡張子別の内訳
07 ユーザーとシステムの内訳
08 保存されたスナップショットを一覧表示する
09 今週ディスクが増加したのはなぜですか?
10 Xcode を更新した後、何が変わりましたか?
11 2 つのスナップショット間の大きな変更のみ
12 開発キャッシュ: 最大のボリュームはどこですか?
13 リスクに応じて優先順位を付けた開発キャッシュ
14 10 ステップの手動クリーンアップ プラン
15 パスのプライバシー ポリシーを確認する
16 5 つのスナップショットにわたるディスクの増加傾向
17 異常な成長の急増を見つける
18 エグゼクティブサマリー
19 完全な Markdown レポート
20 MCP 接続をエンドツーエンドで確認します
利用可能な MCP ツール
StorageRadar は、MCP に対して 7 つの読み取り専用ツールを公開します。 AI クライアントは、質問に基づいてこれらを自動的に呼び出すことができます。すべてのツールはカーソルベースのページネーションをサポートし、安定した決定的な結果を返します。
get_server_info 診断 サーバーのバージョン、API バージョン、アプリのバージョン、および有効な機能のリストを返します。接続が機能していることを確認するのに役立ちます。
serverVersionapiVersionappVersionfeatures[] list_scan_sessions スキャン すべてのスキャン セッションとそのステータス、ルート ボリューム、スコープ、および概要統計を一覧表示します。日付範囲とページネーションによるフィルタリングをサポートします。
idcreatedAtrootVolumescopestatustotalBytestotalItemsdurationMs get_scan_session スキャン 最上位カテゴリごとのディスク使用量など、特定のスキャン セッションの詳細なメタデータと集計を返します。
metadatacategories[]histogram largest_query 分析 柔軟なグループ化を使用して、スキャンまたはスナップショットから上位 N 個の最大アイテムを返します。これを使用して、最大のファイル、フォルダー、拡張子、またはカテゴリを検索します。
itemfolderextensionownercategory keybytesitemsrisk list_snapshots スナップショット 保存されているすべてのディスク スナップショットを時系列順にリストします。スナップショットはレポートから手動で取得され、ディスクの特定時点の状態を表します。
idcreatedAtlabelrootScopetotalBytes diff_snapshots スナップショット 2 つのスナップショットを比較し、それらの間で拡大、縮小、出現、または消失したものを返します。最小変更サイズでフィルターし、パス、拡張子、またはカテゴリごとに結果をグループ化します。
keydeltaBytesdeltaItemsdirectionnotes get_dev_cleanup_summary 開発クリーンアップ 開発者キャッシュとビルド アーティファクトの集計された概要を返します。リスクレベルとヒントが含まれています。読み取り専用で、クリーンアップアクションはありません。
profileIdnamebytesitemsriskLevelhints[] ページネーションの制限
デフォルトの制限は 50 で、最大値は 200 です。すべてのリスト ツールは、次のページをフェッチするためのカーソルを返します。結果は常に安定した決定的な順序で返されます。
セキュリティ
ループバックのみ
サーバーは 127.0.0.1 に排他的にバインドします。 LAN への露出やインターネットへのアクセスはありません。ネットワーク上の他のデバイスはアクセスできません。
トークンが必要です
すべてのリクエストにはセッション トークンが含まれている必要があります。これがないと、サーバーはリクエストを拒否し、試行をログに記録します。いつでもトークンをローテーションして、以前のアクセスを取り消すことができます。
レート制限あり
リクエストはトークンごとにレート制限されています。これにより、暴走した AI エージェントがローカル サーバーに攻撃を加えるのを防ぎます。
完全な監査ログ
すべてのツール呼び出しは、タイムスタンプ、トークン ID、ツール名、パラメーター、応答サイズ、遅延、エラーとともに ~/Library/Application Support/StorageRadar/mcp-audit-log.json にローカルに記録されます。
MCP エンドポイントでできないこと
- ファイルを削除または移動する
- 任意のファイルの内容を読み取ります
- ネットワークまたはインターネットにアクセスする
- 承認済みリストにないツールを呼び出す
- 推奨事項を実行または自動適用する
プライバシーとデータの最小化
StorageRadar は、MCP 応答のデータ最小化ポリシーに従います。デフォルトでは、正確なプロジェクト名や個人ディレクトリ名を公開するのではなく、一般化されたパスを返します。
一般化されたパス
パスはカテゴリ レベルで抽象化されます。たとえば:
~/Library/Developer/Xcode/DerivedData/MySecretApp-xyz123 ~/Library/Developer/Xcode/DerivedData/* これは、AI が特定のプロジェクト名や識別子を漏らすことなく、有用な集計データを取得できることを意味します。
生のパス、編集されたホーム
より詳細なパスについては、「統合」→「パスプライバシーポリシー」で「生のパス (ホーム編集済み)」を有効にします。有効にした場合:
- 対象を絞った診断に対して、より具体的なパスが返されます。
- ホーム ディレクトリは常に ~ に置き換えられます
- 長いセグメントと ID のような文字列は自動的にマスクされます
どのモードでもファイルの内容は返されません。これは厳しい制約です。 MCP サーバーには、ドキュメント、画像、コード、その他のファイルの内容を読み取りまたは送信するメカニズムがありません。
構成スニペット
StorageRadar は、AI クライアントの正しい構成スニペットを自動的に生成します。 「統合」画面で「クライアント構成スニペットのコピー」をクリックします。以下は Claude Desktop の例です。
MCP サーバーは、ポート 7342 で Streamable HTTP トランスポートを使用します。トークンは Authorization ヘッダーに入れられます。プロキシや標準出力ブリッジは必要ありません。
Claude Desktop / 任意の JSON-config クライアント
storageradar エントリをクライアントの構成ファイルの mcpServers オブジェクトに追加します。
{
"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 を使用する場合は、次の 1 つのコマンドでサーバーを登録します。
claude mcp add --transport http storageradar http://127.0.0.1:7342/mcp \
--header "Authorization: Bearer <YOUR_TOKEN>" 接続後、AI に StorageRadar MCP 接続を確認するよう依頼して、機能することを確認します。 get_server_info を呼び出し、サーバーのバージョンと利用可能な機能を表示します。
トークンをローテーションする
StorageRadar の [Generate / Rotate Token] をクリックすると、現在のトークンを無効にできます。その後、クライアントの構成内の Authorization ヘッダーを更新します。古いトークンを使用したリクエストは、すぐに 403 AUTH_INVALID を返します。