Servidores MCP gestionados para servicios de OCI Database

Los servidores del protocolo de contexto de modelo gestionado (MCP) permiten a los agentes y aplicaciones de IA compatibles con MCP acceder a la información soportada sobre los recursos de OCI Database.

Funcionamiento de los servidores MCP gestionados

Un servidor MCP gestionado proporciona una interfaz entre un cliente compatible con MCP y las API de plano de control de OCI Database soportadas.

Al crear un servidor MCP, se asocia el servidor a un dominio de identidad y se seleccionan las categorías de recursos y servicios de base de datos aplicables. OCI genera un punto final de MCP y una configuración de cliente de MCP para el servidor. Puede usar esta información para configurar un cliente MCP compatible.

Cuando envía una solicitud en lenguaje natural a través de un cliente o agente de AI compatible con MCP, el cliente se conecta al servidor MCP gestionado mediante MCP a través de HTTP Streamable. El servidor MCP gestionado autentica el cliente y autoriza el acceso según las políticas de OCI Identity and Access Management (IAM). Si la solicitud está autorizada, el servidor MCP llama a la operación de base de datos de OCI soportada aplicable y devuelve información sobre los recursos de base de datos solicitados al cliente.

Por ejemplo, puede solicitar a un agente de AI compatible con MCP que recupere información sobre las bases de datos de un compartimento. El agente puede identificar una herramienta MCP adecuada, llamar a la herramienta y utilizar la información devuelta por OCI Database Services para responder a la solicitud.

El uso de un servidor MCP no cambia los permisos necesarios para acceder a los recursos de OCI Database. La identidad autenticada solo puede acceder a los recursos y las operaciones permitidos por las políticas de IAM aplicables.

Servidores MCP

Un servidor MCP es un recurso de OCI que proporciona un punto final remoto para clientes compatibles con MCP.

OCI Database Services soporta servidores MCP gestionados para Oracle Base Database Service, Oracle Exadata Database Service on Cloud@Customer, Oracle Exadata Database Service on Dedicated Infrastructure y Oracle Exadata Database Service on Exascale Infrastructure. Puede crear varios servidores MCP en un arrendamiento para diferentes servicios de base de datos.

Una configuración de servidor MCP incluye información como el dominio de identidad asociado, el servicio de base de datos, las categorías de recursos y las etiquetas.

OCI proporciona un punto final MCP único para cada servidor MCP. OCI también proporciona la configuración de JSON de MCP que puede utilizar para configurar clientes MCP compatibles.

Puede activar o desactivar un servidor MCP. La desactivación de un servidor MCP impide que los clientes accedan al servidor sin suprimir su configuración. Si ya no necesita un servidor MCP, puede suprimirlo.

Herramientas de MCP

Las herramientas de MCP son operaciones de base de datos de OCI soportadas que un cliente compatible con MCP puede detectar y llamar a través de un servidor MCP.

El servidor MCP hace que las operaciones de plano de control de solo lectura soportadas estén disponibles como herramientas MCP. Un agente de AI puede determinar qué herramienta disponible es adecuada para una solicitud y llamar a esa herramienta con los parámetros necesarios.

Las herramientas disponibles a través de un servidor MCP dependen del servicio de base de datos y las categorías de recursos configurados para el servidor.

Las categorías de recursos soportadas pueden incluir:

• Infraestructura de base de datos
• Máquinas virtuales
• Copias de seguridad de base de datos
• Data Guard
• Metadatos operativos de la base de datos relacionada

La disponibilidad de una herramienta MCP no otorga permiso para utilizar la operación de base de datos de OCI correspondiente. Las políticas de OCI IAM determinan si la identidad autenticada puede acceder al recurso solicitado.

Configuración de cliente y punto final de MCP

Cada servidor MCP tiene un punto final MCP que los clientes compatibles utilizan para conectarse al servidor mediante HTTP Streamable.

Después de crear un servidor MCP, puede obtener el punto final generado a partir de los detalles del servidor MCP. También puede obtener la configuración de JSON de MCP necesaria para configurar un cliente MCP compatible.

