Serveurs MCP gérés pour les services de base de données OCI

Les serveurs MCP (Managed Model Context Protocol) permettent aux agents et applications d'IA compatibles avec MCP d'accéder aux informations prises en charge sur les ressources OCI Database.

Fonctionnement des serveurs MCP gérés

Un serveur MCP géré fournit une interface entre un client compatible MCP et les API de plan de contrôle OCI Database prises en charge.

Lorsque vous créez un serveur MCP, vous associez le serveur à un domaine d'identité et sélectionnez les catégories de ressource et de service de base de données applicables. OCI génère une configuration d'adresse et de client MCP pour le serveur. Vous pouvez utiliser ces informations pour configurer un client MCP compatible.

Lorsque vous soumettez une demande en langage naturel via un agent ou un client AI compatible MCP, le client se connecte au serveur MCP géré à l'aide de MCP sur HTTP transmissible. Le serveur MCP géré authentifie le client et autorise l'accès en fonction des stratégies OCI Identity and Access Management (IAM). Si la demande est autorisée, le serveur MCP appelle l'opération de base de données OCI prise en charge applicable et renvoie au client des informations sur les ressources de base de données demandées.

Par exemple, vous pouvez demander à un agent d'IA compatible MCP d'extraire des informations sur les bases de données d'un compartiment. L'agent peut identifier un outil MCP approprié, appeler l'outil et utiliser les informations renvoyées par OCI Database Services pour répondre à la demande.

L'utilisation d'un serveur MCP ne modifie pas les droits d'accès requis pour accéder aux ressources de base de données OCI. L'identité authentifiée ne peut accéder qu'aux ressources et opérations autorisées par les stratégies IAM applicables.

Serveurs MCP

Un serveur MCP est une ressource OCI qui fournit une adresse distante pour les clients compatibles MCP.

OCI Database Services prend en charge les serveurs MCP gérés pour Oracle Base Database Service, Oracle Exadata Database Service on Cloud@Customer, Oracle Exadata Database Service on Dedicated Infrastructure et Oracle Exadata Database Service on Exascale Infrastructure. Vous pouvez créer plusieurs serveurs MCP dans une location pour différents services de base de données.

Une configuration de serveur MCP inclut des informations telles que le domaine d'identité associé, le service de base de données, les catégories de ressources et les balises.

OCI fournit une adresse MCP unique pour chaque serveur MCP. OCI fournit également une configuration JSON MCP que vous pouvez utiliser pour configurer des clients MCP compatibles.

Un serveur MCP peut être activé ou désactivé. La désactivation d'un serveur MCP empêche les clients d'accéder au serveur sans supprimer sa configuration. Lorsque vous n'avez plus besoin d'un serveur MCP, vous pouvez le supprimer.

Outils MCP

Les outils MCP sont des opérations de base de données OCI prises en charge qu'un client compatible MCP peut repérer et appeler via un serveur MCP.

Le serveur MCP rend les opérations de plan de contrôle en lecture seule prises en charge disponibles en tant qu'outils MCP. Un agent AI peut déterminer quel outil disponible est approprié pour une demande et appeler cet outil avec les paramètres requis.

Les outils disponibles via un serveur MCP dépendent du service de base de données et des catégories de ressources configurées pour le serveur.

Les catégories de ressources prises en charge peuvent inclure :

La disponibilité d'un outil MCP n'autorise pas l'utilisation de l'opération de base de données OCI correspondante. Les stratégies OCI IAM déterminent si l'identité authentifiée peut accéder à la ressource demandée.

Configuration d'adresse et de client MCP

Chaque serveur MCP dispose d'une adresse MCP que les clients compatibles utilisent pour se connecter au serveur à l'aide du protocole HTTP Streamable.

Après avoir créé un serveur MCP, vous pouvez obtenir l'adresse générée à partir des détails du serveur MCP. Vous pouvez également obtenir la configuration JSON MCP requise pour configurer un client MCP compatible.

Une fois le client configuré et authentifié, il peut se connecter à l'adresse et repérer les outils MCP disponibles via le serveur.

La façon dont vous ajoutez une configuration de serveur MCP à un client dépend du client MCP que vous utilisez.

Authentification

Les serveurs MCP utilisent l'authentification basée sur OAuth via OCI Identity. Lorsque vous créez un serveur MCP, vous l'associez à un domaine d'identité.

Pour accéder à un serveur MCP, le client MCP s'authentifie auprès du domaine d'identité associé et obtient un jeton d'accès OAuth. Le client utilise le jeton d'accès lors de la connexion au serveur MCP. Le serveur MCP valide le jeton avant d'autoriser le client à accéder aux outils MCP pris en charge.

Autorisation

OCI IAM contrôle l'accès aux ressources de base de données OCI accessibles via un serveur MCP.

