Jalankan migrasi dengan AWS Ubah server MCP

Server AWS Transform Model Context Protocol (MCP) memungkinkan Anda merencanakan dan menjalankan migrasi dari MCP-compatible klien mana pun, seperti Kiro, Claude Code, Cursor, atau Cline, tanpa meninggalkan lingkungan pengembangan Anda. MCP adalah antarmuka standar yang memberikan asisten AI di klien Anda akses kontekstual real-time ke ruang kerja dan pekerjaan Transform Anda AWS . Dengannya, Anda dapat membuat ruang kerja, meluncurkan pekerjaan migrasi, menanggapi tugas manusia-in-the-loop, dan mengunduh artefak melalui bahasa alami.

Server MCP mengekspos siklus hidup migrasi penuh: penemuan lingkungan sumber Anda, perencanaan migrasi, menghubungkan target Akun AWS, migrasi jaringan, penyiapan landing zone, dan rehost server. Ini berjalan sebagai proses lokal yang diluncurkan oleh klien MCP Anda dan berkomunikasi dengan AWS Transform melalui HTTPS keluar. Klien MCP adalah proses yang menjalankan server, seperti Kiro atau Claude Code. Asisten AI adalah pengalaman model dalam klien yang Anda kirimi permintaannya. Untuk pengenalan umum tentang alat pengembang AWS Transform, termasuk Kiro Power, plugin agen, dan plugin IDE, lihat. Alat developer

Menginstal server MCP

Plugin Kiro Power dan agen menginstal server MCP secara otomatis. Instal server MCP secara manual hanya jika Anda ingin menggunakannya tanpa Kiro Power atau plugin agen.

Menyiapkan AWS Ubah server MCP

Sebelum Anda mulai, pastikan Anda memiliki yang berikut:

• Python 3.10 atau yang lebih baru.

• Akun AWS Transform dengan akses penyewa. Untuk informasi tentang pengaturan AWS Transform, lihatMemulai dengan AWS Transformasi.

• MCP-compatible Klien, seperti Kiro, Claude Code, Claude Desktop, Cursor, atau Cline.

Instal server MCP

Anda dapat menginstal server AWS Transform MCP dari awslabs.aws-transform-mcp-server PyPI sebagai. Contoh berikut menjalankan server denganuvx.

Kode Claude

claude mcp add awslabs.aws-transform-mcp-server -- uvx awslabs.aws-transform-mcp-server@latest

Kiro, Kursor, Kode VS, Cline, dan Claude Desktop () macOS/Linux

Tambahkan berikut ini ke file konfigurasi MCP klien Anda. Untuk Kiro, gunakan~/.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
    }
  }
}

Untuk detail konfigurasi untuk klien MCP spesifik Anda, lihat AWS-transform-mcp-server README aktif. GitHub

Konfigurasikan variabel lingkungan

Anda dapat mengatur variabel lingkungan berikut di env blok konfigurasi klien MCP Anda.

Variabel	Deskripsi
AWS_REGION	Yang Wilayah AWS digunakan untuk panggilan API bidang kontrol. Default ke profil Wilayah, dan kemudian ke AS Timur (Virginia N.).
AWS_PROFILE	Profil kredensi yang digunakan untuk alat pesawat kontrol. Jatuh kembali melalui rantai kredensi standar jika tidak disetel.
FASTMCP_LOG_LEVEL	Tingkat log (DEBUG,INFO,WARNING, atauERROR). Diatur secara default ke INFO.
AWS_TRANSFORM_MCP_WRITE_DIR	Direktori dasar yang diunduh artefak terbatas. Jalur unduhan harus diselesaikan dalam direktori ini. Jika klien Anda meluncurkan server di luar shell, atur variabel ini sehingga unduhan artefak memiliki tujuan yang valid.

Mengautentikasi

Sebagian besar alat MCP menggunakan otentikasi API web (login browser). accept_connectorAlat ini juga membutuhkan AWS kredensyal, yang dideteksi server secara otomatis. AWS Transform mendukung metode otentikasi berikut.

Pusat Identitas IAM (SSO)