Después de configurar y autenticar el cliente, puede conectarse al punto final y detectar las herramientas MCP disponibles a través del servidor.

La forma en que se agrega una configuración de servidor MCP a un cliente depende del cliente MCP que se utilice.

Autenticación

Los servidores MCP utilizan la autenticación basada en OAuth a través de OCI Identity. Cuando crea un servidor MCP, lo asocia a un dominio de identidad.

Para acceder a un servidor MCP, el cliente MCP se autentica con el dominio de identidad asociado y obtiene un token de acceso OAuth. El cliente utiliza el token de acceso al conectarse al servidor MCP. El servidor MCP valida el token antes de permitir que el cliente acceda a las herramientas MCP admitidas.

Autorización

OCI IAM controla el acceso a los recursos de OCI Database a los que se accede a través de un servidor MCP.

Las políticas de IAM pueden controlar el acceso en función de los usuarios, los grupos, los arrendamientos, los compartimentos y otras construcciones de OCI IAM soportadas. Los permisos de la identidad autenticada determinan a qué recursos puede acceder la identidad mediante las herramientas de MCP.

Un servidor MCP no proporciona permisos adicionales ni omite las políticas de IAM existentes. Por ejemplo, si una identidad tiene permiso para ver bases de datos en un compartimento pero no en otro, la identidad puede recuperar información solo para bases de datos para las que la identidad está autorizada a ver. La conexión a través de un servidor MCP no amplía ese acceso a las bases de datos de otros compartimentos.

Por lo tanto, el acceso a través de un servidor MCP está sujeto a la configuración del servidor MCP y a los permisos asignados a la identidad autenticada.

Operaciones de solo lectura

Los servidores MCP gestionados admiten operaciones de plano de control de OCI Database de solo lectura aprobadas.

Los agentes de IA compatibles con MCP pueden utilizar estas operaciones para recuperar la información admitida sobre los recursos de la base de datos y su estado operativo. Las operaciones que crean, actualizan o suprimen recursos de OCI Database no están disponibles a través del servidor MCP.

Por ejemplo, un agente autorizado puede recuperar información sobre una configuración de base de datos, infraestructura de base de datos, copia de seguridad o Data Guard cuando hay disponible una herramienta MCP de solo lectura correspondiente. El agente no puede utilizar el servidor MCP para modificar esos recursos.

La restricción de solo lectura se aplica a las operaciones expuestas a través del servidor MCP gestionado y no cambia las operaciones disponibles a través de otras interfaces de OCI.

Uso de varios servidores MCP

Puede crear varios servidores MCP para admitir diferentes requisitos de acceso y configuración.

Por ejemplo, puede configurar servidores MCP independientes para diferentes servicios de base de datos o exponer diferentes categorías de recursos a través de diferentes servidores. Cada servidor MCP tiene su propia configuración y punto final.

Los permisos de la identidad autenticada siguen aplicándose independientemente del servidor MCP que utiliza el cliente.

Estados del servidor MCP

Un servidor MCP puede estar activo, inactivo o suprimido.

• Cuando un servidor MCP está activado, los clientes pueden conectarse al punto final de MCP y utilizar las herramientas de MCP soportadas, sujetas a autenticación y autorización.
• Cuando un servidor MCP está inactivo, los clientes no pueden conectarse al punto final de MCP ni utilizar las herramientas de MCP soportadas. Se conserva la configuración del servidor MCP y puede volver a activar el servidor cuando se requiera acceso.
• Cuando se suprime un servidor MCP, los clientes ya no pueden conectarse al punto final de MCP ni utilizar las herramientas de MCP soportadas, y la configuración del servidor MCP se elimina permanentemente.

Orientación sobre seguridad

Tenga en cuenta lo siguiente al utilizar servidores MCP gestionados:

