Server MCP gestiti per i servizi di database OCI

I server MCP (Managed Model Context Protocol) consentono agli agenti e alle applicazioni AI compatibili con MCP di accedere alle informazioni supportate sulle risorse del database OCI.

Come funzionano i server MCP gestiti

Un server MCP gestito fornisce un'interfaccia tra un client compatibile con MCP e le API del piano di controllo del database OCI supportate.

Quando si crea un server MCP, il server viene associato a un dominio di Identity e si selezionano il servizio di database e le categorie di risorse applicabili. OCI genera un endpoint MCP e una configurazione client MCP per il server. È possibile utilizzare queste informazioni per configurare un client MCP compatibile.

Quando si invia una richiesta in linguaggio naturale tramite un agente o un client AI compatibile con MCP, il client si connette al server MCP gestito utilizzando MCP su HTTP Streamable. Il server MCP gestito autentica il client e autorizza l'accesso in base ai criteri IAM (Identity and Access Management) OCI. Se la richiesta è autorizzata, il server MCP richiama l'operazione di database OCI supportata applicabile e restituisce al client le informazioni sulle risorse di database richieste.

Ad esempio, puoi chiedere a un agente AI compatibile con MCP di recuperare informazioni sui database in un compartimento. L'agente può identificare uno strumento MCP appropriato, richiamare lo strumento e utilizzare le informazioni restituite dai Servizi di database OCI per rispondere alla richiesta.

L'utilizzo di un server MCP non modifica le autorizzazioni necessarie per accedere alle risorse del database OCI. L'identità autenticata può accedere solo alle risorse e alle operazioni consentite dai criteri IAM applicabili.

Server MCP

Un server MCP è una risorsa OCI che fornisce un endpoint remoto per i client compatibili con MCP.

OCI Database Services supporta server MCP gestiti per Oracle Base Database Service, Oracle Exadata Database Service on Cloud@Customer, Oracle Exadata Database Service on Dedicated Infrastructure e Oracle Exadata Database Service on Exascale Infrastructure. È possibile creare più server MCP in una tenancy per servizi di database diversi.

Una configurazione server MCP include informazioni quali il dominio di Identity associato, il servizio di database, le categorie di risorse e le tag.

OCI fornisce un endpoint MCP univoco per ogni server MCP. OCI fornisce anche la configurazione JSON MCP che puoi utilizzare per configurare client MCP compatibili.

È possibile abilitare o disabilitare un server MCP. La disabilitazione di un server MCP impedisce ai client di accedere al server senza eliminarne la configurazione. Quando non è più necessario un server MCP, è possibile eliminarlo.

Strumenti MCP

Gli strumenti MCP sono operazioni di database OCI supportate che un client compatibile con MCP può trovare e richiamare tramite un server MCP.

Il server MCP rende disponibili le operazioni del piano di controllo di sola lettura supportate come strumenti MCP. Un agente AI può determinare quale strumento disponibile è appropriato per una richiesta e richiamare tale strumento con i parametri richiesti.

Gli strumenti disponibili tramite un server MCP dipendono dal servizio di database e dalle categorie di risorse configurate per il server.

Le categorie di risorse supportate possono includere:

• Infrastruttura di database
• Virtual machine
• Backup del database
• Data Guard
• Metadati operativi del database correlato

La disponibilità di uno strumento MCP non concede l'autorizzazione per utilizzare l'operazione del database OCI corrispondente. I criteri IAM OCI determinano se l'identità autenticata può accedere alla risorsa richiesta.

Configurazione endpoint e client MCP

Ogni server MCP dispone di un endpoint MCP che i client compatibili utilizzano per connettersi al server utilizzando il protocollo HTTP Streamable.

Dopo aver creato un server MCP, è possibile ottenere l'endpoint generato dai dettagli del server MCP. È inoltre possibile ottenere la configurazione JSON MCP necessaria per configurare un client MCP compatibile.

