Mengendalikan Restorm lewat MCP

Restorm mengekspos sebuah server MCP (Model Context Protocol). Karena itu sebuah agen AI — Claude Code, Cursor, atau klien MCP mana pun — dapat membaca proyek Anda, membuat dan menjalankan permintaan, serta mengendalikan antarmukanya.

Inilah yang memungkinkan Anda meminta “impor Swagger ini, buatlah sebuah skenario yang menguji alur pemesanannya, lalu jalankan” dan memperoleh hasil yang dapat diverifikasi, di dalam sebuah aplikasi yang tetap Anda lihat.

Pengaktifan

Servernya aktif secara bawaan. Ada dua tata kelolanya:

• setelan Pengaturan ▸ MCP ▸ Aktifkan server MCP;
• sebuah aturan mutlak: pada mesin tanpa tampilan, server MCP-nya tidak pernah dijalankan, apa pun setelannya. Jadi sebuah server CI tidak akan berakhir dengan mengekspos sebuah titik masuk.

Indikator MCP pada bilah status berkedip pada setiap panggilan yang masuk. Popovernya memungkinkan Anda menjeda atau melanjutkan servernya untuk sesi itu, serta membuka log MCP.

Menyambungkan asisten AI Anda

Saat dijalankan, Restorm memilih sebuah port yang bebas, menghasilkan sebuah token akses khusus untuk prosesnya, lalu menulis sebuah file penemuan di direktori sementara sistem. Server JSON-RPC-nya mendengarkan di 127.0.0.1:<port>/mcp — hanya pada loopback lokal: setiap pemanggil dari luar menerima sebuah 403.

Anda tidak pernah menyalin sendiri port maupun token itu. Sebuah peluncur kecil menjembatani masukan dan keluaran standar klien MCP Anda dengan server HTTP milik Restorm: ia menemukan instans yang sedang berjalan, menyuntikkan token, dan meneruskan panggilan Anda. Ia menjawab initialize dan tools/list seketika dari sebuah manifes bawaan, sehingga klien Anda mulai dengan cepat tanpa menunggu Restorm melakukan boot — lalu menyajikan daftar alat yang sebenarnya begitu sebuah panggilan berhasil. Ia tidak pernah menjalankan Restorm secara diam-diam: sebuah instans yang server MCP-nya Anda matikan akan tetap mati, disertai pesan galat yang jelas.

Apa yang diberikan dengan menyambungkan sebuah AI

Menyambungkan sebuah asisten ke Restorm memberinya akses penuh ke alat-alat Restorm Anda atas nama Anda — menjalankan permintaan terhadap target sesungguhnya, membaca dan menulis proyek Anda, dan (pada Pro) alat otomatisasi dan git. Permintaan menggunakan rahasia Anda yang telah diselesaikan, persis seperti saat Anda sendiri yang mengemudikan Restorm. Token penemuan bersifat khusus per instans dan hanya dapat dibaca oleh pengguna lokal Anda. Sambungkan hanya asisten yang Anda percaya, dan biarkan prompt persetujuan klien MCP Anda tetap menyala.

Cara termudah — dari aplikasi

Jalur tercepat tidak memerlukan konfigurasi manual apa pun. Buka popover indikator MCP (bilah status) lalu klik «Tambahkan Restorm ke asisten AI Anda». Sebuah dialog menyajikan, klien demi klien, satu-satunya baris untuk disalin:

• Claude Code — perintah claude mcp add …, dipasangkan dengan tombol «Tambahkan ke Claude Code» yang menjalankannya untuk Anda ketika alat claude terdeteksi pada PATH Anda;
• Claude Desktop dan Cursor — blok mcpServers untuk ditempel, beserta lokasi file konfigurasi.

Restorm tidak pernah menulis file konfigurasi aplikasi lain: tombol jalankan hanya mengendalikan alat claude milik Anda sendiri. Untuk klien lainnya, Anda menempel cuplikannya sendiri.

Plugin Claude Code

Claude Code juga dapat memasang Restorm sebagai plugin, dari marketplace milik kami yang di-host sendiri:

/plugin marketplace add Monsieur-Dev/restorm
/plugin install restorm@restorm-marketplace

Plugin ini mendaftarkan server MCP restorm (bergantung pada npx -y restorm-mcp) — tidak ada lagi yang perlu disiapkan.

Mengonfigurasi secara manual

Lebih suka menulis konfigurasi sendiri — atau menggunakan klien lain? Opsi-opsi di bawah ini mencakup setiap kasus.

Prasyarat

• Server MCP diaktifkan — secara bawaan menyala (Pengaturan ▸ MCP). Pada mesin tanpa layar, ia tidak pernah dijalankan, apa pun kata setelannya.
• Sebuah instans Restorm sedang berjalan — peluncur menyambung ke aplikasi Anda yang sedang berjalan, ia tidak memunculkan yang baru.
• Node.js ≥ 18 untuk metode npx di bawah.

Opsi A — npx restorm-mcp (disarankan)

Tanpa instalasi, tanpa path untuk dikelola, bekerja dengan klien apa pun dan di setiap OS. Arahkan klien Anda ke sana:

{
  "mcpServers": {
    "restorm": {
      "command": "npx",
      "args": ["-y", "restorm-mcp"]
    }
  }
}

