As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Começando com o MCP
Cada API do Agente de Transformação de Dados está disponível como uma ferramenta MCP, para que você possa criar perfis, executar conversões de teste e depurar falhas de um agente de MCP-compatible IA sem sair do seu IDE.
## Pré-requisitos
+ Um MCP-compatible cliente (como Kiro ou Cursor).
+ AWS credenciais configuradas com as permissões do Data Transformation Agent IAM de[Configurar](data-transformation-setting-up.md).
## Etapa 1: instalar e configurar o AWS Servidor MCP
Instale o servidor AWS MCP em sua ferramenta agente preferida (como Kiro ou Cursor) e configure-o com suas AWS credenciais e sua região. Para obter instruções de instalação e configuração, consulte a [documentação do servidor AWS MCP](https://github.com/awslabs/mcp).
## Etapa 2: verificar se as ferramentas estão disponíveis
Após a configuração, as operações do Agente de Transformação de Dados aparecem como ferramentas que podem ser chamadas em seu agente. Os nomes das ferramentas são mapeados diretamente para as operações da API:
| Nome da ferramenta | O que ela faz |
| --- | --- |
| CreateDataTransformationProfile | Cria um perfil no estado DRAFT |
| UpdateProfileWithAgent | Envia uma mensagem para o agente de IA para editar um perfil |
| PublishDataTransformationProfile | Publica o rascunho atual como uma versão imutável |
| GetDataTransformationProfile | Recupera metadados e conteúdo do perfil |
| StartDataTransformationJob | Inicia um trabalho de conversão em massa |
| DescribeDataTransformationJob | Verifica o status e o progresso do trabalho |
| DeleteDataTransformationProfile | Exclui metadados e conteúdo do perfil |
| ListDataTransformationProfiles | Lista os perfis em sua conta |
| ListDataTransformationJobs | Lista os trabalhos de transformação |
**nota**
A operação de conversão de sincronização (TransformData) é REST-only e pode não aparecer como uma ferramenta MCP. Seu agente pode criar e executar a chamada REST em seu nome: consulte Etapa 3: Teste com conversão de sincronização para o formato da solicitação.
## Etapa 3: use as ferramentas em linguagem natural
Depois de conectado, conduza o ciclo de vida completo do perfil conversando com seu próprio agente, que interage com o agente de transformação de dados via MCP:
+ “Crie um C-CDA perfil a partir do Perfil AWS Inicial chamado 'Perfil de Cardiologia'.” → O agente liga CreateDataTransformationProfile e retorna o ID do perfil.
+ “Adicione um mapeamento para a seção Medicação.” → O agente liga UpdateProfileWithAgent, mostra a alteração proposta e solicita a confirmação.
+ “Publique o perfil e inicie um trabalho em massa em s3://my - bucket/ccda -files/” → O agente liga então. PublishDataTransformationProfile StartDataTransformationJob
+ “Qual é a situação do meu último emprego?” → O agente liga DescribeDataTransformationJob e relata o progresso.
+ “12 registros falharam: o que aconteceu?” → O agente inspeciona os erros e propõe uma correção do perfil.
As sessões mantêm o contexto em vários turnos, para que o agente se lembre de seu perfil, conversa e instruções anteriores em todo o fluxo de trabalho.
## Solução de problemas
| Sintomas | Correção |
| --- | --- |
| As ferramentas não aparecem após a configuração | Verifique se o servidor AWS MCP está em execução e configurado para a região correta. Reinicie seu cliente MCP. |
| AccessDeniedException em chamadas de ferramentas | Adicione as ações healthlake: \* DataTransformation \* à sua política do IAM. Consulte [Configurar](data-transformation-setting-up.md). |
| ResourceNotFoundException | Certifique-se de que a região na configuração do servidor MCP corresponda à região em que seus perfis existem. |