Minta asisten AI untuk “Konfigurasi AWS Transformasi dengan SSO.” Asisten meminta URL awal Pusat Identitas IAM Anda dan membuka browser Anda untuk masuk. Server kemudian menyimpan kredensyal Anda secara lokal dan memuatnya secara otomatis saat Anda memulai ulang. Re-run konfigurasi ini ketika alat mengembalikan kesalahan otentikasi.

IAM Role

Lingkungan Anda menyediakan AWS kredensil secara otomatis. Setel AWS_PROFILE dalam konfigurasi klien MCP Anda untuk memilih profil tertentu.

Untuk informasi selengkapnya tentang menyiapkan otentikasi untuk AWS Transform, lihat prasyarat sebelumnya dalam topik ini.

Verifikasi koneksi

Setelah Anda menginstal dan mengkonfigurasi server, restart klien MCP Anda. Kemudian minta asisten AI untuk “Periksa status koneksi AWS Transform saya.” Respons yang berhasil mengonfirmasi bahwa server diinstal, dikonfigurasi, dan diautentikasi.

Penggunaan AWS Transformasi untuk migrasi melalui MCP

Dengan server MCP yang terhubung, Anda mendorong migrasi Anda dengan berbicara dengan asisten AI dalam bahasa alami. Asisten memanggil alat AWS Transform MCP atas nama Anda untuk mengelola ruang kerja, meluncurkan pekerjaan migrasi, menanggapi tugas manusia-in-the-loop, dan mengambil artefak. Migrasi tipikal mengikuti tahapan ini.

Untuk menjalankan migrasi melalui server MCP

1. Buat atau pilih ruang kerja. Ruang kerja adalah wadah logis untuk satu atau lebih pekerjaan migrasi. Ruang kerja menentukan Wilayah AWS tempat pekerjaan, data penemuan, dan rekomendasi AWS Transform Anda berada. Minta asisten untuk membuat ruang kerja atau daftar ruang kerja yang ada.

2. Buat dan mulai pekerjaan migrasi. Minta asisten untuk membuat pekerjaan migrasi. Asisten menemukan agen yang tersedia dan memulai pekerjaan. Untuk informasi tentang jenis pekerjaan migrasi dan langkah-langkah yang disertakan masing-masing, lihatJenis Job.

3. Jalankan penemuan. Unggah inventaris server lokal Anda sehingga AWS Transform dapat mengurai, menghapus duplikasi, dan memvalidasinya. Untuk sumber dan format data penemuan yang didukung, lihatTemukan sumber data.

4. Membangun rencana migrasi. Bekerja dengan asisten untuk membuat cakupan dan menganalisis inventaris Anda, mengelompokkan server ke dalam aplikasi, membuat grup pindahan, dan membangun gelombang migrasi. Anda dapat mengajukan pertanyaan tentang lingkungan Anda dan mengulangi rencana kapan saja. Untuk informasi selengkapnya, lihat Membangun rencana migrasi.

5. Hubungkan akun target Anda. Buat konektor dan minta administrator target Akun AWS menyetujuinya sehingga AWS Transform dapat menyebarkan infrastruktur, memigrasi jaringan, dan meng-host ulang server. Untuk informasi selengkapnya, lihat Connect target Akun AWS s dan wilayah.

6. Migrasikan jaringan, bangun landing zone, dan rehost server. Minta asisten untuk menjalankan langkah-langkah eksekusi yang tersisa dalam rencana pekerjaan Anda.

7. Menanggapi tugas manusia-in-the-loop. AWS Ubah jeda pada titik peninjauan dan persetujuan. Asisten memunculkan tugas dan artefaknya untuk Anda tinjau. Setelah Anda memutuskan, asisten mengirimkan tanggapan Anda (menyetujui, menolak, atau mengirim untuk persetujuan). Selalu tinjau detail tugas dan artefak agen sebelum Anda menyetujuinya.

8. Lacak status dan unduh artefak. Mintalah asisten untuk status pekerjaan kapan saja, dan minta itu mengunduh artefak seperti laporan, diagram, dan ringkasan ruang kerja ke lingkungan lokal Anda.

Karena Anda berinteraksi dengan AWS Transform secara percakapan, Anda dapat berpindah di antara tahap-tahap ini secara iteratif, mengajukan pertanyaan klarifikasi, dan menyempurnakan rencana Anda tanpa beralih alat.