Ke mana cuplikan itu ditaruh bergantung pada klien Anda:

• Claude Desktop — Pengaturan ▸ Pengembang ▸ Edit Konfigurasi, atau file claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\).
• Cursor — Pengaturan ▸ MCP ▸ Tambah, atau ~/.cursor/mcp.json.
• Claude Code — claude mcp add restorm -- npx -y restorm-mcp, atau sebuah .mcp.json di proyek Anda.

macOS: node tidak ditemukan dari aplikasi GUI

Di macOS, aplikasi GUI (Claude Desktop, Cursor…) tidak mewarisi PATH terminal Anda. Jika node tidak terpasang di lokasi standar, klien gagal memulai server dengan env: node: No such file or directory — bahkan dengan path absolut ke npx, karena npx menjalankan ulang node melalui PATH. Solusi yang paling andal adalah Opsi B di bawah ini: arahkan node — dengan path absolut jika perlu — langsung ke peluncur bawaan, dengan melewati npx.

Opsi B — peluncur yang disertakan dalam aplikasi (tanpa npm)

Setiap pemasangan Restorm menyertakan peluncur yang sama sebagai sumber daya bawaan, sehingga Anda dapat mengarahkan node langsung ke sana, tanpa npm:

{
  "mcpServers": {
    "restorm": {
      "command": "node",
      "args": ["<path-to>/restorm-resources/mcp-launcher.mjs"]
    }
  }
}

<path-to> adalah direktori sumber daya aplikasi:

• macOS — /Applications/Restorm.app/Contents/Resources/restorm-resources/mcp-launcher.mjs
• Windows — %LOCALAPPDATA%\Programs\restorm\resources\restorm-resources\mcp-launcher.mjs
• Linux — /opt/Restorm/resources/restorm-resources/mcp-launcher.mjs (.deb/.rpm); di dalam image yang dipasang untuk AppImage; $SNAP/resources/restorm-resources/mcp-launcher.mjs untuk Snap.

Opsi C — HTTP langsung

Bacalah port dan token dari file penemuan, lalu kirimkan permintaan JSON-RPC Anda dengan header Authorization: Bearer <token>.

Di mana peluncur mencari

Peluncur dan aplikasi harus sepakat tentang direktori penemuan. Keduanya secara bawaan menggunakan restorm-mcp di bawah direktori sementara sistem; jika Anda menyetel variabel lingkungan RESTORM_MCP_DIR, berikan nilai yang sama di kedua sisi (hanya diperlukan jika Restorm berjalan di bawah pengelola layanan dengan direktori sementara yang berbeda).

Beberapa instans

Beberapa Restorm dapat berjalan secara paralel. Setiap panggilan menerima sebuah kunci khusus __session untuk menunjuk instans yang dituju. Alat list-instances, create_instance, dan terminate_instance melengkapi gambarannya.

Keluarga alatnya

Pembacaan · navigasi · proyek · penulisan · lingkungan dan rahasia · impor · eksekusi · skenario · instans · otomatisasi antarmuka (tangkapan layar, kueri DOM, masukan, pintasan, tema, tata letak).

Empat sumber daya juga diekspos: restorm://project, restorm://tree, restorm://active-tab, dan restorm://request/{id}.

Inventaris lengkapnya: Alat MCP.

Apa yang gratis dan apa yang Pro

Server MCP-nya sendiri tidak pernah dibatasi. Setiap alat memeriksa kapabilitasnya sendiri pada saat dipanggil.

• Edisi Community — seluruh pengendalian permintaan: menjalankan, membatalkan, membaca respons dan riwayatnya, membaca aliran, mengirim pesan, mengimpor dari sebuah URL, membuka dan menutup tab, mengelola proyek, menulis ke dalam pohon, mengelola lingkungan dan variabel, pengaturan cepat, favorit, serta keenam alat firewall.
• Edisi Pro — ranah skenario (termasuk pembacaannya), tangkapan layar, seluruh otomatisasi antarmuka, tema, mini browser, tata letak workbench, instans ganda, dan alat git.

Sebuah alat yang dibatasi tetap terdaftar — judulnya membawa akhiran (Restorm Pro) — dan mengembalikan galat yang jelas serta terbaca mesin alih-alih menghilang.

Keamanan

• Loopback lokal dan token: servernya hanya mendengarkan di 127.0.0.1, dan tokennya dibandingkan dalam waktu yang konstan.
• Rahasia: sebuah agen menerima nilai hasil resolusi dari sebuah rahasia, sama seperti bagian aplikasi lainnya — agen itu mengendalikan Restorm atas nama Anda, dengan rahasia Anda sendiri. Apa yang dijamin tipe Rahasia tetap berlaku: nilainya tidak masuk ke dalam proyek, tidak ke dalam sebuah ekspor, dan tidak menuju layanan pihak ketiga yang tidak diizinkan.
• Efek jaringan yang nyata: run_request benar-benar memanggil sasarannya. Alur persetujuan klien MCP Anda-lah yang berperan sebagai pengaman — biarkan tetap aktif.
• Firewall tetap berlaku: sebuah panggilan yang dipicu agen menuju origin yang tidak dikenal akan memunculkan permintaan izin yang sama seperti panggilan Anda sendiri.
• Pencatatan: setiap panggilan muncul di dalam log MCP, lengkap dengan permintaan dan responsnya.