模型上下文协议 (MCP) 集成

具有适当访问权限的 MCP 服务器端点。

MCP 服务器的身份验证凭证（如果需要）。有关更多信息，请参阅 准备 MCP 服务器设置和身份验证。

亚马逊快捷企业版订阅。

如果您要连接私有 MCP 服务器，则是可以访问 MCP 服务器的有效的 Amazon Quick VPC 连接。有关更多信息，请参阅 在 Amazon Quick Sight 中配置 VPC 连接。

Conn@@ ector 通过发现但发布失败 Creation failed — 此错误通常意味着 MCP 服务器tools/list响应中的一个或多个工具定义包含无效inputSchema的定义。在发布阶段，Amazon Quick 会inputSchema根据 JSON 架构草稿 7 或更高版本验证每个工具。

最常见的原因是已弃用的 Draft 3 语法，其中required是属性定义中的布尔值（例如"required": true）。在 JSON Schema Draft 7 及更高版本中，required必须是架构根目录下的属性名称数properties组，作为同级。

更新您的工具定义以使用正确的格式并重新部署 MCP 服务器。重新部署后，删除出现故障的连接器并创建一个新的连接器以重新触发发现和发布。

以下示例显示了错误的 Draft 3 语法：

{
  "type": "object",
  "properties": {
    "logNumber": {
      "type": "string",
      "description": "The permit log number",
      "required": true
    }
  }
}

以下示例显示了正确的 Draft 7 语法：

{
  "type": "object",
  "properties": {
    "logNumber": {
      "type": "string",
      "description": "The permit log number"
    }
  },
  "required": ["logNumber"]
}

某些 MCP 框架库和代码生成器默认会发出 Draft 3 语法。请查看您的框架文档，了解选择 JSON 架构输出版本的选项。在部署之前，您还可以使用任何 JSON 架构草案 7 验证器验证您的架构。有关inputSchema要求的更多信息，请参阅模型上下文协议规范中的工具。

您可能还会注意到，连接器创建会暂停两到五分钟，然后才会失败。经过的时间反映的是发布阶段的内部重试次数，而不是网络超时。修复方法是一样的：检查您的工具inputSchema定义是否符合 JSON 架构草案 7。

VPC 连接未在连接类型下拉列表中列出，或者 MCP 创建在您选择后立即失败 — 在配置完成之前，VPC 连接可能会出现在下拉列表中。等待 VPC 连接在 Amazon Quick 管理页面上显示为可用，然后再针对该连接创建 MCP 集成。有关更多信息，请参阅 在 Amazon Quick Sight 中配置 VPC 连接。

由于无法解析 MCP 服务器主机名，MCP 创建失败 — Amazon Quick 不使用默认 VPC DNS 解析器进行 MCP 集成。您必须使用可以解析您的 MCP 服务器主机名的 Route 53 解析器入站终端节点 IP 地址填充 VPC 连接上的 DNS 解析器终端节点 IP 地址。此要求既适用于私有主机名，也适用于您要从 VPC 内部解析为私有地址的公用主机名，例如前面的 Route 53 私有托管区域 AWS PrivateLink 或 Route 53 私有托管区域的终端节点。如果没有这些解析器端点，则无法解析 MCP 服务器主机名，集成创建失败。有关更多信息，请参阅 在 Amazon Quick Sight 中配置 VPC 连接。

无法通过 VPC 连接访问 MCP 服务器 — 从 Amazon Quick 到您的 MCP 服务器的流量来自您在 VPC 连接设置期间选择的子网。确认路由表、网络 ACL 和安全组允许这些子网与 MCP 服务器端点之间的流量。有关 VPC 联网的一般指南，请参阅在 Amazon Quick Sight 中配置 VPC 连接。

使用私有 MCP 服务器时身份验证失败 — 当您通过 VPC 连接连接到私有 MCP 服务器时，MCP 服务器使用的 OAuth 终端节点必须仍然可以通过公共互联网访问。这适用于用户身份验证（授权和令牌端点）和服务身份验证（令牌端点）。不支持私有 OAuth 提供商。确认您的 MCP 服务器在其受保护的资源元数据中返回的 OAuth 网址是否通过公共互联网解析。

AADSTS9010010— v2.0 终端节点拒绝资源参数 — Amazon Quick 按照 MCP 规范 (RFC 8707) 的要求在 OAuth 请求上发送resource参数。Entra ID v2.0 端点拒绝同时包含resource参数和值的请求。scope要解决此错误，请将您的应用程序注册配置为使用 Entra ID v1.0 OAuth 端点，并在应用程序清单2中accessTokenAcceptedVersion将其设置为。

AADSTS90009— 应用程序为自己请求令牌 — 当您使用用户身份验证（授权码流）且 OAuth 客户端和 MCP 资源解析到同一 Entra ID 应用程序时，Entra ID 会阻止该请求。创建两个单独的应用程序注册：一个用于 Amazon Quick 的客户端应用程序和一个用于 MCP 服务器的资源应用程序。此问题不会影响服务身份验证（客户端凭据流），在这种身份验证中，单个应用程序注册可以正常工作。

MCP 操作有 60 秒的固定超时时间。超过此限制的操作会自动失败，并出现 HTTP 424 错误。

对于通过 VPC 连接访问的 MCP 服务器，MCP 服务器使用的 OAuth 终端节点必须可通过公共互联网访问。这适用于用户身份验证和服务身份验证。不支持私有 OAuth 提供商。

MCP 操作不支持自定义 HTTP 标头。仅传输标准系统标头。

初始注册后，工具列表保持静态。要获取服务器端工具的更改，必须删除集成并重新创建。

如果第三方提供商未将 Amazon Quick 回调 URI 列入允许名单，则连接器创建可能会失败。

服务器连接问题导致无需重试即可立即失败。

Step-up 不支持授权。如果 MCP 服务器在初始授权（使用 HTTP 403insufficient_scope）后需要其他范围，则必须重新授权整个连接。增量权限升级不可用。

范围处理有以下限制：

自动客户端注册仅支持动态客户机注册 (DCR)。不支持客户端 ID 元数据文档。

Well-known URI 发现仅使用服务器根路径。 Path-specific 不支持元数据位置（路径插入发现）。此限制可能会阻止发现仅在路径特定的 URI 上提供元数据的服务器。