Verwaltete MCP-Server für OCI Database Services

Mit Managed Model Context Protocol-(MCP-)Servern können MCP-kompatible KI-Agents und -Anwendungen auf unterstützte Informationen zu OCI Database-Ressourcen zugreifen.

Funktionsweise von Managed MCP-Servern

Ein verwalteter MCP-Server stellt eine Schnittstelle zwischen einem MCP-kompatiblen Client und unterstützten OCI Database Control-Plane-APIs bereit.

Wenn Sie einen MCP-Server erstellen, verknüpfen Sie den Server mit einer Identitätsdomain und wählen den entsprechenden Datenbankservice und die entsprechenden Ressourcenkategorien aus. OCI generiert einen MCP-Endpunkt und eine MCP-Clientkonfiguration für den Server. Mit diesen Informationen können Sie einen kompatiblen MCP-Client konfigurieren.

Wenn Sie eine Anforderung in natürlicher Sprache über einen MCP-kompatiblen AI-Agent oder -Client weiterleiten, stellt der Client eine Verbindung zum verwalteten MCP-Server her, indem er MCP über Streamable HTTP verwendet. Der verwaltete MCP-Server authentifiziert den Client und autorisiert den Zugriff basierend auf OCI Identity and Access Management-(IAM-)Policys. Wenn die Anforderung autorisiert ist, ruft der MCP-Server den entsprechenden unterstützten OCI-Datenbankvorgang auf und gibt Informationen zu den angeforderten Datenbankressourcen an den Client zurück.

Beispiel: Sie können einen MCP-kompatiblen AI-Agent bitten, Informationen zu Datenbanken in einem Compartment abzurufen. Der Agent kann ein geeignetes MCP-Tool identifizieren, das Tool aufrufen und die von OCI Database Services zurückgegebenen Informationen verwenden, um auf die Anforderung zu antworten.

Die Verwendung eines MCP-Servers ändert nicht die Berechtigungen, die für den Zugriff auf OCI-Datenbankressourcen erforderlich sind. Die authentifizierte Identität kann nur auf die Ressourcen und Vorgänge zugreifen, die von den entsprechenden IAM-Policys zulässig sind.

MCP-Server

Ein MCP-Server ist eine OCI-Ressource, die einen Remoteendpunkt für MCP-kompatible Clients bereitstellt.

OCI Database Services unterstützt verwaltete MCP-Server für Oracle Base Database Service, Oracle Exadata Database Service on Cloud@Customer, Oracle Exadata Database Service on Dedicated Infrastructure und Oracle Exadata Database Service on Exascale Infrastructure. Sie können mehrere MCP-Server in einem Mandanten für verschiedene Datenbankservices erstellen.

Eine MCP-Serverkonfiguration enthält Informationen wie die zugehörige Identitätsdomain, den Datenbankservice, Ressourcenkategorien und Tags.

OCI bietet einen eindeutigen MCP-Endpunkt für jeden MCP-Server. OCI bietet auch eine MCP-JSON-Konfiguration, mit der Sie kompatible MCP-Clients konfigurieren können.

Sie können einen MCP-Server aktivieren oder deaktivieren. Wenn Sie einen MCP-Server deaktivieren, können Clients nicht auf den Server zugreifen, ohne dessen Konfiguration zu löschen. Wenn Sie einen MCP-Server nicht mehr benötigen, können Sie ihn löschen.

MCP-Tools

MCP-Tools werden von OCI Database-Vorgängen unterstützt, die ein MCP-kompatibler Client über einen MCP-Server erkennen und aufrufen kann.

Der MCP-Server stellt unterstützte schreibgeschützte Control-Plane-Vorgänge als MCP-Tools zur Verfügung. Ein AI-Agent kann bestimmen, welches verfügbare Tool für eine Anforderung geeignet ist, und dieses Tool mit den erforderlichen Parametern aufrufen.

Die über einen MCP-Server verfügbaren Tools hängen vom Datenbankservice und den Ressourcenkategorien ab, die für den Server konfiguriert sind.

Folgende Ressourcenkategorien werden unterstützt:

Die Verfügbarkeit eines MCP-Tools erteilt keine Berechtigung zur Verwendung des entsprechenden OCI-Datenbankvorgangs. OCI-IAM-Policys bestimmen, ob die authentifizierte Identität auf die angeforderte Ressource zugreifen kann.

