模型內容通訊協定 (MCP) 整合

具有適當存取權的 MCP 伺服器端點。

如有需要，MCP 伺服器的身分驗證憑證。如需詳細資訊，請參閱準備 MCP 伺服器設定和身分驗證。

Amazon Quick Enterprise 訂閱。

如果您要連線至私有 MCP 伺服器，則為具有 MCP 伺服器網路存取權的作用中 Amazon Quick VPC 連線。如需詳細資訊，請參閱在 Amazon Quick Sight 中設定 VPC 連線。

連接器通過探索，但在發佈時失敗 Creation failed – 此錯誤通常表示 MCP 伺服器tools/list回應中的一或多個工具定義包含無效的 inputSchema。在發佈階段，Amazon Quick inputSchema會根據 JSON 結構描述草稿 7 或更新版本驗證每個工具的 。

最常見的原因是已棄用的草稿 3 語法，其中 required是屬性定義內的布林值 （例如 "required": true)。在 JSON 結構描述草稿 7 和更新版本中， required 必須是結構描述根目錄的屬性名稱陣列，作為 的同級。 properties

更新您的工具定義，以使用正確的格式並重新部署 MCP 伺服器。重新部署後，請刪除故障的連接器，並建立新的連接器，以重新觸發探索和發佈。

下列範例顯示不正確的草稿 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 admin 頁面上顯示為可用，再針對它建立 MCP 整合。如需詳細資訊，請參閱在 Amazon Quick Sight 中設定 VPC 連線。

MCP 建立失敗，因為無法解析 MCP 伺服器主機名稱 – Amazon Quick 不會使用預設 VPC DNS 解析程式進行 MCP 整合。您必須使用 Route 53 Resolver 可解析 MCP 伺服器主機名稱的傳入端點 IP 地址，在 VPC 連線上填入 DNS 解析程式端點欄位。此要求同時適用於私有主機名稱，以及您想要從 VPC 解析為私有地址的公有主機名稱，例如由 AWS PrivateLink 或 Route 53 私有託管區域的端點。如果沒有這些解析程式端點，則無法解析 MCP 伺服器主機名稱，且整合建立失敗。如需詳細資訊，請參閱在 Amazon Quick Sight 中設定 VPC 連線。

MCP 伺服器無法從 VPC 連線連線連線 – 從 Amazon Quick 到 MCP 伺服器的流量來自您在 VPC 連線設定期間選取的子網路。確認路由表、網路 ACLs 和安全群組允許這些子網路和 MCP 伺服器端點之間的流量。如需一般 VPC 網路指引，請參閱 在 Amazon Quick Sight 中設定 VPC 連線。

當您使用私有 MCP 伺服器時，身分驗證失敗 – 當您透過 VPC 連線連線至私有 MCP 伺服器時，MCP 伺服器使用的 OAuth 端點仍必須透過公有網際網路存取。這同時適用於使用者身分驗證 （授權和字符端點） 和服務身分驗證 （字符端點）。不支援私有 OAuth 供應商。確認 MCP 伺服器在其受保護的資源中繼資料中傳回的 OAuth URLs 透過公有網際網路解析。

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，連接器建立可能會失敗。

伺服器連線問題會導致立即失敗，而無需重試。

不支援升級授權。如果 MCP 伺服器在初始授權後需要額外的範圍 (HTTP 403 搭配 insufficient_scope)，則必須重新授權整個連線。增量許可升級不可用。

範圍處理有下列限制：

只有動態用戶端註冊 (DCR) 支援自動用戶端註冊。不支援用戶端 ID 中繼資料文件。

眾所周知的 URI 探索只會使用伺服器根路徑。不支援路徑特定的中繼資料位置 （路徑插入探索）。此限制可能會阻止發現僅在路徑特定的 URIs 提供中繼資料的伺服器。