Memulai

Untuk menggunakan Roblox MCP, Anda membutuhkan dua komponen.

Aplikasi AI (Claude, Codex, Gemini, dll.)
       │
   Server MCP  ← Mengonversi perintah AI ke format yang dipahami Roblox
       │
Plugin Roblox Studio  ← Menjalankan perintah di dalam Studio

Saat aplikasi AI mengatakan “buatkan part berwarna biru”, server MCP mengonversi permintaan tersebut, dan plugin Roblox Studio benar-benar membuat part tersebut.

Instalasi Satu Baris (Direkomendasikan)

Satu baris perintah berikut menginstal server MCP dan plugin sekaligus.

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex

Setelah instalasi selesai, buka kembali aplikasi AI dan restart Roblox Studio.

Jika terjadi error selama instalasi, path file log sementara akan ditampilkan. Pada eksekusi interaktif, konsol tetap terbuka sebelum keluar sehingga Anda dapat memeriksa penyebabnya.

Registrasi MCP otomatis mendukung Claude Code, Claude Desktop, Cursor, Codex CLI / App, Gemini CLI, Antigravity.

Jika eksekusi PowerShell diblokir di Windows, lanjutkan dengan instalasi manual di bawah ini. Jika menggunakan paket ZIP, Anda dapat menjalankan setup-plugin.bat dan setup-mcp.bat.

Instalasi Manual

Prosedur alternatif jika instalasi satu baris tidak berfungsi atau lingkungan tidak mendukung instalasi otomatis.

Langkah 1 — Instal Plugin Roblox Studio

Unduh file plugin dari GitHub lalu tempatkan di folder Plugins Roblox Studio untuk menginstalnya.

Langkah 2 — Daftarkan Server MCP ke Aplikasi AI

Pilih aplikasi AI yang Anda gunakan dan buka panduan konfigurasinya. Dapat digunakan dengan semua aplikasi AI yang mendukung MCP.

Bahkan aplikasi AI yang tidak ada dalam daftar di atas pun dapat digunakan selama mendukung MCP. Perintah server MCP adalah npx -y @weppy/roblox-mcp.

Opsional — WEPPY Roblox Explorer (Ekstensi VSCode)

Anda dapat menjelajahi pohon instans yang tersinkronisasi di VSCode dengan ikon kelas Roblox. Ekstensi ini memerlukan instalasi Roblox MCP di atas terlebih dahulu karena Explorer membaca data Sync weppy-project-sync di bawah root proyek.

Setelah Instalasi Selesai

1. Buka Roblox Studio dan klik WEPPY → Connect di tab Plugins.

2. Uji coba dengan cara berikut di aplikasi AI Anda:

   Buatkan part berwarna biru di Roblox Studio

3. Jika part berhasil dibuat, instalasi telah selesai.