Oracle Cloud Infrastructureドキュメント

OCI Database Servicesの管理対象MCPサーバー

マネージド・モデル・コンテキスト・プロトコル(MCP)サーバーを使用すると、MCP互換のAIエージェントおよびアプリケーションがOCIデータベース・リソースに関するサポートされている情報にアクセスできます。

OCI Database Servicesは、Base Database Service、Oracle Exadata Database Service on Cloud@Customer、Oracle Exadata Database Service on Dedicated Infrastructure、Oracle Exadata Database Service on Exascale Infrastructureの管理対象MCPサーバーをサポートしています。管理対象MCPサーバーは、OCI Databaseコントロール・プレーンAPIへの標準化されたMCPインタフェースを提供します。MCP互換のクライアントは、MCPツールとして利用可能な操作を検出し、これらのツールを使用してOCIデータベース・リソースに関する情報を取得できます。

管理対象MCPサーバーの動作

管理対象MCPサーバーは、MCP互換クライアントとサポートされているOCI Databaseコントロール・プレーンAPI間のインタフェースを提供します。

MCPサーバーを作成する場合、サーバーをアイデンティティ・ドメインに関連付けて、該当するデータベース・サービスおよびリソース・カテゴリを選択します。OCIは、サーバーのMCPエンドポイントおよびMCPクライアント構成を生成します。互換性のあるMCPクライアントを構成するには、この情報を使用します。

MCP互換のAIエージェントまたはクライアントを介して自然言語リクエストを送信すると、クライアントはMCP over Streamable HTTPを使用して管理対象MCPサーバーに接続します。管理対象MCPサーバーは、クライアントを認証し、OCI Identity and Access Management (IAM)ポリシーに基づいてアクセスを認可します。リクエストが認可されている場合、MCPサーバーは、サポートされている該当するOCIデータベース操作を呼び出して、リクエストされたデータベース・リソースに関する情報をクライアントに返します。

たとえば、MCP互換のAIエージェントに、コンパートメント内のデータベースに関する情報を取得するように依頼できます。エージェントは、適切なMCPツールを識別し、ツールを起動し、OCI Database Servicesによって返された情報を使用してリクエストに応答できます。

MCPサーバーを使用しても、OCIデータベース・リソースへのアクセスに必要な権限は変更されません。認証されたアイデンティティは、該当するIAMポリシーで許可されているリソースおよび操作にのみアクセスできます。

MCPサーバー

MCPサーバーは、MCP互換クライアントにリモート・エンドポイントを提供するOCIリソースです。

次のOCIデータベース・サービス用にMCPサーバーを作成できます。

  • ベース・データベース・サービス
  • Oracle Exadata Database Service on Cloud@Customer
  • Oracle Exadata Database Service on Dedicated Infrastructure
  • Oracle Exadata Database Service on Exascale Infrastructure

異なるデータベース・サービスに対して、1つのテナンシに複数のMCPサーバーを作成できます。

MCPサーバー構成には、関連付けられたアイデンティティ・ドメイン、データベース・サービス、リソース・カテゴリ、タグなどの情報が含まれます。

OCIは、MCPサーバーごとに一意のMCPエンドポイントを提供します。OCIには、互換性のあるMCPクライアントを構成するために使用できるMCP JSON構成も用意されています。

MCPサーバーを有効または無効にできます。MCPサーバーを無効にすると、クライアントは構成を削除せずにサーバーにアクセスできなくなります。MCPサーバーが不要になったら削除できます。

MCPツール

MCPツールは、MCP互換クライアントがMCPサーバーを介して検出および起動できるOCIデータベース操作をサポートしています。

MCPサーバーは、サポートされている読み取り専用コントロールプレーン操作をMCPツールとして使用できるようにします。AIエージェントは、リクエストに適した使用可能なツールを決定し、必要なパラメータを指定してそのツールを起動できます。

MCPサーバーで使用できるツールは、サーバー用に構成されたデータベースサービスとリソースカテゴリによって異なります。

サポートされているリソース・カテゴリには、次のものがあります。

  • データベース・インフラストラクチャ
  • 仮想マシン
  • データベースのバックアップ
  • Data Guard
  • 関連するデータベース操作メタデータ

MCPツールの可用性では、対応するOCIデータベース操作を使用する権限を付与しません。OCI IAMポリシーは、認証済アイデンティティがリクエストされたリソースにアクセスできるかどうかを判断します。

MCPエンドポイントおよびクライアント構成

各MCPサーバーには、互換性のあるクライアントがStreamable HTTPを使用してサーバーに接続するために使用するMCPエンドポイントがあります。