Una volta configurato e autenticato, il client può connettersi all'endpoint e trovare gli strumenti MCP disponibili tramite il server.

Il modo in cui si aggiunge una configurazione di server MCP a un client dipende dal client MCP utilizzato.

Autenticazione

I server MCP utilizzano l'autenticazione basata su OAuth tramite OCI Identity. Quando si crea un server MCP, lo si associa a un dominio di Identity.

Per accedere a un server MCP, il client MCP esegue l'autenticazione con il dominio di Identity associato e ottiene un token di accesso OAuth. Il client utilizza il token di accesso durante la connessione al server MCP. Il server MCP convalida il token prima di consentire al client di accedere agli strumenti MCP supportati.

Autorizzazione

OCI IAM controlla l'accesso alle risorse del database OCI a cui si accede tramite un server MCP.

I criteri IAM possono controllare l'accesso in base a utenti, gruppi, tenancy, compartimenti e altri costrutti IAM OCI supportati. Le autorizzazioni dell'identità autenticata determinano a quali risorse l'identità può accedere tramite gli strumenti MCP.

Un server MCP non fornisce autorizzazioni aggiuntive o ignora i criteri IAM esistenti. Ad esempio, se un'identità dispone dell'autorizzazione per visualizzare i database in un compartimento ma non in un altro, l'identità può recuperare informazioni solo per i database che l'identità è autorizzata a visualizzare. La connessione tramite un server MCP non estende tale accesso ai database in altri compartimenti.

L'accesso tramite un server MCP è pertanto soggetto sia alla configurazione del server MCP che alle autorizzazioni assegnate all'identità autenticata.

Operazioni di sola lettura

I server MCP gestiti supportano le operazioni del piano di controllo OCI Database di sola lettura approvate.

Gli agenti AI compatibili con MCP possono utilizzare queste operazioni per recuperare le informazioni supportate sulle risorse del database e sul loro stato operativo. Le operazioni che creano, aggiornano o eliminano le risorse del database OCI non sono disponibili tramite il server MCP.

Ad esempio, un agente autorizzato può recuperare informazioni su una configurazione di database, infrastruttura di database, backup o Data Guard quando è disponibile uno strumento MCP di sola lettura corrispondente. L'agente non può utilizzare il server MCP per modificare tali risorse.

La restrizione di sola lettura si applica alle operazioni esposte tramite il server MCP gestito e non modifica le operazioni disponibili tramite altre interfacce OCI.

Utilizzo di più server MCP

È possibile creare più server MCP per supportare diversi requisiti di accesso e configurazione.

Ad esempio, è possibile configurare server MCP separati per servizi di database diversi o esporre categorie di risorse diverse attraverso server diversi. Ogni server MCP ha la propria configurazione e endpoint.

Le autorizzazioni dell'identità autenticata continuano ad essere applicate indipendentemente dal server MCP utilizzato dal client.

Stati server MCP

Un server MCP può essere attivo, inattivo o eliminato.

• Quando un server MCP è abilitato, i client possono connettersi all'endpoint MCP e utilizzare gli strumenti MCP supportati, soggetti all'autenticazione e all'autorizzazione.
• Quando un server MCP è inattivo, i client non possono connettersi all'endpoint MCP o utilizzare gli strumenti MCP supportati. La configurazione del server MCP viene mantenuta ed è possibile riattivare il server quando è richiesto l'accesso.
• Quando un server MCP viene eliminato, i client non possono più connettersi all'endpoint MCP o utilizzare gli strumenti MCP supportati e la configurazione del server MCP viene rimossa definitivamente.

Linee guida sulla sicurezza

Considerare quanto segue quando si utilizzano server MCP gestiti:

