Referensi alat MCP WordPress.com
Teks ini diterjemahkan menggunakan AI. Jika Anda ingin melihat teks asli dalam bahasa Inggris, klik di sini.
Dokumen ini menyediakan pemetaan lengkap alat MCP yang tersedia untuk pengembang WordPress.com. Dokumen ini bersifat dinamis dan akan diperbarui saat alat baru ditambahkan atau alat yang ada dimodifikasi.
Untuk skema input dan output yang tepat, panggil alat itu sendiri — setiap facade STRAP mengekspos action: list (katalog operasi) dan action: describe (JSON Schema lengkap per operasi). Skema berkembang, jadi selalu anggap respons describe langsung sebagai sumber kebenaran.
Cara alat MCP WordPress.com diatur
Server MCP WordPress.com mengekspos dua jenis alat:
- Alat facade STRAP — Satu alat MCP yang membungkus sekumpulan operasi terkait di balik satu titik masuk. Facade menggunakan antarmuka berbasis tindakan yang seragam (
action: list | describe | execute) sehingga agen AI dapat menemukan apa yang tersedia, mengambil skema parameter, dan menjalankan operasi melalui satu alat. Ini menjaga katalog alat tetap ringkas dan mudah diprediksi. - Alat mandiri — Alat dengan satu tujuan yang menerima parameter secara langsung. Digunakan untuk operasi yang tidak cocok dengan kelompok yang lebih besar (misalnya mencantumkan situs pengguna, membuat URL checkout).
⚠️ Protokol keselamatan: Semua operasi tulis, perbarui, dan hapus memerlukan konfirmasi pengguna. Agen harus (1) menjelaskan secara persis apa yang akan dilakukan, (2) meminta konfirmasi eksplisit dari pengguna, dan (3) menyertakan konfirmasi pengguna sebagai user_confirmed: true dalam params execute. Operasi tulis tidak pernah dijalankan secara otomatis. Penghapusan permanen (istilah taksonomi) juga memerlukan confirm_permanent_delete: true.
Antarmuka berbasis tindakan (facade STRAP)
Setiap alat facade STRAP menerima tiga input tingkat atas yang sama:
action(enum:list/describe/execute): Apa yang ingin dilakukan agen.list— Menemukan operasi yang tersedia pada alat ini. Mengembalikan nama operasi, deskripsi singkat, dan alasan operasi dinonaktifkan.describe— Mendapatkan JSON Schema lengkap (parameter, tipe, bidang wajib) untuk satu operasi.execute— Menjalankan operasi.operation: Nama operasi dalam bentukresource.action(misalnya,posts.create,theme.presets).params: Parameter khusus operasi. Operasi tulis harus menyertakanuser_confirmed: true.
Sebagian besar facade juga memerlukan wpcom_site (ID situs atau URL). Facade wpcom-mcp-account adalah pengecualian — facade ini beroperasi pada pengguna yang terautentikasi.
Semua operasi mendukung parameter opsional include_fields untuk membatasi kolom yang dikembalikan. Gunakan parameter ini agar respons tetap efisien sesuai konteks.
Alat facade STRAP
Penulisan Konten ( wpcom-mcp-content-authoring )
Buat, baca, perbarui, dan hapus konten di situs WordPress.com — pos, halaman, komentar, media, kategori, tag, pola blok, dan pencarian konten.
💡 Urutan yang direkomendasikan: Panggil wpcom-mcp-site-editor-context terlebih dahulu (theme.active, theme.presets) agar konten menggunakan slug preset yang selaras dengan tema (misalnya "primary", "large") alih-alih warna dan ukuran yang ditetapkan secara hard-code.
Operasi yang tersedia
| Operasi | Deskripsi |
|---|---|
posts.list | Menampilkan daftar pos dengan filter opsional (status, penulis, pencarian, taksonomi, rentang tanggal, pengurutan, paginasi). |
posts.get | Mendapatkan pos tunggal berdasarkan ID atau slug. Beralih ke pencarian halaman jika slug tidak cocok dengan pos. |
posts.create | Membuat pos baru — dibuat sebagai draf secara default. Operasi tulis. |
posts.update | Memperbarui pos yang sudah ada. Hanya kolom yang diberikan yang berubah. Jika status adalah publish, perubahan akan langsung tayang. Operasi tulis. |
posts.delete | Memindahkan pos ke tong sampah. Dapat dipulihkan dari admin WordPress dalam waktu 30 hari. Operasi tulis. |
pages.list | Menampilkan daftar halaman dengan filter opsional (induk, status, pencarian, pengurutan, paginasi). |
pages.get | Mendapatkan halaman tunggal berdasarkan ID atau slug. |
pages.create | Membuat halaman baru — dibuat sebagai draf secara default. Mendukung struktur hierarkis dan templat halaman. Operasi tulis. |
pages.update | Memperbarui halaman yang sudah ada. Hanya kolom yang diberikan yang berubah. Jika status adalah publish, perubahan akan langsung tayang. Operasi tulis. |
pages.delete | Memindahkan halaman ke tong sampah. Dapat dipulihkan dari admin WordPress dalam waktu 30 hari. Operasi tulis. |
comments.list | Menampilkan daftar komentar dengan filter opsional (status, pos, penulis, pencarian, rentang tanggal, paginasi). |
comments.get | Mendapatkan komentar tunggal berdasarkan ID. |
comments.create | Membuat komentar pada pos. Komentar dari pengguna terautentikasi akan otomatis mengisi kolom penulis. Operasi tulis. |
comments.update | Memperbarui komentar yang sudah ada. Jika status adalah approved, perubahan akan langsung terlihat. Operasi tulis. |
comments.delete | Memindahkan komentar ke tong sampah. Operasi tulis. |
media.list | Menampilkan daftar item media dengan filter opsional (tipe MIME, pos, penulis, pencarian, rentang tanggal, paginasi). |
media.get | Mendapatkan item media tunggal berdasarkan ID. |
media.create | Mengunggah item media baru (gambar, video, audio, dokumen). Operasi tulis. |
media.update | Memperbarui metadata item media (bukan filenya). Perubahan pada alt_text dan caption akan diperbarui seketika di mana pun media digunakan. Operasi tulis. |
media.delete | Memindahkan item media ke tong sampah. Dapat merusak konten yang merujuknya. Operasi tulis. |
categories.list | Menampilkan daftar kategori dengan filter opsional. |
categories.get | Mendapatkan kategori tunggal berdasarkan ID. |
categories.create | Membuat kategori baru. Mendukung hubungan hierarkis induk-anak. Operasi tulis. |
categories.update | Memperbarui kategori yang sudah ada. Mengubah slug akan langsung memengaruhi URL arsip dan dapat merusak tautan. Operasi tulis. |
categories.delete | Menghapus kategori secara permanen — istilah taksonomi tidak memiliki tong sampah. Pos yang ditetapkan akan dipindahkan ke Tak Berkategori; kategori turunan menjadi tingkat teratas. Memerlukan confirm_permanent_delete: true. |
tags.list | Menampilkan daftar tag dengan filter opsional. Pencarian tag tidak peka huruf besar/kecil. |
tags.get | Mendapatkan tag tunggal berdasarkan ID. |
tags.create | Membuat tag baru. Operasi tulis. |
tags.update | Memperbarui tag yang sudah ada. Mengubah slug akan langsung memengaruhi URL arsip. Operasi tulis. |
tags.delete | Menghapus tag secara permanen — dihapus dari semua pos terkait. Memerlukan confirm_permanent_delete: true. |
patterns.list | Menampilkan daftar pola blok yang tersedia di situs (tema, core, direktori pola). |
patterns.get | Mendapatkan pola blok tunggal berdasarkan nama, termasuk markup bloknya. |
synced-patterns.list | Menampilkan daftar pola tersinkronisasi (dapat digunakan ulang) milik situs. |
synced-patterns.get | Mendapatkan pola tersinkronisasi tunggal berdasarkan ID, termasuk markup bloknya. |
content-search | Pencarian teks bebas di seluruh konten situs (pos, halaman, tipe pos lainnya). |
⚠️ Operasi destruktif (posts.delete, pages.delete, comments.delete, media.delete, categories.delete, tags.delete) mengharuskan agen mengambil dan menampilkan item yang akan dihapus (judul, penulis, jumlah pos terdampak) sebelum meminta konfirmasi.
💡 Kiat: Saat membuat halaman, gunakan patterns.list → patterns.get untuk mengambil pola blok dan menyusun halaman lengkap dari beberapa pola. Setelah setiap pembuatan atau pembaruan, periksa bidang _content_warnings pada respons — WordPress mungkin menghapus blok atau HTML saat penyimpanan.
Konteks Editor Situs ( wpcom-mcp-site-editor-context )
Kueri konteks desain situs — preset tema, gaya yang diterapkan, dan tipe blok terdaftar. Pendamping hanya-baca untuk Penulisan Konten. Gunakan sebelum membuat atau memperbarui konten agar markup menggunakan token yang selaras dengan tema, bukan nilai hard-coded.
Fasad ini menggunakan action: list | describe | get (bukan execute, karena tidak pernah menulis).
💡 Urutan yang disarankan: theme.active → theme.presets → (opsional) blocks.allowed → lalu buat konten melalui wpcom-mcp-content-authoring.
Operasi yang tersedia
| Operasi | Deskripsi |
|---|---|
theme.active | Dapatkan slug dan nama stylesheet tema aktif. Gunakan nilai stylesheet saat mengambil theme.presets atau theme.styles. |
theme.presets | Dapatkan token desain situs — palet warna, ukuran font, keluarga font, gradien, skala spasi. Otomatis menentukan stylesheet dari tema aktif jika dihilangkan. |
theme.styles | Dapatkan gaya situs yang diterapkan dari theme.json — penimpaan tingkat blok serta tipografi/warna tingkat elemen. Melengkapi theme.presets: preset adalah token apa saja yang tersedia; gaya adalah bagaimana token tersebut diterapkan. |
blocks.allowed | Cantumkan tipe blok yang terdaftar di situs beserta nama, judul, deskripsi, kategori, dan variasi gaya. Terapkan variasi gaya sebagai is-style-{name}. |
💡 Kiat: Rujuk slug preset dalam markup blok — misalnya, has-primary-color atau has-large-font-size — alih-alih gaya inline dengan nilai hex atau piksel mentah, agar konten menyesuaikan saat token desain situs berubah.
⚠️ Penting: Blok yang terdaftar tidak menjamin markup-nya tetap tidak berubah setelah melewati pipeline penyimpanan REST API. Setelah setiap pembuatan atau pembaruan melalui wpcom-mcp-content-authoring, periksa bidang _content_warnings. Jika markup dihapus, gunakan alternatif blok yang lebih sederhana atau tanyakan kepada pengguna bagaimana melanjutkannya.
Akun ( wpcom-mcp-account )
Kelola akun WordPress.com pengguna yang diautentikasi — profil, notifikasi, pencapaian, domain, koneksi, keamanan, dan mata uang. Beroperasi pada pengguna yang memanggil; parameter wpcom_site tidak diperlukan.
Operasi yang tersedia
| Operasi | Deskripsi |
|---|---|
profile.get | Profil Dasar (nama pengguna, email, nama tampilan, avatar, locale, zona waktu), opsional dengan preferensi, statistik, info akun, data sosial/aktivitas. |
profile.update | Perbarui kolom profil (nama tampilan, bio, locale, dll.). Tulis. |
notifications.get | Preferensi notifikasi di email, push, lini masa, dan saluran lainnya. Mencakup daftar perangkat dan pengujian pengiriman. |
notifications.update | Perbarui pengaturan notifikasi. Tulis. |
inbox.get | Kotak masuk notifikasi pengguna (pesan, peringatan, mention, suka, mengikuti). Filter berdasarkan jenis, belum dibaca, rentang waktu. |
achievements.get | Lencana yang diperoleh, prestasi, progres gamifikasi, dan kotak trofi. |
domains.list | Daftar domain pengguna yang diautentikasi di semua situs. |
domains.get | Detail domain: kemampuan pengelolaan, konfigurasi DNS, DNSSEC, status SSL, status pemeliharaan. |
domains.dns_records | DNS record (A, AAAA, ALIAS, CAA, CNAME, MX, NS, SRV, TXT) untuk satu domain. |
domains.set_primary | Tetapkan domain kustom sebagai domain utama untuk sebuah situs. Tulis. |
connections.get | Koneksi layanan sosial dan pihak ketiga (daftar, dapatkan detail, uji kesehatan). |
security.get | Status keamanan: 2FA, kata sandi aplikasi, sesi aktif, riwayat login, usia akun. |
currency.preview | Pratinjau dampak perubahan mata uang akun (tidak menyimpan perubahan). |
currency.change | Ubah mata uang akun. Tulis. |
Situs ( wpcom-mcp-site )
Kelola situs WordPress.com — pengaturan, statistik, plugin, log aktivitas, tema, dan konfigurasi modul Jetpack. Memerlukan wpcom_site (ID situs atau URL).
Operasi yang tersedia
| Operasi | Deskripsi |
|---|---|
settings.get | Pengaturan umum, penulisan, pembacaan, diskusi, media, permalink, dan privasi. |
settings.update | Perbarui pengaturan situs. Tulis. |
statistics.get | Total situs — pos yang dipublikasikan, halaman, pelanggan — ditambah tampilan, pengunjung, pos yang dipublikasikan, dan halaman yang dipublikasikan opsional untuk rentang tanggal. TIDAK mencakup pos teratas, perujuk, geo, atau rincian per URL. |
plugin.list | Plugin terinstal beserta status, versi, ketersediaan pembaruan, dan izin. |
activity.get | Entri log aktivitas (pos, komentar, pembaruan plugin, cadangan, tindakan pengguna). Urutan kronologis terbalik. Default ke 6 bulan terakhir. Filter berdasarkan activity_group dan activity_action. |
theme.list | Tema yang terinstal di situs. |
theme.set | Ganti tema aktif. Tulis. |
monitor.status / monitor.activate / monitor.deactivate | Pemeriksaan uptime Jetpack Monitor. Aktifkan/nonaktifkan adalah operasi tulis. |
newsletter.status / newsletter.get_settings | Status dan pengaturan Jetpack Newsletter. |
account-protection.status / account-protection.activate / account-protection.deactivate | Jetpack Account Protection. Aktifkan/nonaktifkan adalah operasi tulis. |
manage-site.status / manage-site.launch / manage-site.set-visibility | Siklus hidup situs — status segera hadir, peluncuran, visibilitas. Operasi tulis. |
💡 Tips untuk activity.get: gabungkan activity_group (misalnya ["plugin"]) dan activity_action (misalnya ["activated", "deactivated"]) untuk mempersempit investigasi. Panggil tanpa filter terlebih dahulu untuk mengetahui apa saja yang tersedia untuk situs tertentu.
Alat mandiri
Tampilkan daftar situs pengguna ( wpcom-user-sites )
Tampilkan daftar situs yang dapat diakses oleh pengguna terautentikasi di WordPress.com dan situs yang dihosting sendiri yang terhubung dengan Jetpack. Gunakan ini untuk menemukan ID situs sebelum memanggil alat yang cakupannya khusus situs. Mendukung paginasi, pencarian, filter status dan privasi, pengurutan, serta metrik situs opsional.
Cari ketersediaan domain ( wpcom-domain-purchase )
Cari domain yang tersedia dan buat tautan checkout untuk pendaftaran di WordPress.com. Mengembalikan domain yang cocok beserta harga dan URL checkout yang sudah dibuat sebelumnya.
Perbarui DNS record ( wpcom-domain-update-dns-records )
Tambah atau hapus DNS record (A, AAAA, ALIAS, CAA, CNAME, MX, NS, SRV, TXT) untuk satu domain kustom yang Anda kelola.
⚠️ Operasi destruktif. DNS yang salah konfigurasi dapat merusak email dan situs web. Selalu ambil record saat ini (melalui wpcom-mcp-account → domains.dns_records) dan jelaskan perbedaannya sebelum meminta konfirmasi.
Pulihkan DNS record default ( wpcom-domain-restore-default-dns-records )
Pulihkan record A default WordPress.com (IP apex) atau CNAME www default untuk satu domain kustom. Dibatasi oleh pengaturan “Perbarui DNS record”.
Perbarui nameserver ( wpcom-domain-update-nameservers )
Tetapkan nameserver untuk satu domain kustom. Mengharuskan pemanggil mengelola situs yang terhubung dengan domain tersebut. Menerima antara 2 hingga 13 hostname nameserver yang valid.
⚠️ Mengubah nameserver memindahkan kontrol DNS dari WordPress.com. Email, situs web, dan layanan lain dapat rusak jika nameserver baru tidak dikonfigurasi untuk menyajikan record yang sama.
Atur layanan email eksternal ( wpcom-domain-set-mail-service )
Konfigurasikan DNS record pada domain untuk layanan email eksternal: Google Workspace, iCloud Mail, Office 365, atau Zoho Mail.
⚠️ Menimpa MX dan DNS record terkait yang sudah ada pada domain. Alur email yang ada akan berhenti segera setelah record baru tersebar.
Buat URL checkout ( wpcom-checkout-url )
Buat URL checkout WordPress.com yang telah dikonfigurasi sebelumnya untuk satu atau beberapa produk (pembelian baru) atau untuk perpanjangan langganan. URL ini mengarahkan pengguna ke checkout WordPress.com — pembayaran dilakukan di browser, bukan melalui alat ini.
Tampilkan daftar paket WordPress.com ( wpcom-plans-list )
Tampilkan daftar paket WordPress.com beserta harga dan daftar fitur per tingkat. Hanya baca; berguna untuk menampilkan opsi paket sebelum membuat URL checkout.
Ringkasan protokol keamanan
Semua operasi tulis/hapus mewajibkan alur konfirmasi. Agen harus menjelaskan tindakan tersebut, mendapatkan persetujuan eksplisit dari pengguna, dan meneruskan persetujuan itu sebagai user_confirmed: true dalam params eksekusi.
| Perilaku | Baca | Buat | Perbarui | Hapus (sampah) | Hapus (permanen) |
|---|---|---|---|---|---|
| Konfirmasi diperlukan | ❌ | ✅ | ✅ | ✅ | ✅ |
| Dapat dipulihkan | N/A | N/A | Sebagian (nilai sebelumnya hilang) | ✅ Dalam 30 hari | ❌ Permanen |
| Status default (konten) | N/A | draft | Tidak berubah | trash | Dihapus sepenuhnya |
| Flag tambahan | — | — | — | — | confirm_permanent_delete: true |
Penghapusan permanen (istilah taksonomi seperti kategori dan tag) juga memerlukan confirm_permanent_delete: true dalam params.
Bentuk user_confirmed yang diterima: boolean true (disarankan), atau salah satu string "true", "yes", "on", "1". Frasa persetujuan bebas seperti "yes do it" ditolak — agen harus menerjemahkan persetujuan pengguna menjadi salah satu bentuk yang diterima ini.
Terakhir diperbarui: Juni 23, 2026
Sumber Daya Pengembang WordPress.com