Les stratégies IAM peuvent contrôler l'accès en fonction des utilisateurs, des groupes, des locations, des compartiments et d'autres structures OCI IAM prises en charge. Les droits d'accès de l'identité authentifiée déterminent les ressources auxquelles l'identité peut accéder via les outils MCP.

Un serveur MCP ne fournit pas de droits d'accès supplémentaires ni ne contourne les stratégies IAM existantes. Par exemple, si une identité est autorisée à visualiser des bases de données dans un compartiment, mais pas dans un autre, elle ne peut extraire des informations que pour les bases de données que l'identité est autorisée à visualiser. La connexion via un serveur MCP n'étend pas cet accès aux bases de données d'autres compartiments.

L'accès via un serveur MCP est donc soumis à la fois à la configuration du serveur MCP et aux autorisations affectées à l'identité authentifiée.

Opérations en lecture seule

Les serveurs MCP gérés prennent en charge les opérations de plan de contrôle de base de données OCI en lecture seule approuvées.

Les agents d'IA compatibles avec MCP peuvent utiliser ces opérations pour extraire les informations prises en charge sur les ressources de base de données et leur état opérationnel. Les opérations qui créent, mettent à jour ou suppriment des ressources de base de données OCI ne sont pas disponibles via le serveur MCP.

Par exemple, un agent autorisé peut extraire des informations sur une configuration de base de données, d'infrastructure de base de données, de sauvegarde ou Data Guard lorsqu'un outil MCP en lecture seule correspondant est disponible. L'agent ne peut pas utiliser le serveur MCP pour modifier ces ressources.

La restriction en lecture seule s'applique aux opérations exposées via le serveur MCP géré et ne modifie pas les opérations disponibles via d'autres interfaces OCI.

Utilisation de plusieurs serveurs MCP

Vous pouvez créer plusieurs serveurs MCP pour prendre en charge différentes exigences en matière d'accès et de configuration.

Par exemple, vous pouvez configurer des serveurs MCP distincts pour différents services de base de données ou exposer différentes catégories de ressources via différents serveurs. Chaque serveur MCP dispose de sa propre configuration et de sa propre adresse.

Les droits d'accès de l'identité authentifiée continuent de s'appliquer indépendamment du serveur MCP que le client utilise.

Etats du serveur MCP

Un serveur MCP peut être actif, inactif ou supprimé.

Conseils de sécurité

Tenez compte des points suivants lorsque vous utilisez des serveurs MCP gérés :

Les serveurs MCP gérés fournissent une autre interface pour les opérations de plan de contrôle OCI Database prises en charge. Les limites d'authentification, d'autorisation, de location et de compartiment OCI existantes continuent de s'appliquer lorsque ces opérations sont accessibles via MCP.

Création d'un serveur MCP

Créez un serveur MCP pour permettre aux clients compatibles avec MCP d'accéder aux services OCI Database pris en charge.

Par défaut, le serveur MCP est configuré pour tous les services de base de données pris en charge. Vous pouvez limiter le serveur à des services de base de données spécifiques lorsque vous le créez.

  1. Ouvrez le menu de navigation. Sous Oracle AI Database, sélectionnez Base Database Service, puis Fonctions d'IA.
  2. Sélectionnez Afficher les serveurs MCP ou sélectionnez l'onglet Serveurs MCP.
  3. Sélectionnez Créer un serveur MCP.
  4. Spécifiez les informations suivantes :
    • Nom : entrez le nom du serveur MCP.
    • Compartiment : sélectionnez le compartiment dans lequel créer le serveur MCP,
    • Compartiment dans le domaine : sélectionnez le compartiment contenant le domaine d'identité.
    • Domaine : sélectionnez le domaine d'identité à associer au serveur MCP.
    • Services : sélectionnez les services de base de données auxquels le serveur MCP peut accéder. Tous les services pris en charge sont sélectionnés par défaut. Pour limiter la portée du service, sélectionnez une ou plusieurs des options suivantes :
      • Oracle Base Database Service
      • Oracle Exadata Database Service on Cloud@Customer
      • Oracle Exadata Database Service on Dedicated Infrastructure
      • Oracle Exadata Database Service on Exascale Infrastructure
    • Balises : vous pouvez éventuellement ajouter des balises au serveur MCP.
  5. Choisissez Créer.

Une fois le serveur MCP créé, il apparaît sur la page Serveurs MCP.

Affichage de la liste des serveurs MCP

Affichez les serveurs MCP auxquels vous avez accès dans un compartiment.

  1. Ouvrez le menu de navigation. Sous Oracle AI Database, sélectionnez Base Database Service, puis Fonctions d'IA.
  2. Sélectionnez Afficher les serveurs MCP ou sélectionnez l'onglet Serveurs MCP.

La page Serveurs MCP affiche les serveurs MCP auxquels vous avez accès, avec les informations suivantes :

Affichage des détails d'un serveur MCP

