1.7 MCP Server — Hubungkan AI Assistant Langsung ke Tokomu

Hasil akhir: AI assistant (Claude Code, Cursor, atau Claude Desktop) terhubung langsung ke toko Konvert-mu, dan bisa membaca/mengelola landing page, produk, pesanan, dan data lain sesuai izin yang kamu berikan. Butuh: Akun Konvert aktif dengan peran pemilik toko (owner) — hanya owner yang bisa membuat API key ini. Salah satu AI client yang mendukung koneksi MCP (Model Context Protocol) via Bearer token.

1.7.1Ringkasan

Konvert punya MCP server bawaan yang bisa diakses AI assistant favoritmu dari luar aplikasi — misalnya lewat Claude Code atau Cursor di komputermu. Setelah terhubung, kamu bisa minta AI itu membuatkan landing page, mengecek pesanan terbaru, mengubah harga produk, atau menganalisis performa toko, semuanya lewat percakapan biasa, tanpa buka dashboard Konvert.

Caranya: kamu buat sebuah API key khusus di halaman Settings, lalu tempel key itu ke konfigurasi AI client-mu. Setiap request dari AI client akan lewat lewat API key ini, dan Konvert hanya mengizinkan akses ke toko yang key tersebut terikat — tidak bisa menyentuh toko lain.

---

1.7.21. Buat API Key MCP

1. Di sidebar, buka Settings → API Keys (/settings/api-keys).

2. Klik "Buat API Key".

3. Isi Nama Key — pakai nama yang gampang dikenali, contoh: Claude Desktop atau Cursor Laptop Kantor.

4. Centang Permissions sesuai kebutuhan. Tiap kategori punya aksi sendiri (Baca / Tulis / Hapus / Generate / Analisis):

   Kategori	Isi
   Toko	Akses ke data toko
   Produk	Kelola produk dan bundle
   Landing Pages	Kelola landing page
   Pesanan	Akses data pesanan
   AI Assistant	Fitur AI untuk generate dan analisis (memakai token AI)
   Analitik	Baca statistik landing page
   Pelanggan	Baca data pelanggan
   Voucher	Kelola kode voucher

   Centang seperlunya saja — kalau AI-nya cuma untuk bikin landing page, cukup centang Landing Pages dan Produk, tidak perlu Pesanan atau Pelanggan.

5. Pilih Kedaluwarsa: Tidak Pernah, 30 Hari, 90 Hari, atau 1 Tahun. Untuk key yang dipakai jangka panjang di laptop pribadi, durasi terbatas (30/90 hari) lebih aman daripada "Tidak Pernah".

6. Klik "Buat Key".

Setelah key dibuat, muncul dialog "API Key Berhasil Dibuat" yang menampilkan:

• API Key — string lpb_sk_.... Ini hanya ditampilkan sekali, salin sekarang juga.
• Koneksi via Claude CLI — perintah siap-pakai untuk Claude Code.
• Konfigurasi JSON — siap ditempel ke claude_desktop_config.json atau file config MCP client lain.

---

1.7.32. Hubungkan AI Client