MCP-Endpunkt und Clientkonfiguration

Jeder MCP-Server verfügt über einen MCP-Endpunkt, mit dem kompatible Clients eine Verbindung zum Server über Streamable HTTP herstellen.

Nachdem Sie einen MCP-Server erstellt haben, können Sie den generierten Endpunkt aus den MCP-Serverdetails abrufen. Sie können auch die MCP-JSON-Konfiguration abrufen, die zur Konfiguration eines kompatiblen MCP-Clients erforderlich ist.

Nachdem der Client konfiguriert und authentifiziert wurde, kann er eine Verbindung zum Endpunkt herstellen und die über den Server verfügbaren MCP-Tools ermitteln.

Die Art und Weise, wie Sie einem Client eine MCP-Serverkonfiguration hinzufügen, hängt von dem verwendeten MCP-Client ab.

Authentifizierung

MCP-Server verwenden die OAuth-basierte Authentifizierung über OCI Identity. Wenn Sie einen MCP-Server erstellen, verknüpfen Sie ihn mit einer Identitätsdomain.

Um auf einen MCP-Server zuzugreifen, authentifiziert sich der MCP-Client bei der zugehörigen Identitätsdomain und ruft ein OAuth-Zugriffstoken ab. Der Client verwendet das Zugriffstoken bei der Verbindung zum MCP-Server. Der MCP-Server validiert das Token, bevor der Client auf die unterstützten MCP-Tools zugreifen kann.

Autorisierung

OCI IAM kontrolliert den Zugriff auf OCI-Datenbankressourcen, auf die über einen MCP-Server zugegriffen wird.

IAM-Policys können den Zugriff basierend auf Benutzern, Gruppen, Mandanten, Compartments und anderen unterstützten OCI IAM-Konstrukten kontrollieren. Die Berechtigungen der authentifizierten Identität bestimmen, auf welche Ressourcen die Identität über die MCP-Tools zugreifen kann.

Ein MCP-Server stellt keine zusätzlichen Berechtigungen bereit oder umgeht vorhandene IAM-Policys. Beispiel: Wenn eine Identität die Berechtigung zum Anzeigen von Datenbanken in einem Compartment, aber nicht in einem anderen besitzt, kann die Identität nur Informationen für Datenbanken abrufen, für die sie berechtigt ist. Die Verbindung über einen MCP-Server erweitert diesen Zugriff nicht auf Datenbanken in anderen Compartments.

Der Zugriff über einen MCP-Server unterliegt daher sowohl der MCP-Serverkonfiguration als auch den Berechtigungen, die der authentifizierten Identität zugewiesen sind.

Schreibgeschützte Vorgänge

Managed MCP-Server unterstützen genehmigte schreibgeschützte Vorgänge der OCI Database Control Plane.

MCP-kompatible AI-Agents können diese Vorgänge verwenden, um unterstützte Informationen zu Datenbankressourcen und deren Betriebszustand abzurufen. Vorgänge, die OCI-Datenbankressourcen erstellen, aktualisieren oder löschen, sind nicht über den MCP-Server verfügbar.

Beispiel: Ein autorisierter Agent kann Informationen zu einer Datenbank-, Datenbankinfrastruktur-, Backup- oder Data Guard-Konfiguration abrufen, wenn ein entsprechendes schreibgeschütztes MCP-Tool verfügbar ist. Der Agent kann diese Ressourcen nicht mit dem MCP-Server ändern.

Die schreibgeschützte Einschränkung gilt für Vorgänge, die über den verwalteten MCP-Server verfügbar gemacht werden, und ändert nicht die Vorgänge, die über andere OCI-Schnittstellen verfügbar sind.

Mehrere MCP-Server verwenden

Sie können mehrere MCP-Server erstellen, um unterschiedliche Zugriffs- und Konfigurationsanforderungen zu unterstützen.

Beispiel: Sie können separate MCP-Server für verschiedene Datenbankservices konfigurieren oder verschiedene Ressourcenkategorien über verschiedene Server verfügbar machen. Jeder MCP-Server verfügt über eine eigene Konfiguration und einen eigenen Endpunkt.

Die Berechtigungen der authentifizierten Identität gelten weiterhin unabhängig vom MCP-Server, den der Client verwendet.

MCP-Serverstatus

Ein MCP-Server kann aktiv, inaktiv oder gelöscht sein.

