Rubrik Security Cloud

Rubrik MCP

AI アシスタントを Rubrik Security Cloud の GraphQL API に接続する MCP サーバーです。Rubrik 管理者や Rubrik を対象とした自動化に取り組むチーム向けに構築されており、AI アシスタントが呼び出すのと並行して、ローカル（自分のワークステーションまたはエージェントのサーバー上）で実行されます。

---

できること

検索

この MCP には、RSC GraphQL API 全体の事前構築済みインデックスが付属しています。検索ツールを使って AI エージェントはそのインデックスを調べ、操作の検索、引数の完全なシグネチャの確認、入力型と戻り値型の追跡を行い、あらゆるリクエストに最適な操作とフィールドの形式を見つけられます。これにより、最初から正確で適切な形式の GraphQL を生成できます。

検索ツールには RSC の認証情報が不要で、完全にオフラインで動作します。そのため、ツール単体でも役立ちます。API の評価、統合のプロトタイプ作成、本番環境の認証情報を取得する前の自動化の構築など、すぐに始めることができます。

> "What operations are available for SLA management?"
> "Show me the full argument shape for the assignSla mutation."
> "Generate Python code to assign an SLA domain to a list of workload IDs."

エージェントはスキーマインデックスからクエリとミューテーションの両方を理解できるため、RSC に接続することなく、あらゆる書き込み操作を実行可能な Python コードとして生成できます。

実行

RSC のサービスアカウントがあれば、エージェントは環境に対してライブの GraphQL クエリを実行できます。

• 保護ステータス、コンプライアンス状態、バックアップ履歴とともにワークロードを一覧表示する
• 最近のイベントと障害を取得する
• オンデマンドスナップショットを開始し、完了するまで状態を確認する
• ホストを登録し、SLA ドメインを割り当てる

GraphQL の直接実行は読み取り専用です。組み込みツールで対応していない書き込み操作を依頼すると、サーバーは実行しようとしたミューテーションを返し、エージェントが実行可能なコード例を生成します。書き込み操作のうち、一部は専用の組み込みツールとして利用できます。オンデマンドスナップショット（rsc_take_on_demand_snapshot）、ホストのオンボーディング（rsc_onboard_host）、SLA の割り当て（rsc_assign_sla）です。これらはデフォルトで無効です。利用可能にするには、ゲーティングポリシーで "writes_enabled": true を設定してください。それ以外の操作では、コードを生成する方法により、完全な制御が可能な実行スクリプトを取得できます。

警告

書き込みツールは Rubrik 環境に作用し、MCP を操作する LLM が呼び出すタイミングを決定します。 どのモデルも指示を誤って解釈したり、読み取った信頼できないデータの影響を受けたり（プロンプトインジェクション）、意図しない書き込みツールを呼び出したりする可能性があります。たとえば、rsc_assign_sla による SLA の変更によって、データが保護されなくなる場合があります。書き込みツールが追加されるほど、このリスク領域は広がります。このため、デフォルトでは無効になっており、有効化は明示的な選択です。確実な境界となるのは、最小権限の読み取り専用サービスアカウントです。このアカウントは、使用するモデルやエージェントの挙動にかかわらず、あらゆる書き込み操作を実行できません。サービスアカウントのロールに関する推奨事項を参照し、破壊的な操作では Quorum Authorization を有効にしてください。

組み込みツール

探索 — 認証情報は不要です

ツール	機能
rsc_search_schema	キーワード、フィールドの意味、型の語彙から、適切なクエリまたはミューテーションを1回の呼び出しで検索します
rsc_describe_operation_full	すべての入力型／列挙型をインラインで展開した引数シグネチャ
rsc_describe_type	GraphQL 型のフィールドと値

実行 — サービスアカウントが必要です

ツール	機能
rsc_execute_operation	任意の生の GraphQL クエリを実行します（ミューテーションの場合はコードを生成します）
rsc_get_workloads	保護ステータス、コンプライアンス、バックアップ履歴を含むワークロード
rsc_get_events	常に期間を指定した、最近のイベントとアクティビティ
rsc_get_clusters	RSC に登録された Rubrik クラスターと、そのステータス、バージョン、容量、稼働可能期間
rsc_get_sla_domains	基本頻度、保持ロック、アーカイブ、レプリケーションの設定を含む SLA ドメイン
rsc_search_help	キーワードでナレッジベースの記事、製品ドキュメント、既知の問題を検索します
rsc_take_on_demand_snapshot	ワークロードのバックアップを開始し、ジョブ ID を返します
rsc_wait_for_job	ジョブが完了するまでポーリングします
rsc_onboard_host	物理ホストまたは仮想ホストを登録します
rsc_assign_sla	ワークロードに SLA を割り当てる、割り当てを解除する、または保護対象外に設定します

ワークフロー管理 — サービスアカウントが必要です

