Documentazione dell'infrastruttura Oracle Cloud

Prerequisiti per il server MCP

Per utilizzare client AI compatibili con MCP con Autonomous AI Database tramite endpoint MCP, uno sviluppatore deve garantire quanto segue: la versione corretta del database, i privilegi, le credenziali di autenticazione, i controlli di rete e sicurezza e la disponibilità della registrazione degli strumenti.

Database e versione supportati

MCP Server è supportato su Autonomous AI Database 26ai e 19c. Per ulteriori dettagli, vedere Informazioni sul server MCP.

Client MCP supportati

È necessario utilizzare le applicazioni agente AI che supportano MCP remoto su trasporto streamable-http e autenticazione basata su token OAuth 2.1. Ciò consente alle applicazioni client di interagire con gli strumenti MCP. Il server MCP utilizza HTTP in streaming con SSE come canale di trasporto. Le applicazioni client possono connettersi al server MCP utilizzando le credenziali del database o il token bearer (i server MCP supportano l'autenticazione basata su OAuth o OIDC e token) in modo che possano vedere gli strumenti disponibili. Per ulteriori dettagli, vedere Configura server MCP nell'applicazione agente AI.

Vedere:

Privilegi per abilitare il server MCP

È necessario disporre dell'autorizzazione OCI per aggiornare Autonomous AI Database e aggiungere la tag in formato libero necessaria per abilitare il server MCP.

Autenticazione e autorizzazione

Utilizzare le credenziali del database per l'autenticazione in modo che i client AI possano identificarti e accedere in modo sicuro al server MCP. Il server MCP di Autonomous AI Database supporta client MCP che utilizzano OAuth 2.1 e l'autenticazione basata su token.

Per i client MCP che supportano il token bearer, è possibile generare un token bearer per il database utilizzando un'API. È quindi possibile aggiungerlo nella configurazione del server MCP. Per ulteriori dettagli, vedere Configura server MCP nell'applicazione agente AI.

Strumenti personalizzati

È necessario disporre di strumenti personalizzati registrati correttamente in modo che i client MCP possano elencarli e chiamarli con i ruoli appropriati e l'accesso con meno privilegi. Solo gli utenti di database con privilegi possono registrare gli strumenti. È possibile creare strumenti personalizzati utilizzando la procedura DBMS_CLOUD_AI_AGENT.CREATE_TOOL. Per ulteriori dettagli, vedere Esempio: creazione di strumenti agente AI Select e CREATE_TOOL Procedure.