※ 本記事は、Allen Bestによる”Get started with the OCI Recovery Service MCP Server“を翻訳したものです。
2026年11月8日
Recovery Serviceの情報をAIクライアントで利用する
データベースチームが、保護の健全性、REDO転送、バックアップの使用状況、復旧への準備状況をすぐに把握したいとき、最初に必要になるのは、複数のコンパートメントやツールから適切なOCIの情報を見つけることです。OCI Recovery Service MCP Serverは、読取りを中心とするRecovery ServiceとDatabase Serviceの操作を、MCP対応のAIクライアントから利用できるようにします。
このガイドでは、接続方法と、試せる4つのプロンプトを紹介します。ダッシュボードの作成、保護態勢レポートの作成、手順案内によるデータベースの登録、復旧状況の確認です。サーバーは、読取り中心のOCIデータ取得と、破壊的な変更を行わないダッシュボード作成や登録の案内を提供します。OCIリソースの作成、更新、削除は行いません。
サーバーを接続する
利用したいAIアプリの設定から、Recovery MCPサーバーを追加します。アプリを開き、MCPサーバー、ツール、または連携の設定に移動し、サーバーを追加する選択肢を選んでください。設定名と画面はアプリによって異なります。以下は、MCPサーバーの設定をJSON形式で受け付けるアプリの例です。
サーバーはuvxを通じてローカルで動作します。uvxは、PyPIから公開パッケージをダウンロードし、分離されたキャッシュ環境で起動するため、リポジトリをクローンする必要はありません。まず、AIアプリと同じコンピューターにPython 3.13以降とuvをインストールしてください。uvxコマンドはuvに含まれます。
追加する前に、そのコンピューターで使うOCIプロファイルを用意してください。サーバーは~/.oci/configを読み、別のものを選ばなければDEFAULTプロファイルを使います。APIキー認証では、そのプロファイルにOCIユーザー、テナンシ、フィンガープリント、鍵ファイル、リージョンを設定する必要があります。セッショントークン認証では、まずOCI CLIでサインインします。
oci session authenticate --profile-name DEFAULT
追加画面に個別の入力欄がある場合は、コマンドにuvx、引数にoracle.oci-recovery-mcp-server、トランスポートにstdioを指定します。環境変数OCI_CONFIG_PROFILEを、値DEFAULTで追加します。JSON設定ファイルを使うアプリでは、次の項目を追加します。すでにmcpServersオブジェクトがある場合は、その中にoci-recovery項目だけを入れてください。
{
"mcpServers": {
"oci-recovery": {
"type": "stdio",
"command": "uvx",
"args": ["oracle.oci-recovery-mcp-server"],
"env": {
"OCI_CONFIG_PROFILE": "DEFAULT"
}
}
}
}
DEFAULT以外のプロファイルを使う場合は、envブロックのOCI_CONFIG_PROFILEにその名前を設定します。選択したプロファイルにsecurity_token_fileがあれば、サーバーはセッショントークン認証を自動選択し、それ以外ではAPIキー認証を使います。MCPクライアントがuvxを見つけられない場合、コマンド欄の「uvx」をフルパスに置き換えます。macOSやLinuxでは、ターミナルでwhich uvxを実行してパスを確認できます。
設定を保存し、アプリから求められたら再起動または再読込みします。MCPや連携の設定で、oci-recoveryが接続され、ツールが有効になっていることを確認してください。使うには、そのアプリでRecovery MCPのツールを利用できるチャットを開き、以下のプロンプトのいずれかを入力します。角括弧内を、ご自身のコンパートメント、リージョン、データベース名、OCIDに置き換えてください。このプロジェクトは、OCI IAMで認証するホスト型のStreamable HTTP配置にも対応していますが、上のローカル設定が最も簡単な開始方法です。
試してみる4つのプロンプト
1. Recovery Serviceのダッシュボードを作成する
[リージョン]のコンパートメント[コンパートメント名またはOCID] について、Recovery Serviceのダッシュボードを作成してください。Recovery MCPのダッシュボード用ガイダンスと、最新のOCIデータを使ってください。保護対象データベースの健全性、REDO転送状況、バックアップ使用容量、バックアップ先を、分かりやすく区分して示してください。取得できる場合は主要な件数と該当するデータベース名を示し、注意が必要な項目に印を付け、最後に最も有用な次の確認事項を挙げてください。ダッシュボードはこのチャットに表示し、OCIリソースは変更しないでください。
サーバーは、保護対象データベースの健全性、REDOの状態、バックアップ使用容量、バックアップ先について、ダッシュボード用のガイダンスと集計ツールを提供します。このプロンプトは、その結果をAIクライアントが会話内のダッシュボードにまとめるよう求めています。
2. Recovery Serviceの保護態勢レポートを作成する
[リージョン]のコンパートメント[コンパートメント名またはOCID] について、Recovery Serviceの保護態勢レポートを作成してください。保護対象データベース、保護の健全性、REDO転送、バックアップ容量、バックアップ先、適用される保護ポリシーを要約してください。検出事項を状態別に分類し、保護に抜けやリスクがあるデータベースを特定して、各検出事項の証拠を含めてください。取得できなかったデータも記載してください。読取り専用ツールを使い、OCIリソースは変更しないでください。
このレポートで、コンパートメント全体の保護範囲を確認し、対応が必要なデータベースを特定できます。MCPサーバーは、基となる健全性、REDO、バックアップ、保存先、ポリシーの詳細を集められます。
3. データベースをRecovery Serviceに登録する
リージョン[リージョン]、コンパートメント[コンパートメント名またはOCID]のデータベース[データベース名またはOCID]を、OCI Recovery Serviceに登録する手順を案内してください。データベース、利用可能な保護ポリシー、Recovery Serviceサブネットを確認してください。前提条件、推奨するポリシーとサブネットの選択肢および理由、OCI管理者が実施する操作の順序付きチェックリストを示してください。確認できない点も明らかにしてください。変更は行わず、私が確認して実施するための案内を提供してください。
サーバーには、破壊的な変更を行わない登録案内ツールと、データベース、保護ポリシー、Recovery Serviceサブネットの読取りアクセスが含まれます。登録手順を用意し、OCI管理者が確認して実行できます。
4. データベースの復旧状況を確認する
[リージョン]、[コンパートメント名またはOCID]のデータベース[データベース名またはOCID] について、復旧状況を確認してください。保護対象データベースのレコードを探し、保護ポリシーと健全性、最新の利用可能なバックアップ情報、REDO転送状況、関連する復元作業リクエストを報告してください。確認できなかった点を説明し、次に行う読取り専用の確認を一覧にしてください。復旧操作は開始しないでください。
このプロンプトは、保護態勢の確認を1つのデータベースに絞り、サーバーの保護、バックアップ、REDO、復元状況の各ツールから証拠を求めます。
各プロンプトをより有効に使う
分かっている場合は、コンパートメント名とリージョンを指定してください。データベースまたは保護対象データベースのOCIDがあれば、それも含めます。一部の一覧取得ツールはコンパートメント表示名を解決できますが、リソース取得ツールにはOCIDが必要です。コンパートメントの階層を扱う場合は、適切で、OCI権限が許すなら、子コンパートメントも含めるよう依頼してください。
結果に基づいて操作する前に、返されたリソース名、識別子、タイムスタンプ、ステータス値を確認してください。MCPサーバーは、OCIデータと案内をクライアントに提供します。変更や復旧操作には、通常の運用上の承認手順を使ってください。