Sicherheitsrichtlinien

Beachten Sie Folgendes, wenn Sie Managed MCP-Server verwenden:

Managed MCP-Server stellen eine weitere Schnittstelle für unterstützte Vorgänge der OCI Database Control Plane bereit. Vorhandene Grenzen für OCI-Authentifizierung, -Autorisierung, -Mandanten und -Compartments gelten weiterhin, wenn über MCP auf diese Vorgänge zugegriffen wird.

MCP- Server erstellen

Erstellen Sie einen MCP-Server, um MCP-kompatiblen Clients Zugriff auf unterstützte OCI-Datenbankservices zu erteilen.

Standardmäßig ist der MCP-Server für alle unterstützten Datenbankservices konfiguriert. Sie können den Server beim Erstellen auf bestimmte Datenbankservices beschränken.

  1. Öffnen Sie das Navigationsmenü. Wählen Sie unter Oracle AI Database die Option Base Database Service und dann KI-Funktionen aus.
  2. Wählen Sie MCP-Server anzeigen, oder wählen Sie die Registerkarte MCP-Server aus.
  3. Wählen Sie MCP-Server erstellen aus.
  4. Geben Sie folgende Informationen an:
    • Name: Geben Sie einen Namen für den MCP-Server ein.
    • Compartment: Wählen Sie das Compartment, in dem der MCP-Server erstellt wird.
    • Compartment in Domain: Wählen Sie das Compartment aus, das die Identitätsdomain enthält.
    • Domain: Wählen Sie die Identitätsdomain aus, die mit dem MCP-Server verknüpft werden soll.
    • Services: Wählen Sie die Datenbankservices aus, auf die der MCP-Server zugreifen kann. Alle unterstützten Services sind standardmäßig ausgewählt. Um den Serviceumfang einzuschränken, wählen Sie mindestens eine der folgenden Optionen aus:
      • Oracle Base Database Service
      • Oracle Exadata Database Service on Cloud@Customer
      • Oracle Exadata Database Service on Dedicated Infrastructure
      • Oracle Exadata Database Service auf Exascale-Infrastruktur
    • Tags: Fügen Sie dem MCP-Server optional Tags hinzu.
  5. Wählen Sie Erstellen.

Nachdem der MCP-Server erstellt wurde, wird er auf der Seite "MCP-Server" angezeigt.

Liste der MCP-Server anzeigen

Zeigen Sie die MCP-Server an, auf die Sie in einem Compartment Zugriff haben.

  1. Öffnen Sie das Navigationsmenü. Wählen Sie unter Oracle AI Database die Option Base Database Service und dann KI-Funktionen aus.
  2. Wählen Sie MCP-Server anzeigen, oder wählen Sie die Registerkarte MCP-Server aus.

Auf der Seite "MCP-Server" werden die MCP-Server angezeigt, auf die Sie Zugriff haben. Folgende Informationen sind verfügbar:

Details zu einem MCP-Server anzeigen

Zeigen Sie Konfiguration, Endpunkt und andere Details eines MCP-Servers an.

  1. Öffnen Sie das Navigationsmenü. Wählen Sie unter Oracle AI Database die Option Base Database Service und dann KI-Funktionen aus.
  2. Wählen Sie MCP-Server anzeigen, oder wählen Sie die Registerkarte MCP-Server aus.
  3. Verwenden Sie in der Liste der MCP-Server eine der folgenden Methoden, um die Details eines MCP-Servers anzuzeigen:
    • Wählen Sie den Namen des MCP-Servers aus.
    • Wählen Sie das Menü Aktionen (drei Punkte) für den MCP-Server aus, und wählen Sie Details anzeigen aus.

    Auf der Seite mit den MCP-Serverdetails werden der Endpunkt und die Konfigurationsdetails des ausgewählten MCP-Servers angezeigt.

  4. Um den MCP-Endpunkt zu kopieren, wählen Sie Endpunkt kopieren aus.
  5. Um die mit dem MCP-Server verknüpften Tags anzuzeigen oder zu verwalten, wählen Sie die Registerkarte Tags aus.

MCP-Server aktivieren bzw. deaktivieren