MCPサーバーの作成後、生成されたエンドポイントをMCPサーバーの詳細から取得できます。互換性のあるMCPクライアントの構成に必要なMCP JSON構成を取得することもできます。

クライアントが構成および認証されると、エンドポイントに接続して、サーバーを介して使用可能なMCPツールを検出できます。

MCPサーバー構成をクライアントに追加する方法は、使用するMCPクライアントによって異なります。

認証

MCPサーバーは、OCI Identityを介してOAuthベースの認証を使用します。MCPサーバーを作成する場合は、それをアイデンティティ・ドメインに関連付けます。

MCPサーバーにアクセスするために、MCPクライアントは、関連付けられたアイデンティティ・ドメインで認証し、OAuthアクセス・トークンを取得します。クライアントは、MCPサーバーへの接続時にアクセス・トークンを使用します。MCPサーバーは、クライアントがサポートされているMCPツールにアクセスできるようにする前に、トークンを検証します。

承認

OCI IAMは、MCPサーバーを介してアクセスされるOCIデータベース・リソースへのアクセスを制御します。

IAMポリシーは、ユーザー、グループ、テナンシ、コンパートメントおよびその他のサポートされているOCI IAM構造に基づいてアクセスを制御できます。認証済アイデンティティの権限によって、アイデンティティがMCPツールを介してアクセスできるリソースが決まります。

MCPサーバーは、追加の権限を提供したり、既存のIAMポリシーをバイパスしたりしません。たとえば、アイデンティティに、あるコンパートメント内のデータベースを表示する権限があり、別のコンパートメントでは表示する権限がない場合、アイデンティティは、そのアイデンティティの表示が認可されているデータベースの情報のみを取得できます。MCPサーバーを介して接続しても、そのアクセスは他のコンパートメント内のデータベースには拡張されません。

したがって、MCPサーバーを介したアクセスは、MCPサーバー構成と、認証されたIDに割り当てられたアクセス権の両方の対象となります。

読み取り専用操作

管理対象MCPサーバーは、承認された読取り専用OCI Databaseコントロール・プレーン操作をサポートします。

MCP互換のAIエージェントは、これらの操作を使用して、データベースリソースとその動作状態に関するサポートされている情報を取得できます。OCIデータベース・リソースを作成、更新または削除する操作は、MCPサーバーでは使用できません。

たとえば、認可エージェントは、対応する読取り専用MCPツールが使用可能な場合に、データベース、データベース・インフラストラクチャ、バックアップまたはData Guard構成に関する情報を取得できます。エージェントは、MCPサーバーを使用してこれらのリソースを変更できません。

読取り専用制限は、管理対象MCPサーバーを介して公開される操作に適用され、他のOCIインタフェースを介して使用可能な操作は変更されません。

複数のMCPサーバーの使用

複数のMCPサーバーを作成して、異なるアクセスおよび構成要件をサポートできます。

たとえば、異なるデータベースサービス用に別々のMCPサーバーを構成したり、異なるサーバーを介して異なるリソースカテゴリを公開したりできます。各MCPサーバーには、独自の構成とエンドポイントがあります。

認証されたアイデンティティーのアクセス権は、クライアントが使用するMCPサーバーとは無関係に適用され続けます。

MCPサーバーの状態

MCPサーバーは、有効、無効、または削除できます。

  • MCPサーバーが有効な場合、クライアントはMCPエンドポイントに接続し、認証および承認の対象となる、サポートされているMCPツールを使用できます。
  • MCPサーバーが無効になっている場合、クライアントはMCPエンドポイントに接続したり、サポートされているMCPツールを使用することはできません。MCPサーバー構成は保持され、アクセスが必要なときにサーバーを再度有効にできます。
  • MCPサーバーが削除されると、クライアントはMCPエンドポイントに接続したり、サポートされているMCPツールを使用できなくなり、MCPサーバー構成は完全に削除されます。

セキュリティーに関する考慮事項

管理対象MCPサーバーを使用する場合は、次の点を考慮してください。

  • IAMポリシーを使用して、MCPを介してOCIデータベース・リソースにアクセスするユーザーおよびグループが必要とする権限のみを付与します。
  • サービスや組織の要件が異なる構成を必要とする場合は、別々のMCPサーバーを使用します。
  • MCPアクセスが一時的に必要でない場合、MCPサーバーを無効にします。
  • 不要になったMCPサーバーを削除します。
  • MCP互換クライアントを使用するIDに割り当てられたアクセス権を確認します。

管理対象MCPサーバーは、サポートされているOCI Databaseコントロール・プレーン操作への別のインタフェースを提供します。既存のOCI認証、認可、テナンシおよびコンパートメントの境界は、それらの操作がMCPを介してアクセスされたときに引き続き適用されます。