Praktik terbaik

Ikuti praktik terbaik ini saat Anda menjalankan migrasi melalui server AWS Transform MCP.

• Tinjau sebelum Anda menyetujui. Selalu periksa detail tugas dan artefak agen sebelum Anda menyetujui tugas manusia-in-the-loop. Jangan biarkan asisten mengirimkan persetujuan secara otomatis untuk langkah migrasi yang membuat atau memodifikasi AWS sumber daya.

• Gunakan kredensil hak istimewa paling sedikit. Konfigurasikan variabel AWS_PROFILE lingkungan untuk menunjuk ke profil yang hanya mencakup izin yang diperlukan migrasi Anda. Untuk migrasi multi-akun, pilih akun Administrator Delegasi daripada akun manajemen organisasi. Untuk informasi selengkapnya, lihat Menggunakan akun administrator yang didelegasikan.

• Batasi unduhan artefak. Atur variabel AWS_TRANSFORM_MCP_WRITE_DIR lingkungan ke direktori khusus sehingga artefak yang diunduh mendarat di lokasi yang diketahui dan terkandung. Ini sangat penting ketika klien desktop atau IDE meluncurkan server di luar shell.

• Jaga agar sesi Anda diautentikasi. Token SSO kedaluwarsa. Re-run Konfigurasi SSO saat alat mulai mengembalikan kesalahan otentikasi, dan verifikasi koneksi Anda dengan pemeriksaan status sebelum memulai langkah-langkah yang berjalan lama.

• Atur Wilayah yang benar. Setel AWS_REGION ke Wilayah AWS tempat ruang kerja dan data penemuan Anda berada. Jika Wilayah target migrasi Anda berbeda dari Wilayah penemuan Anda, beberapa data ditransfer ke seluruh wilayah Wilayah AWS. Untuk informasi selengkapnya, lihat Wilayah target yang didukung.

• Unggah data penemuan terkini yang lengkap. Kualitas rencana migrasi Anda tergantung pada kualitas inventaris Anda. Unggah data paling detail yang tersedia dan verifikasi data tersebut mencerminkan lingkungan Anda saat ini sebelum Anda membuat gelombang.

• Pertimbangkan mode ahli untuk migrasi besar. Saat Anda ingin meminimalkan bolak-balik, berikan input Anda di depan dan biarkan agen menerapkannya secara otomatis. Untuk informasi selengkapnya, lihat Gunakan mode ahli.

Contoh petunjuk

Menjalankan AWS Transform melalui server MCP lebih dari sekadar memindahkan pengalaman web ke IDE Anda. Asisten AI merantai beberapa panggilan alat, membaca dan menulis file di ruang kerja lokal Anda, dan menerapkan logika bersyarat. Hasilnya, Anda dapat mengekspresikan alur kerja multi-langkah, iteratif, dan batch yang melampaui interaksi aplikasi web tunggal. Contoh berikut menunjukkan petunjuk canggih. Sesuaikan dengan lingkungan Anda.

Verifikasi dan pemantauan loop

Mintalah asisten polling langkah berjalan, bereaksi terhadap apa yang ditemukannya, dan jeda untuk Anda hanya ketika keputusan diperlukan. Loop otonom seperti ini didorong oleh asisten, bukan aplikasi 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.

Laporan yang menggabungkan data penilaian dan perencanaan

Minta asisten untuk mereferensikan artefak silang dari berbagai tahap dan mensintesis laporan terkonsolidasi. Asisten kemudian dapat menyimpannya ke ruang kerja lokal Anda untuk ditinjau atau kontrol versi.

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.

Per-application diagram dan pembuatan batch

Ulangi aplikasi atau gelombang dalam rencana Anda dan buat artefak untuk masing-masing, simpan secara lokal dalam satu lintasan.

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.

Local-environment integrasi

Gabungkan AWS Transform dengan file dan alat di lingkungan pengembangan lokal Anda, sesuatu yang tidak dapat dilakukan aplikasi web.

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.

Otomatisasi bersyarat dan terjaga keamanannya

Ekspresikan gerbang persetujuan dan percabangan sehingga asisten memajukan migrasi hanya jika kondisi Anda terpenuhi.

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.