Setiap key terikat ke domain dashboard tempat kamu membuatnya (misalnya https://development.konvert.id atau domain toko kamu) — endpoint MCP-nya selalu <domain-dashboard-kamu>/api/mcp. Pakai persis URL yang muncul di dialog sukses langkah sebelumnya, jangan menebak atau menyalin dari contoh di bawah ini.

Claude Code (via CLI)

Salin perintah yang muncul di dialog, bentuknya seperti ini:

claude mcp add --transport http konvert https://<domain-dashboard-kamu>/api/mcp --header "Authorization: Bearer lpb_sk_..."

Jalankan di terminal. Claude Code langsung mengenali server MCP konvert dan tool-tool di dalamnya.

Claude Desktop / Cursor (via konfigurasi JSON)

Salin JSON dari dialog sukses, lalu tempel ke file konfigurasi MCP client-mu (untuk Claude Desktop: claude_desktop_config.json):

{
  "mcpServers": {
    "konvert": {
      "type": "http",
      "url": "https://<domain-dashboard-kamu>/api/mcp",
      "headers": { "Authorization": "Bearer lpb_sk_..." }
    }
  }
}

Simpan file, lalu restart AI client-nya supaya konfigurasi baru terbaca.

---

1.7.43. Apa yang Bisa Dilakukan AI Setelah Terhubung

Tool yang muncul di AI client mengikuti permission yang kamu centang saat membuat key. Ringkasannya:

Permission	Yang bisa dilakukan AI
Toko	Baca info toko (nama, subdomain, jumlah halaman)
Landing Pages	Lihat, buat, edit pengaturan, publish/unpublish, hapus landing page — termasuk menambah/mengubah/menghapus/mengurutkan komponen di dalamnya
Produk	Lihat, buat, edit, hapus produk dan bundle
Pesanan	Lihat daftar dan detail pesanan
Pelanggan	Lihat daftar dan detail pelanggan
Voucher	Lihat, buat, edit, hapus kode diskon/voucher
Analitik	Lihat statistik landing page dan toko
AI Assistant	Cek sisa token AI, generate landing page otomatis dari data produk (memakai/memotong token AI-mu, seperti fitur AI di dashboard — lihat Tutorial 51 — Top Up Kredit AI)

AI juga bisa membuat halaman baru dari template yang tersedia di akunmu (tergantung paket langganan untuk template premium).

---

1.7.54. Keamanan & Best Practice

• Perlakukan API key seperti password. Siapa pun yang punya key ini bisa melakukan aksi sesuai permission yang dicentang — jangan share di chat publik, screenshot, atau commit ke repository kode.
• Beri permission seminimal mungkin. Kalau AI hanya untuk riset produk, jangan centang Pesanan atau Pelanggan.
• Set kedaluwarsa. Untuk key yang dipakai sementara (uji coba, laptop pinjaman), pilih 30 atau 90 hari, bukan "Tidak Pernah".
• Cabut key yang sudah tidak dipakai. Di halaman /settings/api-keys, klik ikon tempat sampah di sebelah key untuk mencabutnya — aplikasi yang masih pakai key itu langsung kehilangan akses, dan tindakan ini tidak bisa dibatalkan.
• Satu key per client. Biar gampang dilacak, buat key terpisah untuk tiap AI client/perangkat (contoh: "Claude Desktop – Laptop Kantor", "Cursor – PC Rumah") daripada share satu key ke banyak perangkat.

---

1.7.6Troubleshooting

Masalah	Kemungkinan Penyebab	Solusi
AI client gagal connect / error 401	API key salah ketik, sudah dicabut, atau sudah kedaluwarsa	Cek ulang key yang ditempel di config, atau buat key baru di /settings/api-keys
AI bilang "This key is not bound to a store"	Jarang terjadi, tapi bisa muncul kalau key dibuat sebelum toko aktif dipilih	Buat key baru pastikan toko yang benar sedang aktif saat membuat key
Tool tertentu tidak muncul di AI client	Permission untuk kategori itu belum dicentang saat membuat key	Buat key baru dengan permission yang lebih lengkap (key lama tidak bisa diedit permission-nya)
AI kena rate limit / "Try again in a minute"	Terlalu banyak request dalam waktu singkat dari key yang sama	Tunggu sebentar lalu coba lagi
Fitur generate AI gagal karena token habis	Saldo token AI toko habis	Cek dan top up di Tutorial 51 — Top Up Kredit AI

---

1.7.7FAQ

Apakah AI bisa melihat data toko lain kalau saya punya lebih dari satu toko? Tidak. Satu API key hanya terikat ke satu toko — toko yang aktif saat key dibuat. Kalau butuh akses ke toko lain, buat key baru saat toko itu aktif.

Apakah key bisa diedit permission-nya setelah dibuat? Tidak. Kalau butuh permission berbeda, cabut key lama dan buat key baru dengan permission yang sesuai.

Apa itu MCP? MCP (Model Context Protocol) adalah standar terbuka yang dipakai AI client seperti Claude untuk terhubung ke aplikasi eksternal. Konvert menyediakan MCP server sendiri supaya AI bisa "bekerja" langsung di tokomu, bukan sekadar menjawab pertanyaan.

Apakah aksi yang dilakukan AI sama seperti aksi manual di dashboard? Ya. Membuat landing page atau produk lewat AI menghasilkan data yang persis sama seperti dibuat manual di dashboard — bisa langsung dilihat, diedit, dan dipublish seperti biasa.

Last reviewed: 2026-08-12