• Utilizzare i criteri IAM per concedere solo le autorizzazioni richieste dagli utenti e dai gruppi che accedono alle risorse di database OCI tramite MCP.
• Utilizza server MCP separati quando servizi o requisiti organizzativi diversi richiedono configurazioni diverse.
• Disabilitare un server MCP quando l'accesso MCP non è temporaneamente necessario.
• Eliminare i server MCP non più necessari.
• Rivedere le autorizzazioni assegnate alle identità che utilizzano client compatibili con MCP.

I server MCP gestiti forniscono un'altra interfaccia alle operazioni del piano di controllo del database OCI supportate. L'autenticazione OCI esistente, l'autorizzazione, la tenancy e i confini del compartimento continuano a essere applicati quando si accede a tali operazioni tramite MCP.

Crea il server MCP

Creare un server MCP per fornire ai client compatibili con MCP l'accesso ai servizi di database OCI supportati.

Per impostazione predefinita, il server MCP è configurato per tutti i servizi di database supportati. È possibile limitare il server a servizi di database specifici quando lo si crea.

1. Aprire il menu di navigazione. In Oracle AI Database, selezionare Base Database Service, quindi Funzionalità AI.
2. Selezionare Visualizza server MCP o selezionare la scheda Server MCP.
3. Selezionare Crea server MCP.
4. Specificare le informazioni riportate di seguito.
   • Nome: immettere un nome per il server MCP.
   • Compartimento: selezionare il compartimento in cui creare il server MCP.
   • Compartimento nel dominio: selezionare il compartimento contenente il dominio di Identity.
   • Dominio: selezionare il dominio di Identity da associare al server MCP.
   • Servizi: selezionare i servizi di database a cui il server MCP può accedere. Tutti i servizi supportati sono selezionati per impostazione predefinita. Per limitare l'ambito del servizio, selezionare una o più delle voci riportate di seguito.
     • Oracle Base Database Service
     • Oracle Exadata Database Service on Cloud@Customer
     • Oracle Exadata Database Service on Dedicated Infrastructure
     • Oracle Exadata Database Service su infrastruttura Exascale
   • Tag: facoltativamente, aggiungere tag al server MCP.
5. Selezionare Crea.

Una volta creato, il server MCP viene visualizzato nella pagina Server MCP.

Visualizza la lista dei server MCP

Visualizzare i server MCP a cui si ha accesso in un compartimento.

1. Aprire il menu di navigazione. In Oracle AI Database, selezionare Base Database Service, quindi Funzionalità AI.
2. Selezionare Visualizza server MCP o selezionare la scheda Server MCP.

La pagina Server MCP visualizza i server MCP a cui si ha accesso, con le informazioni riportate di seguito.

• Nome: il nome del server MCP.
• Stato: stato corrente del server MCP, Attivo o Inattivo.
• Servizi: servizi di database associati al server MCP.
• Creato: data e ora di creazione del server MCP.

Visualizzazione dei dettagli di un server MCP

Visualizzare la configurazione, l'endpoint e altri dettagli di un server MCP.

1. Aprire il menu di navigazione. In Oracle AI Database, selezionare Base Database Service, quindi Funzionalità AI.
2. Selezionare Visualizza server MCP o selezionare la scheda Server MCP.
3. Dall'elenco dei server MCP, utilizzare uno dei metodi seguenti per visualizzare i dettagli di un server MCP:
   • Selezionare il nome del server MCP.
   • Selezionare il menu Azioni (tre punti) per il server MCP, quindi selezionare Visualizza dettagli.

   Nella pagina dei dettagli del server MCP vengono visualizzati l'endpoint e i dettagli di configurazione del server MCP selezionato.

4. Per copiare l'endpoint MCP, selezionare Copia endpoint.
5. Per visualizzare o gestire le tag associate al server MCP, selezionare la scheda Tag.

Abilitazione o disabilitazione del server MCP

Abilitare o disabilitare un server MCP per controllare l'accesso client. La disabilitazione di un server MCP impedisce ai client di accedere al server senza eliminarne la configurazione.

