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á.
# Execute migrações com o AWS Transforme o servidor MCP
O servidor AWS Transform Model Context Protocol (MCP) permite planejar e executar migrações de qualquer MCP-compatible cliente, como Kiro, Claude Code, Cursor ou Cline, sem sair do ambiente de desenvolvimento. O MCP é uma interface padronizada que fornece ao assistente de IA do seu cliente acesso contextual e em tempo real aos seus espaços de trabalho e trabalhos do AWS Transform. Com ele, você pode criar espaços de trabalho, iniciar trabalhos de migração, responder a tarefas humanas e baixar artefatos por meio de linguagem natural.
O servidor MCP expõe todo o ciclo de vida da migração: descoberta do ambiente de origem, planejamento da migração, destino Conta da AWS de conexão, migração de rede, configuração do landing zone e rehospedagem do servidor. Ele é executado como um processo local lançado pelo seu cliente MCP e se comunica com o AWS Transform via HTTPS de saída. O cliente MCP é o processo que executa o servidor, como Kiro ou Claude Code. O assistente de IA é o modelo de experiência nesse cliente para o qual você envia solicitações. Para uma introdução geral às ferramentas de desenvolvedor do AWS Transform, incluindo o Kiro Power, plug-ins de agente e plug-in IDE, consulte[Ferramentas de desenvolvedor](developer-tools.md).
**Instalando o servidor MCP**
Os plug-ins Kiro Power e do agente instalam o servidor MCP automaticamente. Instale o servidor MCP manualmente somente se quiser usá-lo sem um plug-in Kiro Power ou agente.
## Configurando o AWS Transforme o servidor MCP
Antes de começar, você deve ter o seguinte:
+ Python 3.10 ou posterior.
+ Uma conta AWS Transform com acesso de inquilino. Para obter informações sobre como configurar o AWS Transform, consulte[Conceitos básicos de AWS Transformação](getting-started.md).
+ Um MCP-compatible cliente, como Kiro, Claude Code, Claude Desktop, Cursor ou Cline.
Você pode instalar o servidor AWS Transform MCP do PyPI como. `awslabs.aws-transform-mcp-server` Os exemplos a seguir executam o servidor com`uvx`.
**Código Claude**
```
claude mcp add awslabs.aws-transform-mcp-server -- uvx awslabs.aws-transform-mcp-server@latest
```
**Kiro, Cursor, VS Code, Cline e Claude Desktop () macOS/Linux**
Adicione o seguinte ao arquivo de configuração MCP do seu cliente. Para Kiro, use`~/.kiro/settings/mcp.json`.
```
{
"mcpServers": {
"awslabs.aws-transform-mcp-server": {
"command": "uvx",
"args": ["awslabs.aws-transform-mcp-server@latest"],
"env": {
"AWS_REGION": "us-east-1",
"FASTMCP_LOG_LEVEL": "ERROR"
}
}
}
}
```
**Windows**
```
{
"mcpServers": {
"awslabs.aws-transform-mcp-server": {
"command": "uvx",
"args": [
"--from",
"awslabs.aws-transform-mcp-server@latest",
"awslabs.aws-transform-mcp-server.exe"
],
"env": {
"FASTMCP_LOG_LEVEL": "ERROR",
"AWS_REGION": "us-east-1"
},
"disabled": false
}
}
}
```
Para obter detalhes de configuração para seu cliente MCP específico, consulte o README [aws-transform-mcp-server](https://github.com/awslabs/mcp/tree/main/src/aws-transform-mcp-server) em. GitHub
Você pode definir as seguintes variáveis de ambiente no `env` bloco da configuração do seu cliente MCP.
| Variável | Description |
| --- | --- |
| AWS\_REGION | O Região da AWS usado para chamadas de API do plano de controle. O padrão é a Região do perfil e, em seguida, o Leste dos EUA (Norte da Virgínia). |
| AWS\_PROFILE | O perfil de credencial usado para ferramentas do plano de controle. Se não for definida, volta à cadeia de credenciais padrão. |
| FASTMCP\_LOG\_LEVEL | O nível do registro (DEBUGINFO,WARNING, ouERROR). O padrão é INFO. |
| AWS\_TRANSFORM\_MCP\_WRITE\_DIR | O diretório base ao qual os downloads de artefatos estão confinados. Um caminho de download deve ser resolvido dentro desse diretório. Se seu cliente iniciar o servidor fora de um shell, defina essa variável para que os downloads de artefatos tenham um destino válido. |
A maioria das ferramentas MCP usa autenticação de API da web (login do navegador). A `accept_connector` ferramenta também exige AWS credenciais, que o servidor detecta automaticamente. AWS O Transform oferece suporte aos seguintes métodos de autenticação.
Centro de identidade (SSO) do IAM
Peça ao assistente de IA que “Configure o AWS Transform with SSO”. O assistente solicita a URL inicial do IAM Identity Center e abre seu navegador para fazer login. O servidor então salva suas credenciais localmente e as carrega automaticamente quando você o reinicia. Re-run essa configuração quando as ferramentas retornam erros de autenticação.
Perfil do IAM
Seu ambiente fornece AWS credenciais automaticamente. Defina `AWS_PROFILE` na configuração do seu cliente MCP para selecionar um perfil específico.
Para obter mais informações sobre como configurar a autenticação para o AWS Transform, consulte os pré-requisitos anteriormente neste tópico.
Depois de instalar e configurar o servidor, reinicie seu cliente MCP. Em seguida, peça ao assistente de IA que “Verifique o status da minha conexão do AWS Transform”. Uma resposta bem-sucedida confirma que o servidor está instalado, configurado e autenticado.
## Utilizar AWS Transforme para migrações via MCP
Com o servidor MCP conectado, você conduz sua migração conversando com o assistente de IA em linguagem natural. O assistente chama as ferramentas AWS Transform MCP em seu nome para gerenciar espaços de trabalho, iniciar trabalhos de migração, responder a tarefas humanas em loop e recuperar artefatos. Uma migração típica segue esses estágios.
**Para executar uma migração por meio do servidor MCP**
1. **Crie ou selecione um espaço de trabalho.** Um espaço de trabalho é um contêiner lógico para um ou mais trabalhos de migração. O espaço de trabalho determina Região da AWS onde residem seus trabalhos, dados de descoberta e recomendações de AWS transformação. Peça ao assistente para criar um espaço de trabalho ou listar seus espaços de trabalho existentes.
1. **Crie e inicie um trabalho de migração.** Peça ao assistente que crie um trabalho de migração. O assistente descobre os agentes disponíveis e inicia o trabalho. Para obter informações sobre os tipos de trabalho de migração e as etapas que cada um inclui, consulte[Tipos de emprego](vmware-jobs.md#vmware-job-types).
1. **Execute a descoberta.** Carregue seu inventário de servidores locais para que o AWS Transform possa analisá-lo, desduplicá-lo e validá-lo. Para obter as fontes e formatos de dados de descoberta compatíveis, consulte[Descubra os dados de origem](transform-vmware-discover-source-data.md).
1. **Crie o plano de migração.** Trabalhe com o assistente para definir o escopo e analisar seu inventário, agrupar servidores em aplicativos, gerar grupos de movimentação e criar ondas de migração. Você pode fazer perguntas sobre seu ambiente e repetir o plano a qualquer momento. Para obter mais informações, consulte [Crie um plano de migração](transform-vmware-review-groupings-and-waves.md).
1. **Conecte sua conta de destino.** Crie um conector e faça com que um administrador do destino o Conta da AWS aprove para que o AWS Transform possa implantar infraestrutura, migrar redes e rehospedar servidores. Para obter mais informações, consulte [Conecte o alvo Conta da AWS s e regiões](transform-vmware-connect-target-account.md).
1. **Migre a rede, construa o landing zone e hospede novamente os servidores.** Peça ao assistente que execute as etapas de execução restantes em seu plano de trabalho.
1. **Responda às tarefas humanas em andamento.** AWS Transforme as pausas nos pontos de revisão e aprovação. O assistente mostra a tarefa e seu artefato para você revisar. Depois de decidir, o assistente envia sua resposta (aprova, rejeita ou envia para aprovação). Sempre revise os detalhes da tarefa e o artefato do agente antes de aprovar.
1. **Acompanhe o status e baixe artefatos.** Peça ao assistente o status do trabalho a qualquer momento e faça com que ele baixe artefatos como relatórios, diagramas e resumos do espaço de trabalho para seu ambiente local.
Como você interage com o AWS Transform de forma conversacional, você pode alternar entre esses estágios de forma iterativa, fazer perguntas esclarecedoras e refinar seu plano sem trocar de ferramenta.
## Práticas recomendadas
Siga essas melhores práticas ao executar migrações por meio do servidor AWS Transform MCP.
+ **Revise antes de aprovar.** Sempre inspecione os detalhes da tarefa e o artefato do agente antes de aprovar uma tarefa humana no circuito. Não permita que o assistente envie automaticamente aprovações para etapas de migração que criam ou AWS modificam recursos.
+ **Use credenciais com privilégios mínimos.** Configure a variável de `AWS_PROFILE` ambiente para apontar para um perfil com escopo limitado somente às permissões que sua migração exige. Para migrações de várias contas, prefira uma conta de administrador delegado à conta de gerenciamento da organização. Para obter mais informações, consulte [Usando uma conta de administrador delegado](transform-vmware-connect-target-account.md#transform-vmware-cta-delegated-admin).
+ **Limite os downloads de artefatos.** Defina a variável de `AWS_TRANSFORM_MCP_WRITE_DIR` ambiente em um diretório dedicado para que os artefatos baixados cheguem a um local conhecido e contido. Isso é especialmente importante quando um cliente desktop ou IDE inicia o servidor fora de um shell.
+ **Mantenha sua sessão autenticada.** Os tokens SSO expiram. Re-run Configuração de SSO quando as ferramentas começam a retornar erros de autenticação e verifique sua conexão com uma verificação de status antes de iniciar etapas de longa duração.
+ **Defina a região correta.** `AWS_REGION`Defina Região da AWS onde residem seu espaço de trabalho e dados de descoberta. Se sua região de destino de migração for diferente da sua região de descoberta, alguns dados serão transferidos Regiões da AWS. Para obter mais informações, consulte [Regiões-alvo suportadas](transform-vmware-connect-target-account.md#transform-vmware-cta-supported-regions).
+ **Carregue dados de descoberta completos e atuais.** A qualidade do seu plano de migração depende da qualidade do seu inventário. Faça o upload dos dados mais detalhados disponíveis e verifique se eles refletem seu ambiente atual antes de criar ondas.
+ **Considere o modo especialista para grandes migrações.** Quando quiser minimizar as idas e vindas, forneça suas informações com antecedência e deixe que o agente as aplique automaticamente. Para obter mais informações, consulte [Use o modo especialista](transform-app-vmware-expert-mode.md).
## Exemplos de prompt
Executar o AWS Transform por meio do servidor MCP faz mais do que mover a experiência da web para o seu IDE. O assistente de IA encadeia várias chamadas de ferramentas, lê e grava arquivos em seu espaço de trabalho local e aplica a lógica condicional. Como resultado, você pode expressar fluxos de trabalho de várias etapas, iterativos e em lotes que vão além de uma única interação com um aplicativo web. Os exemplos a seguir mostram instruções sofisticadas. Adapte-os ao seu ambiente.
Faça com que o assistente pesquise uma etapa contínua, reaja ao que encontrar e faça uma pausa para você somente quando for necessária uma decisão. Um loop autônomo como esse é conduzido pelo assistente, não pelo aplicativo da web.
```
Start network migration for wave 1, then poll the job status every two
minutes until it completes or needs my input. If a human-in-the-loop task
appears, stop polling, summarize the task and its artifact for me, and wait
for my decision before doing anything else.
```
```
Check every active job across all my workspaces. For each one, give me a
one-line status, and flag any job that has been waiting on an approval for
more than 24 hours or has reported an error. Repeat this check every 15
minutes and only message me when something changes.
```
```
Re-run the inventory readiness check after my latest upload. If there are any
data-quality errors, list the affected servers grouped by issue and stop. If
it validates cleanly, proceed to application grouping using the rules in
./planning/grouping-rules.md.
```
Peça ao assistente que faça referência cruzada de artefatos de diferentes estágios e sintetize um relatório consolidado. O assistente pode então salvá-lo em seu espaço de trabalho local para revisão ou controle de versão.
```
Pull my migration strategy (7Rs) recommendations and my current wave plan.
Cross-reference them and produce a consolidated readiness report that
highlights every application whose recommended strategy conflicts with the
strategy assigned to its wave. Include the confidence score and reasoning for
each conflict, and save the report to ./reports/readiness.md.
```
```
Build an executive migration report that combines my risk assessment scores,
the 7Rs recommendations, and the wave schedule. Rank waves by combined risk,
call out the top five applications that need attention before cutover, and
export it as both a PDF for stakeholders and a PPTX deck for my review.
```
```
Compare the assessment I ran last month with my current plan. Tell me which
servers were newly discovered, which changed operating system or strategy, and
which moved between waves. Write the diff to ./reports/plan-change-log.md.
```
Itere sobre os aplicativos ou ondas em seu plano e gere um artefato para cada um, salvando-os localmente em uma única passagem.
```
For each application in my plan, generate an application dependency diagram
and save it to ./diagrams/APP_NAME.html. When you finish, give me a table of
every application with the number of dependencies found, and list any
applications you could not generate a diagram for and why.
```
```
For each wave, generate a network topology diagram scoped to that wave's
servers plus their cross-wave dependencies, and save each one to
./diagrams/waves/wave-N.html. Highlight any dependency that crosses a wave
boundary, since those need sequencing attention.
```
Combine o AWS Transform com arquivos e ferramentas em seu ambiente de desenvolvimento local, algo que o aplicativo web não pode fazer.
```
Read the decommissioning list in ./exclusions.csv, remove every matching
server from migration scope, then rebuild my waves and show me what changed in
the plan as a result.
```
```
Read the tagging standard in ./standards/tagging.md and apply it as the
resource tagging configuration for network migration and server rehost. Show
me the resulting tag set and flag any required tag the standard does not
specify a value for.
```
```
Download the workspace summary and the 7Rs report, commit them to the
migration-artifacts git repo in this workspace under ./artifacts/$(date +%F)/,
and write a short changelog entry describing what changed since the last
snapshot.
```
Portas de aprovação expressas e ramificações para que o assistente avance na migração somente quando suas condições forem atendidas.
```
Walk my end-to-end job through discovery and planning in expert mode using the
inputs in ./planning/inputs.txt. Pause for my review after wave planning
completes. Do not connect any target account or start execution until I
explicitly approve.
```
```
For wave 1 only, connect the target account, migrate the network, and rehost
the servers. After each step, verify it succeeded before starting the next. If
any step fails or produces a warning, stop immediately, show me the details,
and do not touch waves 2 or 3.
```