Servidores MCP Gerenciados para Serviços de Banco de Dados do OCI

Os servidores MCP (Managed Model Context Protocol) permitem que agentes e aplicativos de IA compatíveis com MCP acessem informações suportadas sobre os recursos do OCI Database.

Como os Servidores MCP Gerenciados Funcionam

Um servidor MCP gerenciado fornece uma interface entre um cliente compatível com MCP e APIs de plano de controle do OCI Database suportadas.

Ao criar um servidor MCP, você associa o servidor a um domínio de identidades e seleciona as categorias de recursos e serviço de banco de dados aplicáveis. O OCI gera um ponto final MCP e uma configuração de cliente MCP para o servidor. Você pode usar essas informações para configurar um cliente MCP compatível.

Quando você envia uma solicitação de linguagem natural por meio de um agente ou cliente de IA compatível com MCP, o cliente se conecta ao servidor MCP gerenciado usando MCP por HTTP Streamable. O servidor MCP gerenciado autentica o cliente e autoriza o acesso com base nas políticas do OCI Identity and Access Management (IAM). Se a solicitação for autorizada, o servidor MCP chamará a operação do OCI Database suportada aplicável e retornará informações sobre os recursos de banco de dados solicitados ao cliente.

Por exemplo, você pode pedir a um agente de IA compatível com MCP para recuperar informações sobre bancos de dados em um compartimento. O agente pode identificar uma ferramenta MCP apropriada, chamar a ferramenta e usar as informações retornadas pelos Serviços de Banco de Dados do OCI para responder à solicitação.

O uso de um servidor MCP não altera as permissões necessárias para acessar recursos do OCI Database. A identidade autenticada só pode acessar os recursos e as operações permitidos pelas políticas do IAM aplicáveis.

Servidores MCP

Um servidor MCP é um recurso do OCI que fornece um ponto final remoto para clientes compatíveis com MCP.

O OCI Database Services suporta servidores MCP gerenciados para 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. Você pode criar vários servidores MCP em uma tenancy para diferentes serviços de banco de dados.

Uma configuração de servidor MCP inclui informações como o domínio de identidades associado, serviço de banco de dados, categorias de recursos e tags.

O OCI fornece um ponto final MCP exclusivo para cada servidor MCP. O OCI também fornece a configuração MCP JSON que você pode usar para configurar clientes MCP compatíveis.

Você pode ativar ou desativar um servidor MCP. Desativar um servidor MCP impede que os clientes acessem o servidor sem excluir sua configuração. Quando você não precisar mais de um servidor MCP, poderá excluí-lo.

Ferramentas MCP

As ferramentas MCP são operações suportadas do OCI Database que um cliente compatível com MCP pode descobrir e chamar por meio de um servidor MCP.

O servidor MCP disponibiliza as operações suportadas do plano de controle somente leitura como ferramentas MCP. Um agente do AI pode determinar qual ferramenta disponível é apropriada para uma solicitação e chamar essa ferramenta com os parâmetros necessários.

As ferramentas disponíveis através de um servidor MCP dependem do serviço de banco de dados e das categorias de recursos configuradas para o servidor.

As categorias de recursos suportadas podem incluir:

A disponibilidade de uma ferramenta MCP não concede permissão para usar a operação correspondente do OCI Database. As políticas do OCI IAM determinam se a identidade autenticada pode acessar o recurso solicitado.

Configuração de Cliente e Ponto Final do MCP

Cada servidor MCP tem um ponto final MCP que os clientes compatíveis usam para estabelecer conexão com o servidor usando HTTP Streamable.

Depois de criar um servidor MCP, você pode obter o ponto final gerado nos detalhes do servidor MCP. Você também pode obter a configuração MCP JSON necessária para configurar um cliente MCP compatível.

Depois que o cliente é configurado e autenticado, ele pode se conectar ao ponto final e descobrir as ferramentas MCP disponíveis por meio do servidor.

A forma como você adiciona uma configuração de servidor MCP a um cliente depende do cliente MCP que você usa.

Autenticação

Os servidores MCP usam autenticação baseada em OAuth por meio da Identidade do OCI. Ao criar um servidor MCP, você o associa a um domínio de identidades.

Para acessar um servidor MCP, o cliente MCP se autentica com o domínio de identidades associado e obtém um token de acesso OAuth. O cliente usa o token de acesso ao se conectar ao servidor MCP. O servidor MCP valida o token antes de permitir que o cliente acesse as ferramentas MCP suportadas.