• Utilice políticas de IAM para otorgar solo los permisos necesarios para los usuarios y grupos que acceden a los recursos de OCI Database a través de MCP.
• Utilice servidores MCP independientes cuando diferentes servicios o requisitos organizativos requieran diferentes configuraciones.
• Desactive un servidor MCP cuando no se requiera temporalmente acceso MCP.
• Suprima los servidores MCP que ya no sean necesarios.
• Revise los permisos asignados a las identidades que utilizan clientes compatibles con MCP.

Los servidores MCP gestionados proporcionan otra interfaz para las operaciones de plano de control de OCI Database soportadas. Los límites existentes de autenticación, autorización, arrendamiento y compartimento de OCI siguen aplicándose cuando se accede a esas operaciones a través de MCP.

Crear Servidor MCP

Cree un servidor MCP para proporcionar a los clientes compatibles con MCP acceso a los servicios de base de datos de OCI soportados.

Por defecto, el servidor MCP está configurado para todos los servicios de base de datos soportados. Puede limitar el servidor a servicios de base de datos específicos al crearlo.

1. Abra el menú de navegación. En Oracle AI Database, seleccione Base Database Service y, a continuación, seleccione AI Capabilities.
2. Seleccione View MCP Servers (Ver servidores MCP) o seleccione el separador MCP Servers (Servidores MCP).
3. Seleccione Create MCP server.
4. Especifique la siguiente información:
   • Nombre: introduzca un nombre para el servidor MCP.
   • Compartimento: seleccione el compartimento en la que desea crear el servidor MCP.
   • Compartimento en dominio: seleccione el compartimento que contiene el dominio de identidad.
   • Dominio: seleccione el dominio de identidad que desea asociar al servidor MCP.
   • Servicios: seleccione los servicios de base de datos a los que puede acceder el servidor MCP. Todos los servicios soportados están seleccionados de forma predeterminada. Para limitar el ámbito de servicio, seleccione una o más de las siguientes opciones:
     • Oracle Base Database Service
     • Oracle Exadata Database Service en Cloud at Customer
     • Oracle Exadata Database Service on Dedicated Infrastructure
     • Oracle Exadata Database Service on Exascale Infrastructure
   • Etiquetas: opcionalmente, agregue etiquetas al servidor MCP.
5. Seleccione Crear.

Después de crear el servidor MCP, aparece en la página Servidores MCP.

Visualización de la lista de servidores de MCP

Visualice los servidores MCP a los que tiene acceso en un compartimento.

1. Abra el menú de navegación. En Oracle AI Database, seleccione Base Database Service y, a continuación, seleccione AI Capabilities.
2. Seleccione View MCP Servers (Ver servidores MCP) o seleccione el separador MCP Servers (Servidores MCP).

La página Servidores MCP muestra los servidores MCP a los que tiene acceso, con la siguiente información:

• Nombre: nombre del servidor MCP.
• State (Estado): estado actual del servidor MCP, activo o inactivo.
• Servicios: servicios de base de datos asociados al servidor MCP.
• Creado: fecha y hora en que se creó el servidor MCP.

Visualización de los detalles de un servidor MCP

Ver la configuración, el punto final y otros detalles de un servidor MCP.

1. Abra el menú de navegación. En Oracle AI Database, seleccione Base Database Service y, a continuación, seleccione AI Capabilities.
2. Seleccione View MCP Servers (Ver servidores MCP) o seleccione el separador MCP Servers (Servidores MCP).
3. En la lista de servidores MCP, utilice uno de los siguientes métodos para ver los detalles de un servidor MCP:
   • Seleccione el nombre del servidor MCP.
   • Seleccione el menú Acciones (tres puntos) para el servidor MCP y, a continuación, seleccione Ver detalles.

   La página de detalles del servidor MCP muestra los detalles de punto final y configuración del servidor MCP seleccionado.

4. Para copiar el punto final de MCP, seleccione Copiar punto final.
5. Para ver o gestionar las etiquetas asociadas al servidor MCP, seleccione el separador Etiquetas.

Activación o desactivación de un servidor MCP

Active o desactive un servidor MCP para controlar el acceso del cliente. La desactivación de un servidor MCP impide que los clientes accedan al servidor sin suprimir su configuración.