ツール	機能
rsc_save_workflow	会話フローを名前付きの再利用可能なツールとして保存します
rsc_list_workflows	保存済みのワークフローをすべて一覧表示します
rsc_delete_workflow	保存済みのワークフローを削除します

ツールの作成

エージェントが質問に答えるための探索を終えたら、その一連のフローを名前付きの MCP ツールとして保存できます。

「このフローをワークフローとして保存して、再利用できるようにしてください。」

次回の再起動時には、そのツールが組み込みツールと並んで表示されます。複数段階のスキーマ探索ではなく、1回の呼び出しで済みます。操作を繰り返す場合、使用するトークンが少なくなり、応答も速くなります。ワークフローファイルは通常の JSON なので、編集、バージョン管理、チームとの共有が可能です。

---

インストール

前提条件

• uv（推奨）、または Python 3.10 以降と pip
• Rubrik Security Cloud アカウントとサービスアカウント（実行ツールのみ）

エージェントプロンプトを使ったインストール

Claude Code を使用している場合は、以下をチャットに貼り付けると、エージェントが残りの作業を行います。

「Rubrik MCP サーバー（PyPI パッケージ rubrik-mcp、uvx rubrik-mcp で実行）を、Claude Code の MCP 設定に追加してください。RSC サービスアカウントの JSON は ~/.rsc/service_account.json にあります。」

Claude Desktop の場合：

「Rubrik MCP サーバー（PyPI パッケージ rubrik-mcp、uvx rubrik-mcp で実行）を、Claude Desktop の設定に追加してください。RSC サービスアカウントの JSON は ~/.rsc/service_account.json にあります。」

手動でインストール

uvx を使用する場合（推奨）： 別途インストールする必要はありません。uvx rubrik-mcp は、PyPI からパッケージをキャッシュされた隔離環境にダウンロードして実行します。以下のクライアント設定で、コマンドとして直接使用してください。特定のリリースに固定するには、rubrik-mcp@<version> を使用します。たとえば、uvx [email protected] のように指定します。

pip を使用する場合：

pip install rubrik-mcp

インストールされたコマンドのフルパスを控えてください。以下のクライアント設定では、uvx rubrik-mcp の代わりにこのパスを使用します。

which rubrik-mcp
# example: /Users/you/.venv/bin/rubrik-mcp

強化されたインストール（任意）

インストール時のハッシュ検証（各パッケージをインストール前に既知の正常な暗号学的ハッシュと照合すること）が必要な環境向けに、リリースごとのハッシュ付き requirements.txt がこのリポジトリで公開されています。まず検証済みの依存関係セットをインストールし、その後でパッケージ自体をインストールします。

pip install --require-hashes -r requirements.txt
pip install --no-deps rubrik-mcp

requirements.txt は、ロックされハッシュが固定された依存関係セット（uv export）から生成されます。--require-hashes を指定すると、ハッシュが一致しないパッケージを pip が拒否し、2 番目の手順で --no-deps を指定すると、検証済みのセットが変更されないようにできます。その後、上記の pip の手順と同様に、rubrik-mcp のフルパスをクライアントに設定します。この手順は任意です。ほとんどのユーザーには標準のインストールで十分です。

MCP クライアントの設定

Claude Code:

claude mcp add rubrik -e RSC_SERVICE_ACCOUNT_FILE=/path/to/service_account.json -- uvx rubrik-mcp

-e などのオプションは -- の前に指定します。-- の後ろはすべて、サーバーを起動するコマンドです。検出のみを行う場合は、-e オプションを省略してください。

登録されたことを確認します。

claude mcp list

Claude Desktop： ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します。

{
  "mcpServers": {
    "rubrik": {
      "command": "uvx",
      "args": ["rubrik-mcp"],
      "env": {
        "RSC_SERVICE_ACCOUNT_FILE": "/path/to/service_account.json"
      }
    }
  }
}

デスクトップアプリは、シェルの PATH を常に引き継ぐとは限りません。Claude Desktop で uvx が見つからないと表示された場合は、"uvx" を which uvx で確認したフルパス（例：/Users/you/.local/bin/uvx）に置き換えてください。

その他の MCP クライアント（汎用 stdio）：

{
  "name": "rubrik",
  "transport": "stdio",
  "command": "uvx",
  "args": ["rubrik-mcp"],
  "env": {
    "RSC_SERVICE_ACCOUNT_FILE": "/path/to/service_account.json"
  }
}

pip でインストールした場合は、"command" に rubrik-mcp のフルパスを設定し、"args" を削除してください。

---

サービスアカウントの設定

RSC で Settings > Users and Roles > Service Accounts に移動し、サービスアカウントを作成します。プロンプトが表示されたら、JSON 認証情報ファイルをダウンロードしてください。RSC ではシークレットが再表示されません。

認証情報ファイルは次のような形式です。

