本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
MCP 入门
每个数据转换代理 API 都作为 MCP 工具提供，因此您无需离开 IDE 即可从 MCP-compatible AI 代理创作配置文件、运行测试转换和调试失败。
先决条件
-
MCP-compatible 客户端（例如 Kiro 或 Cursor）。
-
AWS 使用来自的数据转换代理 IAM 权限配置的证书设置。
步骤 1：安装和配置 AWS MCP 服务器
在您的首选代理工具（例如 Kiro 或 AWS Cursor）中安装 MCP 服务器，然后使用您的 AWS 凭据和区域对其进行配置。有关安装和配置说明，请参阅 AWS MCP 服务器文档
步骤 2：验证工具是否可用
设置完成后，数据转换代理操作在代理中显示为可调用的工具。工具名称直接映射到 API 操作：
| 工具名称 | 作用 |
|---|---|
| CreateDataTransformationProfile | 创建处于 “草稿” 状态的配置文件 |
| UpdateProfileWithAgent | 向 AI 代理发送消息以编辑配置文件 |
| PublishDataTransformationProfile | 将当前草稿作为不可变版本发布 |
| GetDataTransformationProfile | 检索个人资料元数据和内容 |
| StartDataTransformationJob | 开始批量转换作业 |
| DescribeDataTransformationJob | 检查作业状态和进度 |
| DeleteDataTransformationProfile | 删除个人资料元数据和内容 |
| ListDataTransformationProfiles | 列出您账户中的个人资料 |
| ListDataTransformationJobs | 列出转换任务 |
注意
同步转换操作 (TransformData) 以 MCP 工具的形式出现 REST-only ，也可能不会以 MCP 工具的形式出现。您的代理可以代表您构造和执行 REST 调用：有关请求格式，请参阅步骤 3：使用同步转换进行测试。
第 3 步：使用自然语言的工具
连接后，通过与自己的代理交谈，推动整个配置文件生命周期，该代理通过 MCP 与数据转换代理进行交互：
-
“从 AWS 初学者 C-CDA 档案中创建名为'心脏病学概况'的个人资料。” → 代理打电话 CreateDataTransformationProfile 并返回个人资料ID。
-
“为药物部分添加映射。” → 代理打电话 UpdateProfileWithAgent，出示提议的变更并要求确认。
-
“发布个人资料并根据 s3://my 开始批量工作-bucket/ccda-files/” → 然后代理打来电话 PublishDataTransformationProfile 。 StartDataTransformationJob
-
“我上一份工作的状态如何？” → 代理打电话 DescribeDataTransformationJob 并报告进度。
-
“12 条记录失败：发生了什么？” → 代理检查错误并提出配置文件修复建议。
会话在多个回合中保持上下文，因此客服人员可以在整个工作流程中记住您的个人资料、对话和先前的指示。
问题排查
| 症状 | Fix |
|---|---|
| 设置完成后工具不会出现 | 验证 AWS MCP 服务器是否正在运行并针对正确的区域进行了配置。重新启动您的 MCP 客户端。 |
| AccessDeniedException 在工具调用时 | 将 healthlake: DataTransformation * 操作添加到您的 IAM 策略中。请参阅设置。 |
| ResourceNotFoundException | 确保 MCP 服务器配置中的区域与您的配置文件所在的区域相匹配。 |