親トピック: ハウツー・ガイド

MCPサーバーの作成

MCPサーバーを作成して、サポートされているOCIデータベース・サービスへのアクセス権をMCP互換クライアントに提供します。

デフォルトでは、MCPサーバーはサポートされているすべてのデータベースサービスに対して構成されます。サーバーは、作成時に特定のデータベース・サービスに制限できます。

  1. ナビゲーション・メニューを開きます。「Oracle AI Database」で、次のいずれかのサービスをクリックし、「AI機能」をクリックします:
    • ベース・データベース・サービス
    • Oracle Exadata Database Service on Cloud@Customer
    • Oracle Exadata Database Service on Dedicated Infrastructure
    • Oracle Exadata Database Service on Exascale Infrastructure
  2. 「MCPサーバーの表示」をクリックします。

    (または)

    「MCPサーバー」タブをクリックします。

  3. 「MCPサーバーの作成」をクリックします。
  4. 次の情報を指定します。
    • 名前: MCPサーバーの名前を入力します。
    • コンパートメント: MCPサーバーを作成するコンパートメントを選択します.
    • ドメイン内のコンパートメント: アイデンティティ・ドメインを含むコンパートメントを選択します。
    • ドメイン: MCPサーバーに関連付けるアイデンティティ・ドメインを選択します。
    • サービス: MCPサーバーがアクセスできるデータベース・サービスを選択します。サポートされているすべてのサービスがデフォルトで選択されます。サービス範囲を制限するには、次のいずれかを選択します。
      • ベース・データベース・サービス
      • Oracle Exadata Database Service on Cloud@Customer
      • Oracle Exadata Database Service on Dedicated Infrastructure
      • Oracle Exadata Database Service on Exascale Infrastructure
    • タグ: オプションで、MCPサーバーにタグを追加します。
  5. 「作成」をクリックします。

MCPサーバーが作成されると、「MCPサーバー」ページに表示されます。

MCPサーバーのリストの表示

コンパートメントでアクセスできるMCPサーバーを表示します。

  1. ナビゲーション・メニューを開きます。「Oracle AI Database」で、次のいずれかのサービスをクリックし、「AI機能」をクリックします:
    • ベース・データベース・サービス
    • Oracle Exadata Database Service on Cloud@Customer
    • Oracle Exadata Database Service on Dedicated Infrastructure
    • Oracle Exadata Database Service on Exascale Infrastructure
  2. 「MCPサーバーの表示」をクリックします。

    (または)

    「MCPサーバー」タブをクリックします。

「MCPサーバー」ページには、アクセス権のあるMCPサーバーが次の情報とともに表示されます。

  • 名前: MCPサーバーの名前。
  • 状態: MCPサーバーの現在の状態(アクティブまたはInActive)。
  • サービス: MCPサーバーに関連付けられたデータベース・サービス。
  • 作成日: MCPサーバーが作成された日時。

MCPサーバーの詳細の表示

MCPサーバーの構成、エンドポイント、およびその他の詳細を表示します。

  1. ナビゲーション・メニューを開きます。「Oracle AI Database」で、次のいずれかのサービスをクリックし、「AI機能」をクリックします:
    • ベース・データベース・サービス
    • Oracle Exadata Database Service on Cloud@Customer
    • Oracle Exadata Database Service on Dedicated Infrastructure
    • Oracle Exadata Database Service on Exascale Infrastructure
  2. 「MCPサーバーの表示」をクリックします。

    (または)

    「MCPサーバー」タブをクリックします。

  3. MCPサーバーのリストから、次のいずれかの方法を使用してMCPサーバーの詳細を表示します。
    • MCPサーバーの名前をクリックします。
    • MCPサーバーの「アクション」メニュー(3つのドット)をクリックし、「詳細の表示」を選択します。

    MCPサーバーの詳細ページには、選択したMCPサーバーのエンドポイントおよび構成の詳細が表示されます。

  4. MCPエンドポイントをコピーするには、「エンドポイントのコピー」をクリックします。
  5. MCPサーバーに関連付けられたタグを表示または管理するには、「タグ」タブをクリックします。

MCPサーバーの有効化または無効化