Autorização

O OCI IAM controla o acesso aos recursos do OCI Database acessados por meio de um servidor MCP.

As políticas do IAM podem controlar o acesso com base em usuários, grupos, tenancies, compartimentos e outras construções suportadas do OCI IAM. As permissões da identidade autenticada determinam quais recursos a identidade pode acessar por meio das ferramentas do MCP.

Um servidor MCP não fornece permissões adicionais nem ignora as políticas existentes do IAM. Por exemplo, se uma identidade tiver permissão para exibir bancos de dados em um compartimento, mas não em outro, a identidade só poderá recuperar informações para bancos de dados que a identidade está autorizada a exibir. A conexão por meio de um servidor MCP não estende esse acesso a bancos de dados em outros compartimentos.

O acesso por meio de um servidor MCP está, portanto, sujeito à configuração do servidor MCP e às permissões designadas à identidade autenticada.

Operações Somente Leitura

Os servidores MCP gerenciados oferecem suporte a operações aprovadas no plano de controle do OCI Database somente para leitura.

Os agentes de IA compatíveis com MCP podem usar essas operações para recuperar informações suportadas sobre recursos de banco de dados e seu estado operacional. As operações que criam, atualizam ou excluem recursos do OCI Database não estão disponíveis por meio do servidor MCP.

Por exemplo, um agente autorizado pode recuperar informações sobre um banco de dados, uma infraestrutura de banco de dados, um backup ou uma configuração do Data Guard quando uma ferramenta MCP correspondente somente para leitura estiver disponível. O agente não pode usar o servidor MCP para modificar esses recursos.

A restrição somente leitura se aplica a operações expostas por meio do servidor MCP gerenciado e não altera as operações disponíveis por meio de outras interfaces do OCI.

Usando Vários Servidores MCP

Você pode criar vários servidores MCP para oferecer suporte a diferentes requisitos de acesso e configuração.

Por exemplo, você pode configurar servidores MCP separados para diferentes serviços de banco de dados ou expor diferentes categorias de recursos por meio de diferentes servidores. Cada servidor MCP tem sua própria configuração e ponto final.

As permissões da identidade autenticada continuam a ser aplicadas independentemente do servidor MCP que o cliente usa.

Estados do Servidor MCP

Um servidor MCP pode estar ativo, inativo ou excluído.

Orientação de Segurança

Considere o seguinte ao usar servidores MCP gerenciados:

Os servidores MCP gerenciados fornecem outra interface para as operações suportadas do plano de controle do OCI Database. Os limites existentes de autenticação, autorização, tenancy e compartimento do OCI continuam a ser aplicados quando essas operações são acessadas por meio do MCP.

Criar Servidor MCP

Crie um servidor MCP para fornecer aos clientes compatíveis com MCP acesso aos serviços suportados do OCI Database.

Por padrão, o servidor MCP é configurado para todos os serviços de banco de dados suportados. Você pode limitar o servidor a serviços de banco de dados específicos ao criá-lo.

  1. Abra o menu de navegação. Em Oracle AI Database, selecione Base Database Service e, em seguida, Recursos de IA.
  2. Selecione Exibir Servidores MCP ou selecione a guia Servidores MCP.
  3. Selecione Criar servidor MCP.
  4. Especifique as seguintes informações:
    • Nome: informe um nome para o servidor MCP.
    • Compartimento: Selecione o compartimento no qual criar o servidor MCP.
    • Compartimento no Domínio: Selecione o compartimento que contém o domínio de identidades.
    • Domínio: Selecione o domínio de identidades a ser associado ao servidor MCP.
    • Serviços: Selecione os serviços de banco de dados que o servidor MCP pode acessar. Todos os serviços suportados são selecionados por padrão. Para limitar o escopo do serviço, selecione uma ou mais das seguintes opções:
      • 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
    • Tags: Opcionalmente, adicione tags ao servidor MCP.
  5. Selecione Criar.

Depois que o servidor MCP é criado, ele aparece na página Servidores MCP.

Exibir a Lista de Servidores MCP

Exiba os servidores MCP aos quais você tem acesso em um compartimento.

  1. Abra o menu de navegação. Em Oracle AI Database, selecione Base Database Service e, em seguida, Recursos de IA.
  2. Selecione Exibir Servidores MCP ou selecione a guia Servidores MCP.

A página Servidores MCP exibe os servidores MCP aos quais você tem acesso, com as seguintes informações:

Exibir os Detalhes de um Servidor MCP