{
  "client_id": "client|...",
  "client_secret": "...",
  "access_token_uri": "https://<your-rsc-domain>/api/client_token"
}

次のいずれかの方法で MCP サーバーに渡します（次の順に確認されます）。

オプション A — サービスアカウントの JSON ファイル（推奨）

export RSC_SERVICE_ACCOUNT_FILE=/path/to/service_account.json

オプション B — 個別の環境変数

export RSC_URL=https://<your-rsc-domain>
export RSC_CLIENT_ID=client|...
export RSC_CLIENT_SECRET=...

オプション C — ~/.rsc/config.json の設定ファイル

{
  "client_id": "client|...",
  "client_secret": "...",
  "access_token_uri": "https://<your-rsc-domain>/api/client_token"
}

---

サービスアカウントのロールに関する推奨事項

サービスアカウントに割り当てるロールによって、MCP サーバーがアクセスできる範囲が決まります。ワークフローで実際に必要な権限のみを割り当ててください。

監視、レポート作成、監査の場合 — 読み取り専用ロールを割り当てます。これにより、ワークロードの一覧表示、コンプライアンスステータス、イベント履歴、バックアップレポートを利用できます。読み取り専用ロールでは、SLA の割り当て変更、スナップショットのトリガー、設定の変更はできません。ほとんどのユーザーにとって、これが適切な出発点です。

DevOps の自動化の場合 — 自動化に必要な特定の権限を持つロールを割り当てます。よく追加される権限には、SLA 管理権限（SLA ドメインの割り当てや変更）とオンデマンドバックアップ権限（スナップショットのトリガー）があります。ワークフローで明示的に必要とされない限り、クラスタ管理者やグローバル管理者の権限は付与しないでください。

一般的なガイダンス：

• 既存の管理者ロールを再利用するのではなく、MCP サービスアカウント専用のロールを作成します。「MCP Read-Only」や「MCP DevOps」など、わかりやすい名前を付けてください。
• Settings > Users and Roles > Roles でロールを設定します。Rubrik の権限モデルは階層構造になっています。グローバルアクセスを付与するのではなく、可能な場合は特定のクラスタやワークロードタイプにロールの範囲を限定してください。
• 破壊的な操作（スナップショットの削除、SLA ポリシーの削除、クラスタ設定）の場合は、Settings > Security > Quorum Authorization で Quorum Authorization を有効にします。これにより、サービスアカウントに必要な権限があっても、操作の実行前に別の認証済みユーザーによる承認が必要になります。
• Settings > Security > IP Allowlist の RSC IP 許可リストを使用して、認証可能な IP を制限します。MCP サーバーを実行しているマシンの IP または CIDR 範囲のみを追加してください。
• クライアントシークレットを定期的に（最低でも毎月）ローテーションします。シークレットはデフォルトでは期限切れになりません。client_secret を含むファイルには chmod 600 を使用してください。
• すべての API アクティビティは、RSC の監査ログ Reports > Audit Logs に記録されます。定期的に確認してください。

---

独自のツールを保存する

同じ質問を何度もしていることに気づいたら、保存しましょう。

「これをワークフローとして保存して、再利用できるようにしてください。」

AI は rsc_save_workflow を呼び出し、MCP 設定ディレクトリの workflows/ フォルダーに JSON ファイルを書き込みます。既定の保存先は ~/.config/rubrik-mcp/workflows/ です。$RUBRIK_MCP_CONFIG_DIR が設定されている場合は、その配下に保存されます（コンテナー化した場合については docs/docker.md を参照してください）。次回の再起動時に、そのワークフローは名前付きの MCP ツールとして登録されるため、複数の手順を踏んでスキーマを調べる代わりに、1 回の呼び出しで済みます。繰り返し行う操作では、使用するトークンが減り、応答も速くなります。

ワークフローファイルは通常の JSON ファイルです。任意のエディターで開いてクエリを調整したり、既定値を変更したり、チームと共有したりできます。

脅威フィードの管理や SLA 運用など、コミュニティから提供されたワークフローは rubrik-community リポジトリで入手できます。任意の JSON ファイルを設定ディレクトリの workflows/ フォルダー（既定では ~/.config/rubrik-mcp/workflows/、または $RUBRIK_MCP_CONFIG_DIR の配下）にコピーし、MCP クライアントを再起動してインストールしてください。

---

さらに詳しく

組み込みツールの全リファレンス、アーキテクチャ図、ローカルのゲーティングポリシー（~/.config/rubrik-mcp/mcp-policy.json。$RUBRIK_MCP_CONFIG_DIR を使って移動可能）、監査ログ（mcp-audit.log。同じ設定ディレクトリ内に保存）、以前 ~/.rubrik に保存していた設定のアップグレードに関する注意事項、開発環境のセットアップについては、docs/advanced.md を参照してください。サーバーをコンテナー内で実行する方法については、docs/docker.md を参照してください。