适用于 OCI 数据库服务的托管 MCP 服务器

通过托管模型上下文协议 (MCP) 服务器，与 MCP 兼容的 AI 代理和应用可以访问有关 OCI 数据库资源的支持信息。

托管 MCP 服务器的工作方式

托管 MCP 服务器提供与 MCP 兼容的客户端和支持的 OCI 数据库控制层 API 之间的接口。

创建 MCP 服务器时，将服务器与身份域关联，并选择适用的数据库服务和资源类别。OCI 为服务器生成 MCP 端点和 MCP 客户端配置。您可以使用此信息配置兼容的 MCP 客户机。

通过与 MCP 兼容的 AI 代理或客户机提交自然语言请求时，客户机通过使用基于流式 HTTP 的 MCP 连接到受管 MCP 服务器。托管 MCP 服务器根据 OCI Identity and Access Management (IAM) 策略验证客户端并授权访问。如果请求已获授权，MCP 服务器将调用适用的受支持 OCI 数据库操作，并向客户机返回有关所请求数据库资源的信息。

例如，您可以要求与 MCP 兼容的 AI 代理检索有关区间中数据库的信息。座席可以识别适当的 MCP 工具，调用该工具，并使用 OCI Database Services 返回的信息来响应请求。

使用 MCP 服务器不会更改访问 OCI 数据库资源所需的权限。经过验证的身份只能访问适用 IAM 策略允许的资源和操作。

MCP 服务器

MCP 服务器是 OCI 资源，为与 MCP 兼容的客户端提供远程端点。

OCI Database Services 支持托管 MCP 服务器，适用于 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。您可以在一个租户中为不同的数据库服务创建多个 MCP 服务器。

MCP 服务器配置包括相关身份域、数据库服务、资源类别和标记等信息。

OCI 为每个 MCP 服务器提供唯一的 MCP 端点。OCI 还提供了 MCP JSON 配置，您可以使用这些配置来配置兼容的 MCP 客户端。

可以启用或禁用 MCP 服务器。禁用 MCP 服务器可防止客户机在不删除其配置的情况下访问服务器。当不再需要 MCP 服务器时，可以将其删除。

MCP 工具

MCP 工具支持与 MCP 兼容的客户机通过 MCP 服务器搜索和调用的 OCI 数据库操作。

MCP 服务器使支持的只读控制层操作可用作 MCP 工具。AI 代理可以确定哪个可用工具适合请求，并使用所需的参数调用该工具。

通过 MCP 服务器提供的工具取决于为服务器配置的数据库服务和资源类别。

支持的资源类别可以包括：

数据库基础结构
虚拟机
数据库备份
Data Guard
相关数据库操作元数据

MCP 工具的可用性未授予使用相应 OCI 数据库操作的权限。OCI IAM 策略确定已验证身份是否可以访问请求的资源。

MCP 端点和客户机配置

每个 MCP 服务器都有一个 MCP 端点，兼容的客户机使用流式 HTTP 连接到服务器。

创建 MCP 服务器后，您可以从 MCP 服务器详细信息中获取生成的端点。您还可以获取配置兼容 MCP 客户机所需的 MCP JSON 配置。

配置和验证客户机后，客户机可以连接到端点并搜索通过服务器提供的 MCP 工具。

将 MCP 服务器配置添加到客户机的方式取决于您使用的 MCP 客户机。

验证

MCP 服务器通过 OCI Identity 使用基于 OAuth 的身份验证。创建 MCP 服务器时，将其与身份域关联。

要访问 MCP 服务器，MCP 客户机将通过关联的身份域进行验证并获取 OAuth 访问令牌。客户机在连接到 MCP 服务器时使用访问令牌。MCP 服务器先验证令牌，然后再允许客户机访问支持的 MCP 工具。

授权

OCI IAM 控制对通过 MCP 服务器访问的 OCI 数据库资源的访问。

IAM 策略可以根据用户、组、租户、区间以及其他受支持的 OCI IAM 结构来控制访问。已验证身份的权限决定身份可以通过 MCP 工具访问哪些资源。

MCP 服务器不提供其他权限或绕过现有的 IAM 策略。例如，如果某个身份有权查看一个区间（而不是另一个区间）中的数据库，则该身份只能检索该身份有权查看的数据库的信息。通过 MCP 服务器进行连接不会将这种访问扩展到其他区间中的数据库。