Exiba a configuração, o ponto final e outros detalhes de um servidor MCP.

  1. Abra o menu de navegação. Em Oracle AI Database, selecione Base Database Service e, em seguida, Recursos de IA.
  2. Selecione Exibir Servidores MCP ou selecione a guia Servidores MCP.
  3. Na lista de servidores MCP, use um dos seguintes métodos para visualizar os detalhes de um servidor MCP:
    • Selecione o nome do servidor MCP.
    • Selecione o menu Ações (três pontos) do servidor MCP e, em seguida, selecione Exibir detalhes.

    A página de detalhes do servidor MCP exibe os detalhes do ponto final e da configuração do servidor MCP selecionado.

  4. Para copiar o ponto final do MCP, selecione Copiar ponto final.
  5. Para exibir ou gerenciar as tags associadas ao servidor MCP, selecione a guia Tags.

Ativa ou Desativa um Servidor MCP

Ative ou desative um servidor MCP para controlar o acesso do cliente. Desativar um servidor MCP impede que os clientes acessem o servidor sem excluir sua configuração.

  1. Abra o menu de navegação. Em Oracle AI Database, selecione Base Database Service e, em seguida, Recursos de IA.
  2. Selecione a guia Servidores MCP.
  3. Na lista de servidores MCP, use um dos seguintes métodos:
    • Selecione o menu Ações (três pontos) do servidor MCP que você deseja ativar ou desativar e, em seguida, selecione Ativar ou Desativar, conforme aplicável.
    • Selecione o nome do servidor MCP para abrir a página de detalhes e, em seguida, selecione Ativar ou Desativar, conforme aplicável.
  4. Na caixa de diálogo de confirmação, selecione Ativar ou Desativar para confirmar a ação.

O estado do servidor MCP é alterado para Ativo ou Inativo, dependendo da ação selecionada.

Estados do Servidor MCP:

Um servidor MCP pode ter um dos seguintes estados:

Você pode ativar ou desativar um servidor MCP sem alterar sua configuração. Quando você ativa um servidor MCP inativo, seu estado muda para Ativo. Quando você desativa um servidor MCP ativo, seu estado muda para Inativo.

Mover um Servidor MCP para Outro Compartimento

Mova um servidor MCP do compartimento atual para outro compartimento.

  1. Abra o menu de navegação. Em Oracle AI Database, selecione Base Database Service e, em seguida, Recursos de IA.
  2. Selecione a guia Servidores MCP.
  3. Na lista de servidores MCP, use um dos seguintes métodos:
    • Selecione o menu Ações (três pontos) do servidor MCP que você deseja mover e, em seguida, selecione Mover recurso.
    • Selecione o nome do servidor MCP para abrir sua página de detalhes, selecione o menu Ações e, em seguida, selecione Mover recurso.
  4. Na página Mover recurso, selecione o compartimento de destino e, em seguida, Mover recurso.

O servidor MCP é movido para o compartimento selecionado.

Excluir um Servidor MCP

Exclua um servidor MCP de seu compartimento atual.

  1. Abra o menu de navegação. Em Oracle AI Database, selecione Base Database Service e, em seguida, Recursos de IA.
  2. Selecione a guia Servidores MCP.
  3. Na lista de servidores MCP, use um dos seguintes métodos:
    • Selecione o menu Ações (três pontos) do servidor MCP que você deseja excluir e, em seguida, selecione Excluir.
    • Selecione o nome do servidor MCP para abrir sua página de detalhes, selecione o menu Ações e, em seguida, selecione Excluir.
  4. Na caixa de diálogo de confirmação, selecione Excluir para confirmar a ação.

O servidor MCP foi excluído e não está mais disponível na página Servidores MCP. Os clientes MCP não podem mais acessar o servidor por meio de seu ponto final.

Editar os Detalhes de um Servidor MCP

Edite um servidor MCP para atualizar seu nome ou serviços de banco de dados associados.

  1. Abra o menu de navegação. Em Oracle AI Database, selecione Base Database Service e, em seguida, Recursos de IA.
  2. Selecione a guia Servidores MCP.
  3. Na lista de servidores MCP, selecione o nome do servidor MCP para abrir sua página de detalhes, selecione o menu Ações e, em seguida, Editar.
  4. Na página Editar servidor MCP, atualize as seguintes informações conforme necessário:
    • Nome: Edite o nome do servidor MCP.
    • Serviços: Selecione os serviços de banco de dados que o servidor MCP pode acessar.
  5. Selecione Atualizar.