1. Abra el menú de navegación. En Oracle AI Database, seleccione Base Database Service y, a continuación, seleccione AI Capabilities.
2. Seleccione el separador Servidores de MCP.
3. En la lista de servidores MCP, utilice uno de los siguientes métodos:
   • Seleccione el menú Acciones (tres puntos) para el servidor MCP que desea activar o desactivar y, a continuación, seleccione Activar o Desactivar, según corresponda.
   • Seleccione el nombre del servidor MCP para abrir su página de detalles y, a continuación, seleccione Activar o Desactivar, según corresponda.
4. En el cuadro de diálogo de confirmación, seleccione Activar o Desactivar para confirmar la acción.

El estado del servidor MCP cambia a Active (Activo) o Inactive (Inactivo), según la acción seleccionada.

Estados del servidor MCP:

Un servidor MCP puede tener uno de los siguientes estados:

• Activo: el servidor MCP está activado. Los clientes MCP autenticados y autorizados pueden conectarse al punto final del servidor y utilizar las herramientas MCP soportadas.
• Inactivo: el servidor MCP está inactivo. Los clientes MCP no pueden acceder al punto final del servidor ni utilizar sus herramientas MCP. La configuración del servidor se conserva y se puede volver a activar.

Puede activar o desactivar un servidor MCP sin cambiar su configuración. Cuando activa un servidor MCP inactivo, su estado cambia a Active (Activo). Cuando desactiva un servidor MCP activo, su estado cambia a Inactivo.

Traslado de un servidor MCP a otro compartimento

Mover un servidor MCP de su compartimento actual a otro compartimento.

1. Abra el menú de navegación. En Oracle AI Database, seleccione Base Database Service y, a continuación, seleccione AI Capabilities.
2. Seleccione el separador Servidores de MCP.
3. En la lista de servidores MCP, utilice uno de los siguientes métodos:
   • Seleccione el menú Acciones (tres puntos) para el servidor MCP que desea mover y, a continuación, seleccione Mover recurso.
   • Seleccione el nombre del servidor MCP para abrir su página de detalles, seleccione el menú Acciones y, a continuación, seleccione Mover recurso.
4. En la página Mover recurso, seleccione el compartimento de destino y, a continuación, seleccione Mover recurso.

El servidor MCP se mueve al compartimento seleccionado.

Supresión de un servidor MCP

Suprima un servidor MCP de su compartimento actual.

1. Abra el menú de navegación. En Oracle AI Database, seleccione Base Database Service y, a continuación, seleccione AI Capabilities.
2. Seleccione el separador Servidores de MCP.
3. En la lista de servidores MCP, utilice uno de los siguientes métodos:
   • Seleccione el menú Acciones (tres puntos) para el servidor MCP que desea suprimir y, a continuación, seleccione Suprimir.
   • Seleccione el nombre del servidor MCP para abrir su página de detalles, seleccione el menú Acciones y, a continuación, seleccione Suprimir.
4. En el cuadro de diálogo de confirmación, seleccione Suprimir para confirmar la acción.

El servidor MCP se suprime y ya no está disponible en la página Servidores MCP. Los clientes MCP ya no pueden acceder al servidor a través de su punto final.

Edición de los detalles de un servidor MCP

Edite un servidor MCP para actualizar su nombre o los servicios de base de datos asociados.

1. Abra el menú de navegación. En Oracle AI Database, seleccione Base Database Service y, a continuación, seleccione AI Capabilities.
2. Seleccione el separador Servidores de MCP.
3. En la lista de servidores MCP, seleccione el nombre del servidor MCP para abrir su página de detalles, seleccione el menú Acciones y, a continuación, seleccione Editar.
4. En la página Editar servidor MCP, actualice la siguiente información según sea necesario:
   • Nombre: edite el nombre del servidor MCP.
   • Servicios: seleccione los servicios de base de datos a los que puede acceder el servidor MCP.
5. Seleccione Actualizar.