本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
MCP 入門
每個資料轉換代理程式 API 都可以作為 MCP 工具使用，因此您可以從 MCP 相容 AI 代理程式編寫設定檔、執行測試轉換和偵錯失敗，而無需離開 IDE。
先決條件
-
與 MCP 相容的用戶端 （例如 Kiro 或 Cursor)。
-
AWS 使用來自 的資料轉換代理程式 IAM 許可設定的憑證設定。
步驟 1：安裝和設定 AWS MCP 伺服器
在偏好的代理工具 （例如 Kiro 或 Cursor) 中安裝 AWS MCP 伺服器，並使用登入 AWS 資料和區域進行設定。如需安裝和組態說明，請參閱 AWS MCP 伺服器文件
步驟 2：驗證工具是否可用
設定之後，資料轉換代理程式操作會在您的代理程式中顯示為可呼叫的工具。工具名稱會直接對應至 API 操作：
| 工具名稱 | 它的功能 |
|---|---|
| CreateDataTransformationProfile | 建立處於 DRAFT 狀態的設定檔 |
| UpdateProfileWithAgent | 傳送訊息給 AI 代理器以編輯設定檔 |
| PublishDataTransformationProfile | 將目前的草稿發佈為不可變版本 |
| GetDataTransformationProfile | 擷取設定檔中繼資料和內容 |
| StartDataTransformationJob | 啟動大量轉換任務 |
| DescribeDataTransformationJob | 檢查任務狀態和進度 |
| DeleteDataTransformationProfile | 刪除設定檔中繼資料和內容 |
| ListDataTransformationProfiles | 列出您帳戶中的設定檔 |
| ListDataTransformationJobs | 列出轉換任務 |
注意
同步轉換操作 (TransformData) 僅 REST，可能不會顯示為 MCP 工具。您的代理程式可以代表您建構和執行 REST 呼叫：請參閱步驟 3：使用請求格式的同步轉換進行測試。
步驟 3：使用自然語言的工具
連線後，與您自己的代理程式交談，透過 MCP 與資料轉換代理程式互動，以推動完整的設定檔生命週期：
-
「從名為「心臟設定檔」的 AWS 入門設定檔建立 C-CDA 設定檔。」 → 客服人員呼叫 CreateDataTransformationProfile 並傳回設定檔 ID。
-
「為「藥物」區段新增映射。」 → 客服人員呼叫 UpdateProfileWithAgent，顯示提議的變更，並要求確認。
-
「針對 s3：//my-bucket/ccda-files/」發佈設定檔並啟動大量任務」→ 代理程式會呼叫 PublishDataTransformationProfile，然後呼叫 StartDataTransformationJob。
-
「我的上一個任務的狀態是什麼？」 → 客服人員呼叫 DescribeDataTransformationJob 並報告進度。
-
「12 筆記錄失敗：發生了什麼事？」 → 代理程式會檢查錯誤並提議設定檔修正。
工作階段會維持多個回合的內容，因此客服人員會在整個工作流程中記住您的設定檔、對話和先前的指示。
疑難排解
| 徵狀 | 修正 |
|---|---|
| 工具在設定後不會顯示 | 驗證 AWS MCP 伺服器是否正在執行，並針對正確的區域進行設定。重新啟動您的 MCP 用戶端。 |
| 工具呼叫的 AccessDeniedException | 將 healthlake：*DataTransformation* 動作新增至您的 IAM 政策。請參閱 設定。 |
| ResourceNotFoundException | 請確定 MCP 伺服器組態中的區域符合您設定檔所在的區域。 |