MCPサーバーを有効または無効にして、クライアントアクセスを制御します。MCPサーバーを無効にすると、クライアントは構成を削除せずにサーバーにアクセスできなくなります。

  1. ナビゲーション・メニューを開きます。「Oracle AI Database」で、次のいずれかのサービスをクリックし、「AI機能」をクリックします:
    • ベース・データベース・サービス
    • Oracle Exadata Database Service on Cloud@Customer
    • Oracle Exadata Database Service on Dedicated Infrastructure
    • Oracle Exadata Database Service on Exascale Infrastructure
  2. 「MCPサーバー」タブをクリックします。
  3. MCPサーバーのリストから、次のいずれかの方法を使用します。
    • 有効化または無効化するMCPサーバーの「アクション」メニュー(3つのドット)をクリックし、必要に応じて「有効化」または「無効化」を選択します。
    • MCPサーバーの名前をクリックして詳細ページを開き、必要に応じて「有効化」または「無効化」をクリックします。
  4. 確認ダイアログ・ボックスで、「有効化」または「無効化」をクリックしてアクションを確認します。

選択したアクションに応じて、MCPサーバーの状態が「アクティブ」または「非アクティブ」に変わります。

MCPサーバーの状態

MCPサーバーには、次のいずれかの状態があります。

  • アクティブ: MCPサーバーは有効です。認証および認可されたMCPクライアントは、サーバーエンドポイントに接続し、サポートされているMCPツールを使用できます。
  • 非アクティブ: MCPサーバーは無効です。MCPクライアントは、サーバー・エンドポイントにアクセスしたり、MCPツールを使用することはできません。サーバー構成は保持され、再度有効にできます。

MCPサーバーの構成を変更せずに、MCPサーバーを有効または無効にできます。非アクティブなMCPサーバーを有効にすると、その状態が「アクティブ」に変わります。アクティブなMCPサーバーを無効にすると、その状態が「非アクティブ」に変わります。

別のコンパートメントへのMCPサーバーの移動

MCPサーバーを現在のコンパートメントから別のコンパートメントに移動します。

  1. ナビゲーション・メニューを開きます。「Oracle AI Database」で、次のいずれかのサービスをクリックし、「AI機能」をクリックします:
    • ベース・データベース・サービス
    • Oracle Exadata Database Service on Cloud@Customer
    • Oracle Exadata Database Service on Dedicated Infrastructure
    • Oracle Exadata Database Service on Exascale Infrastructure
  2. 「MCPサーバー」タブをクリックします。
  3. MCPサーバーのリストから、次のいずれかの方法を使用します。
    • 移動するMCPサーバーの「アクション」メニュー(3つのドット)をクリックし、「リソースの移動」を選択します。
    • MCPサーバーの名前をクリックしてその詳細ページを開き、「アクション」メニューをクリックして、「リソースの移動」を選択します。
  4. 「リソースの移動」ページで、宛先コンパートメントを選択し、「リソースの移動」をクリックします。

MCPサーバーが選択したコンパートメントに移動されます。

MCPサーバーの削除

MCPサーバーを現在のコンパートメントから別のコンパートメントに移動します。

  1. ナビゲーション・メニューを開きます。「Oracle AI Database」で、次のいずれかのサービスをクリックし、「AI機能」をクリックします:
    • ベース・データベース・サービス
    • Oracle Exadata Database Service on Cloud@Customer
    • Oracle Exadata Database Service on Dedicated Infrastructure
    • Oracle Exadata Database Service on Exascale Infrastructure
  2. 「MCPサーバー」タブをクリックします。
  3. MCPサーバーのリストから、次のいずれかの方法を使用します。
    • 削除するMCPサーバーの「アクション」メニュー(3つのドット)をクリックし、「削除」を選択します。
    • MCPサーバーの名前をクリックしてその詳細ページを開き、「アクション」メニューをクリックして、「削除」を選択します。
  4. 確認のダイアログ・ボックスで、「削除」をクリックしてアクションを確定します。

MCPサーバーは削除され、「MCPサーバー」ページで使用できなくなります。MCPクライアントは、エンドポイント経由でサーバーにアクセスできなくなります。

MCPサーバーの詳細の編集

MCPサーバーを編集して、その名前または関連するデータベースサービスを更新します。

  1. ナビゲーション・メニューを開きます。「Oracle AI Database」で、次のいずれかのサービスをクリックし、「AI機能」をクリックします:
    • ベース・データベース・サービス
    • Oracle Exadata Database Service on Cloud@Customer
    • Oracle Exadata Database Service on Dedicated Infrastructure
    • Oracle Exadata Database Service on Exascale Infrastructure
  2. 「MCPサーバー」タブをクリックします。
  3. MCPサーバーのリストから、MCPサーバーの名前をクリックしてその詳細ページを開き、「アクション」メニューをクリックして、「編集」を選択します。
  4. 「MCPサーバーの編集」ページで、必要に応じて次の情報を更新します。
    • Name: MCPサーバーの名前を編集します。
    • サービス: MCPサーバーがアクセスできるデータベース・サービスを選択します。
  5. 「更新」をクリックします。