Aktivieren oder deaktivieren Sie einen MCP-Server, um den Clientzugriff zu steuern. Wenn Sie einen MCP-Server deaktivieren, können Clients nicht auf den Server zugreifen, ohne dessen Konfiguration zu löschen.

  1. Öffnen Sie das Navigationsmenü. Wählen Sie unter Oracle AI Database die Option Base Database Service und dann KI-Funktionen aus.
  2. Wählen Sie die Registerkarte MCP-Server.
  3. Verwenden Sie eine der folgenden Methoden aus der Liste der MCP-Server:
    • Wählen Sie das Menü Aktionen (drei Punkte) für den MCP-Server aus, den Sie aktivieren oder deaktivieren möchten, und wählen Sie dann Aktivieren oder Deaktivieren aus.
    • Wählen Sie den Namen des MCP-Servers aus, um die Detailseite zu öffnen, und wählen Sie Aktivieren oder Deaktivieren aus.
  4. Wählen Sie im Bestätigungsdialogfeld Aktivieren oder Deaktivieren aus, um die Aktion zu bestätigen.

Der Status des MCP-Servers ändert sich je nach ausgewählter Aktion in Aktiv oder Inaktiv.

MCP-Serverstatus:

Ein MCP-Server kann einen der folgenden Status aufweisen:

Sie können einen MCP-Server aktivieren oder deaktivieren, ohne dessen Konfiguration zu ändern. Wenn Sie einen inaktiven MCP-Server aktivieren, ändert sich sein Status in Aktiv. Wenn Sie einen aktiven MCP-Server deaktivieren, ändert sich sein Status in Inaktiv.

MCP-Server in ein anderes Compartment verschieben

MCP-Server aus dem aktuellen Compartment in ein anderes Compartment verschieben.

  1. Öffnen Sie das Navigationsmenü. Wählen Sie unter Oracle AI Database die Option Base Database Service und dann KI-Funktionen aus.
  2. Wählen Sie die Registerkarte MCP-Server.
  3. Verwenden Sie eine der folgenden Methoden aus der Liste der MCP-Server:
    • Wählen Sie das Menü Aktionen (drei Punkte) für den MCP-Server aus, den Sie verschieben möchten, und wählen Sie Ressource verschieben aus.
    • Wählen Sie den Namen des MCP-Servers aus, um die Detailseite zu öffnen, wählen Sie das Menü Aktionen und dann Ressource verschieben aus.
  4. Wählen Sie auf der Seite "Ressource verschieben" das Ziel-Compartment und dann Ressource verschieben aus.

Der MCP-Server wird in das ausgewählte Compartment verschoben.

MCP-Server löschen

MCP-Server aus dem aktuellen Compartment löschen.

  1. Öffnen Sie das Navigationsmenü. Wählen Sie unter Oracle AI Database die Option Base Database Service und dann KI-Funktionen aus.
  2. Wählen Sie die Registerkarte MCP-Server.
  3. Verwenden Sie eine der folgenden Methoden aus der Liste der MCP-Server:
    • Wählen Sie das Menü Aktionen (drei Punkte) für den MCP-Server aus, den Sie löschen möchten, und wählen Sie Löschen aus.
    • Wählen Sie den Namen des MCP-Servers aus, um die Detailseite zu öffnen, wählen Sie das Menü Aktionen und dann Löschen aus.
  4. Wählen Sie im Bestätigungsdialogfeld Löschen aus, um die Aktion zu bestätigen.

Der MCP-Server wird gelöscht und ist nicht mehr auf der Seite "MCP-Server" verfügbar. MCP-Clients können nicht mehr über ihren Endpunkt auf den Server zugreifen.

Details eines MCP-Servers bearbeiten

Bearbeiten Sie einen MCP-Server, um seinen Namen oder die zugehörigen Datenbankservices zu aktualisieren.

  1. Öffnen Sie das Navigationsmenü. Wählen Sie unter Oracle AI Database die Option Base Database Service und dann KI-Funktionen aus.
  2. Wählen Sie die Registerkarte MCP-Server.
  3. Wählen Sie in der Liste der MCP-Server den Namen des MCP-Servers aus, um die Detailseite zu öffnen, wählen Sie das Menü Aktionen und dann Bearbeiten aus.
  4. Aktualisieren Sie auf der Seite "MCP-Server bearbeiten" nach Bedarf die folgenden Informationen:
    • Name: Bearbeiten Sie den Namen des MCP-Servers.
    • Services: Wählen Sie die Datenbankservices aus, auf die der MCP-Server zugreifen kann.
  5. Wählen Sie Aktualisieren aus.