1. Aprire il menu di navigazione. In Oracle AI Database, selezionare Base Database Service, quindi Funzionalità AI.
2. Selezionare la scheda Server MCP.
3. Dall'elenco dei server MCP utilizzare uno dei metodi indicati di seguito.
   • Selezionare il menu Azioni (tre punti) per il server MCP che si desidera abilitare o disabilitare, quindi selezionare Abilita o Disabilita, a seconda dei casi.
   • Selezionare il nome del server MCP per aprire la relativa pagina dei dettagli, quindi selezionare Abilita o Disabilita, a seconda dei casi.
4. Nella finestra di dialogo di conferma, selezionare Abilita o Disabilita per confermare l'azione.

Lo stato del server MCP viene modificato in Attivo o Inattivo, a seconda dell'azione selezionata.

Stati server MCP:

Un server MCP può avere uno degli stati indicati di seguito.

• Attivo: il server MCP è abilitato. I client MCP autenticati e autorizzati possono connettersi all'endpoint del server e utilizzare gli strumenti MCP supportati.
• Inattivo: il server MCP è inattivo. I client MCP non possono accedere all'endpoint del server o utilizzare i relativi strumenti MCP. La configurazione del server viene conservata e può essere nuovamente abilitata.

È possibile abilitare o disabilitare un server MCP senza modificarne la configurazione. Quando si abilita un server MCP inattivo, lo stato viene modificato in Attivo. Quando si disabilita un server MCP attivo, lo stato viene modificato in Inattivo.

Spostare un server MCP in un altro compartimento

Spostare un server MCP dal compartimento corrente in un altro compartimento.

1. Aprire il menu di navigazione. In Oracle AI Database, selezionare Base Database Service, quindi Funzionalità AI.
2. Selezionare la scheda Server MCP.
3. Dall'elenco dei server MCP utilizzare uno dei metodi indicati di seguito.
   • Selezionare il menu Azioni (tre punti) per il server MCP che si desidera spostare, quindi selezionare Sposta risorsa.
   • Selezionare il nome del server MCP per aprire la relativa pagina dei dettagli, selezionare il menu Azioni, quindi selezionare Sposta risorsa.
4. Nella pagina Sposta risorsa selezionare il compartimento di destinazione, quindi selezionare Sposta risorsa.

Il server MCP viene spostato nel compartimento selezionato.

Elimina un server MCP

Eliminare un server MCP dal compartimento corrente.

1. Aprire il menu di navigazione. In Oracle AI Database, selezionare Base Database Service, quindi Funzionalità AI.
2. Selezionare la scheda Server MCP.
3. Dall'elenco dei server MCP utilizzare uno dei metodi indicati di seguito.
   • Selezionare il menu Azioni (tre punti) per il server MCP che si desidera eliminare, quindi selezionare Elimina.
   • Selezionare il nome del server MCP per aprire la relativa pagina dei dettagli, selezionare il menu Azioni, quindi selezionare Elimina.
4. Nella finestra di dialogo di conferma, selezionare Elimina per confermare l'azione.

Il server MCP viene eliminato e non è più disponibile nella pagina Server MCP. I client MCP non possono più accedere al server tramite il relativo endpoint.

Modificare i dati di un server MCP

Modificare un server MCP per aggiornare il nome o i servizi di database associati.

1. Aprire il menu di navigazione. In Oracle AI Database, selezionare Base Database Service, quindi Funzionalità AI.
2. Selezionare la scheda Server MCP.
3. Dall'elenco dei server MCP, selezionare il nome del server MCP per aprire la relativa pagina dei dettagli, selezionare il menu Azioni, quindi selezionare Modifica.
4. Nella pagina Modifica server MCP aggiornare le informazioni riportate di seguito in base alle esigenze.
   • Nome: modificare il nome del server MCP.
   • Servizi: selezionare i servizi di database a cui il server MCP può accedere.
5. Selezionare Aggiorna.