Affichez la configuration, l'adresse et d'autres détails d'un serveur MCP.

  1. Ouvrez le menu de navigation. Sous Oracle AI Database, sélectionnez Base Database Service, puis Fonctions d'IA.
  2. Sélectionnez Afficher les serveurs MCP ou sélectionnez l'onglet Serveurs MCP.
  3. Dans la liste des serveurs MCP, utilisez l'une des méthodes suivantes pour afficher les détails d'un serveur MCP :
    • Sélectionnez le nom du serveur MCP.
    • Sélectionnez le menu Actions (trois points) du serveur MCP, puis sélectionnez Afficher les détails.

    La page de détails du serveur MCP affiche l'adresse et les détails de configuration du serveur MCP sélectionné.

  4. Pour copier l'adresse MCP, sélectionnez Copier l'adresse.
  5. Pour afficher ou gérer les balises associées au serveur MCP, sélectionnez l'onglet Balises.

Activer ou désactiver un serveur MCP

Activez ou désactivez un serveur MCP pour contrôler l'accès client. La désactivation d'un serveur MCP empêche les clients d'accéder au serveur sans supprimer sa configuration.

  1. Ouvrez le menu de navigation. Sous Oracle AI Database, sélectionnez Base Database Service, puis Fonctions d'IA.
  2. Sélectionnez l'onglet Serveurs TCP.
  3. Dans la liste des serveurs MCP, utilisez l'une des méthodes suivantes :
    • Sélectionnez le menu Actions (trois points) du serveur MCP que vous souhaitez activer ou désactiver, puis sélectionnez Activer ou Désactiver, le cas échéant.
    • Sélectionnez le nom du serveur MCP pour ouvrir sa page de détails, puis sélectionnez Activer ou Désactiver, le cas échéant.
  4. Dans la boîte de dialogue de confirmation, sélectionnez Activer ou Désactiver pour confirmer l'action.

L'état du serveur MCP passe à Actif ou Inactif, selon l'action sélectionnée.

Etats du serveur MCP :

Un serveur MCP peut présenter l'un des états suivants :

Vous pouvez activer ou désactiver un serveur MCP sans modifier sa configuration. Lorsque vous activez un serveur MCP inactif, son état passe à Actif. Lorsque vous désactivez un serveur MCP actif, son état devient Inactif.

Déplacement d'un serveur MCP vers un autre compartiment

Déplacez un serveur MCP de son compartiment en cours vers un autre compartiment.

  1. Ouvrez le menu de navigation. Sous Oracle AI Database, sélectionnez Base Database Service, puis Fonctions d'IA.
  2. Sélectionnez l'onglet Serveurs TCP.
  3. Dans la liste des serveurs MCP, utilisez l'une des méthodes suivantes :
    • Sélectionnez le menu Actions (trois points) du serveur MCP à déplacer, puis sélectionnez Déplacer la ressource.
    • Sélectionnez le nom du serveur MCP pour ouvrir sa page de détails, sélectionnez le menu Actions, puis Déplacer la ressource.
  4. Sur la page Déplacer la ressource, sélectionnez le compartiment de destination, puis Déplacer la ressource.

Le serveur MCP est déplacé vers le compartiment sélectionné.

Suppression d'un serveur MCP

Supprimez un serveur MCP de son compartiment en cours.

  1. Ouvrez le menu de navigation. Sous Oracle AI Database, sélectionnez Base Database Service, puis Fonctions d'IA.
  2. Sélectionnez l'onglet Serveurs TCP.
  3. Dans la liste des serveurs MCP, utilisez l'une des méthodes suivantes :
    • Sélectionnez le menu Actions (trois points) du serveur MCP à supprimer, puis sélectionnez Supprimer.
    • Sélectionnez le nom du serveur MCP pour ouvrir sa page de détails, sélectionnez le menu Actions, puis Supprimer.
  4. Dans la boîte de dialogue de confirmation, sélectionnez Supprimer pour confirmer l'action.

Le serveur MCP est supprimé et n'est plus disponible sur la page Serveurs MCP. Les clients MCP ne peuvent plus accéder au serveur via son adresse.

Modifier les détails d'un serveur MCP

Modifiez un serveur MCP pour mettre à jour son nom ou les services de base de données associés.

  1. Ouvrez le menu de navigation. Sous Oracle AI Database, sélectionnez Base Database Service, puis Fonctions d'IA.
  2. Sélectionnez l'onglet Serveurs TCP.
  3. Dans la liste des serveurs MCP, sélectionnez le nom du serveur MCP pour ouvrir sa page de détails, sélectionnez le menu Actions, puis sélectionnez Modifier.
  4. Dans la page Modifier le serveur MCP, mettez à jour les informations suivantes selon vos besoins :
    • Nom : modifiez le nom du serveur MCP.
    • Services : sélectionnez les services de base de données auxquels le serveur MCP peut accéder.
  5. Sélectionnez Mettre à jour.