因此，通过 MCP 服务器的访问受 MCP 服务器配置和分配给已验证身份的权限的约束。

只读操作

托管 MCP 服务器支持批准的只读 OCI 数据库控制层操作。

与 MCP 兼容的 AI 代理可以使用这些操作来检索有关数据库资源及其运行状态的受支持信息。创建、更新或删除 OCI 数据库资源的操作无法通过 MCP 服务器使用。

例如，当相应的只读 MCP 工具可用时，授权代理可以检索有关数据库、数据库基础结构、备份或 Data Guard 配置的信息。代理无法使用 MCP 服务器修改这些资源。

只读限制适用于通过托管 MCP 服务器公开的操作，并且不会更改通过其他 OCI 接口提供的操作。

使用多个 MCP 服务器

可以创建多个 MCP 服务器来支持不同的访问和配置要求。

例如，您可以为不同的数据库服务配置单独的 MCP 服务器，或者通过不同的服务器公开不同的资源类别。每个 MCP 服务器都有自己的配置和端点。

已验证身份的权限继续独立于客户机使用的 MCP 服务器应用。

MCP 服务器状态

MCP 服务器可以处于活动状态、不活动状态或删除状态。

启用 MCP 服务器后，客户机可以连接到 MCP 端点并使用支持的 MCP 工具，但需要进行验证和授权。
当 MCP 服务器处于非活动状态时，客户机无法连接到 MCP 端点或使用支持的 MCP 工具。MCP 服务器配置会保留，您可以在需要访问时再次启用该服务器。
删除 MCP 服务器后，客户机将无法再连接到 MCP 端点或使用支持的 MCP 工具，并且 MCP 服务器配置将被永久删除。

安全指导

使用托管 MCP 服务器时，请考虑以下事项：

使用 IAM 策略仅授予通过 MCP 访问 OCI 数据库资源的用户和组所需的权限。
当不同的服务或组织要求需要不同的配置时，请使用单独的 MCP 服务器。
暂时不需要 MCP 访问时禁用 MCP 服务器。
删除不再需要的 MCP 服务器。
查看分配给使用 MCP 兼容客户机的身份的权限。

托管 MCP 服务器为支持的 OCI 数据库控制层操作提供了另一个接口。通过 MCP 访问现有 OCI 验证、授权、租户和区间边界时，将继续应用这些操作。

创建 MCP Server

创建 MCP 服务器以向与 MCP 兼容的客户端提供对支持的 OCI 数据库服务的访问权限。

默认情况下，会为所有支持的数据库服务配置 MCP 服务器。创建服务器时，可以将服务器限制为特定的数据库服务。

打开导航菜单。在 Oracle AI Database 下，选择 Base Database Service ，然后选择 AI Capabilities 。
选择 View MCP Servers 或选择 MCP Servers 选项卡。
选择 Create MCP server（创建 MCP 服务器）。
请指定以下信息：
- 名称：输入 MCP 服务器的名称。
- 区间：选择要创建 MCP 服务器的区间。
- 域中的区间：选择包含身份域的区间。
- 域：选择要与 MCP 服务器关联的身份域。
- 服务：选择 MCP 服务器可以访问的数据库服务。默认情况下，将选择所有受支持的服务。要限制服务范围，请选择以下一项或多项：
  - Oracle Base Database Service
  - Cloud@Customer 上的 Oracle Exadata Database Service
  - 专用基础结构上的 Oracle Exadata Database Service
  - Oracle Exadata Database Service on Exascale Infrastructure
- 标记：（可选）向 MCP 服务器添加标记。
选择创建。

创建 MCP 服务器后，它将显示在 "MCP Servers"（MCP 服务器）页面上。

查看 MCP 服务器列表

查看您有权在区间中访问的 MCP 服务器。

打开导航菜单。在 Oracle AI Database 下，选择 Base Database Service ，然后选择 AI Capabilities 。
选择 View MCP Servers 或选择 MCP Servers 选项卡。

"MCP Servers"（MCP 服务器）页面显示您有权访问的 MCP 服务器，并包含以下信息：

名称：MCP 服务器的名称。
State（状态）：MCP 服务器的当前状态（活动或非活动）。
服务：与 MCP 服务器关联的数据库服务。
Created（创建）：创建 MCP 服务器的日期和时间。

