本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# MCP 入門
每個資料轉換代理程式 API 都可以作為 MCP 工具使用，因此您可以從 MCP 相容 AI 代理程式編寫設定檔、執行測試轉換和偵錯失敗，而無需離開 IDE。
## 先決條件
+ 與 MCP 相容的用戶端 （例如 Kiro 或 Cursor)。
+ AWS 使用來自 的資料轉換代理程式 IAM 許可設定的憑證[設定](data-transformation-setting-up.md)。
## 步驟 1：安裝和設定 AWS MCP 伺服器
在偏好的代理工具 （例如 Kiro 或 Cursor) 中安裝 AWS MCP 伺服器，並使用登入 AWS 資料和區域進行設定。如需安裝和組態說明，請參閱 [AWS MCP 伺服器文件](https://github.com/awslabs/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 政策。請參閱 [設定](data-transformation-setting-up.md)。 |
| ResourceNotFoundException | 請確定 MCP 伺服器組態中的區域符合您設定檔所在的區域。 |