查看 MCP 服务器的详细信息

查看 MCP 服务器的配置、端点和其他详细信息。

打开导航菜单。在 Oracle AI Database 下，选择 Base Database Service ，然后选择 AI Capabilities 。
选择 View MCP Servers 或选择 MCP Servers 选项卡。
从 MCP 服务器列表中，使用以下方法之一查看 MCP 服务器的详细信息：
- 选择 MCP 服务器的名称。
- 选择 MCP 服务器的操作菜单（三个点），然后选择查看详细信息。
"MCP server details"（MCP 服务器详细信息）页面显示所选 MCP 服务器的端点和配置详细信息。
要复制 MCP 端点，请选择复制端点。
要查看或管理与 MCP 服务器关联的标记，请选择标记选项卡。

启用或禁用 MCP 服务器

启用或禁用 MCP 服务器以控制客户机访问。禁用 MCP 服务器可防止客户机在不删除其配置的情况下访问服务器。

打开导航菜单。在 Oracle AI Database 下，选择 Base Database Service ，然后选择 AI Capabilities 。
选择 MCP 服务器选项卡。
从 MCP 服务器列表中，使用以下方法之一：
- 选择要启用或禁用的 MCP 服务器的 Actions（操作）菜单（三个点），然后选择 Enable（启用）或 Disable（禁用）。
- 选择 MCP 服务器的名称以打开其详细信息页，然后选择启用或禁用（如果适用）。
在确认对话框中，选择 Enable 或 Disable 以确认操作。

MCP 服务器的状态将更改为 Active 或 Inactive ，具体取决于所选操作。

MCP Server States（MCP 服务器状态）：

MCP 服务器可以具有以下状态之一：

活动：MCP 服务器已启用。经过验证和授权的 MCP 客户机可以连接到服务器端点并使用支持的 MCP 工具。
不活动：MCP 服务器处于不活动状态。MCP 客户机无法访问服务器端点或使用其 MCP 工具。服务器配置将保留，可以再次启用。

您可以启用或禁用 MCP 服务器，而无需更改其配置。启用非活动 MCP 服务器时，其状态将更改为 Active 。禁用活动的 MCP 服务器时，其状态将更改为 Inactive 。

将 MCP 服务器移至其他区间

将 MCP 服务器从当前区间移至其他区间。

打开导航菜单。在 Oracle AI Database 下，选择 Base Database Service ，然后选择 AI Capabilities 。
选择 MCP 服务器选项卡。
从 MCP 服务器列表中，使用以下方法之一：
- 选择要移动的 MCP 服务器的 Actions（操作）菜单（三个点），然后选择 Move resource（移动资源）。
- 选择 MCP 服务器的名称以打开其详细信息页，选择操作菜单，然后选择移动资源。
在“移动资源”页上，选择目标区间，然后选择移动资源。

MCP 服务器将移至所选区间。

删除 MCP 服务器

从 MCP 服务器的当前区间中删除该服务器。

打开导航菜单。在 Oracle AI Database 下，选择 Base Database Service ，然后选择 AI Capabilities 。
选择 MCP 服务器选项卡。
从 MCP 服务器列表中，使用以下方法之一：
- 为要删除的 MCP 服务器选择操作菜单（三个点），然后选择删除。
- 选择 MCP 服务器的名称以打开其详细信息页，选择操作菜单，然后选择删除。
在确认对话框中，选择删除以确认操作。

MCP 服务器已删除，在 "MCP Servers"（MCP 服务器）页面上不再可用。MCP 客户机无法再通过其端点访问服务器。

编辑 MCP 服务器的详细信息

编辑 MCP 服务器以更新其名称或关联的数据库服务。

打开导航菜单。在 Oracle AI Database 下，选择 Base Database Service ，然后选择 AI Capabilities 。
选择 MCP 服务器选项卡。
从 MCP 服务器列表中，选择 MCP 服务器的名称以打开其详细信息页，选择操作菜单，然后选择编辑。
在 "Edit MCP server"（编辑 MCP 服务器）页面上，根据需要更新以下信息：
- 名称：编辑 MCP 服务器的名称。
- 服务：选择 MCP 服务器可以访问的数据库服务。
选择更新。