@weppy/roblox-mcp 0.1.10 → 1.0.0

package/docs/es/pro-upgrade.md

@@ -1,51 +1,57 @@
 # Guia de Actualizacion a Pro
 
-## Por que Pro?
+## ¿Por qué Pro?
 
-**Ahorro de tokens de IA** - Un solo comando de operacion masiva reemplaza docenas de operaciones individuales. Menos trabajo repetitivo significa menor uso de tokens y resultados mas rapidos.
+### Sync bidireccional para flujos de desarrollo reales
 
-**Juegos mas completos** - Con herramientas de terreno, entorno, assets y espacio, puedes crear mundos de juego terminados, no solo prototipos.
+Pro Sync va más allá del simple export. Edita scripts localmente y súbelos a Studio. Haz cambios en Studio y tráelos de vuelta al disco. Pro mantiene ambos lados sincronizados.
 
-## Herramientas que agrega Pro
+- **Sync bidireccional** — Los cambios fluyen en ambas direcciones entre Studio y los archivos locales.
+- **Direction por tipo** — Configura la dirección de forma independiente para Scripts, Values, Containers, Data y Services.
+- **Apply Mode por tipo** — Elige Auto o Manual por tipo para equilibrar velocidad y control.
+- **Full Sync / Resync** — Reconstruye el estado limpio del proyecto tras cambios grandes o reconexiones.
+- **Historial de cambios** — Rastrea qué cambió, cuándo y en qué dirección antes de aplicar.
+- **Sync multi-place** — Sincroniza hasta 3 Roblox Places a la vez, cada uno con almacenamiento aislado e historial de cambios propio.
 
-| Categoria | Funciones |
-|-----------|-----------|
-| **Operaciones masivas** | Crea 100 arboles con un solo comando. Modifica todas las partes simultaneamente. |
-| **Generacion de terreno** | Genera montanas, cuevas y paisajes de forma procedural. |
-| **Gestion de assets** | Busca en Creator Store e inserta modelos directamente. |
-| **Raycast** | Encuentra posiciones de spawn, detecta colisiones, analiza areas transitables. |
-| **Control de entorno** | Configura iluminacion, atmosfera, cielo y hora del dia. |
-| **Visualizacion** | Muestra areas, crea marcadores, resalta zonas. |
+### Ahorra tokens de IA con flujos de alto impacto
 
-## Como Comprar
+Las acciones masivas y avanzadas reducen las llamadas repetitivas — haz más por cada prompt.
 
-### Paso 1: Comprar en Gumroad
+### Capacidades avanzadas más amplias
 
-1. Visita [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/chllph?utm_source=github&utm_medium=repo&utm_campaign=sunity_plugin)
-2. Descarga el plugin
+Generación de terreno, búsqueda de assets, análisis espacial, animación, audio y automatización a escala de producción.
 
-### Paso 2: Instalar el Plugin
+## Suscripcion y descarga
 
-1. Abre Roblox Studio
-2. Pestana Plugins → Clic en **Plugins Folder**
-3. **Elimina** el `WeppyRobloxMCP.rbxm` existente (version Basic)
-4. **Copia** el `WeppyRobloxMCP-Pro.rbxm` descargado a la carpeta
-5. Reinicia Roblox Studio
+### Paso 1: Suscribirte en Gumroad
+
+1. Ve a [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/faccjs?utm_source=github&utm_medium=repo&utm_campaign=pro_upgrade_md)
+2. Completa la compra de licencia Pro por suscripcion
+
+### Paso 2: Descargar desde GitHub Releases
+
+1. Abre [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
+2. Descarga `weppy-roblox-mcp-v{version}.zip`
+3. Extrae y copia `roblox-plugin/WeppyRobloxMCP.rbxm` a tu carpeta de Plugins de Roblox
 
 ### Paso 3: Verificar
 
-1. Abre el plugin W-MCP
-2. Verifica que aparezca la insignia "Pro"
-3. Todas las herramientas estan disponibles!
+1. Abre W-MCP en Roblox Studio
+2. Confirma que aparece la insignia Pro
+3. Ejecuta una accion Pro (por ejemplo: `manage_sync` u operaciones masivas)
 
-## Comparacion de Funciones
+## Comparación de Funciones
 
-| Funcion | Basic | Pro |
+| Función | Basic | Pro |
 |---------|:-----:|:---:|
-| Instance, Script, Property | ✅ Acceso completo | ✅ Acceso completo |
+| Gestión de Script, Instance, Property | ✅ Acceso completo | ✅ Acceso completo |
 | Selection, Tag, Camera, Log | ✅ Acceso completo | ✅ Acceso completo |
-| Operaciones masivas (Bulk) | ― | ✅ Ilimitado |
-| Busqueda e insercion de assets | ― | ✅ Ilimitado |
-| Generacion de terreno (Terrain) | ― | ✅ Ilimitado |
-| Entorno, Raycast, Espacio | ― | ✅ Ilimitado |
-| Herramientas de visualizacion | ― | ✅ Ilimitado |
+| Dirección de Sync | Studio → Local (una vía) | Bidireccional |
+| Sync Direction por tipo | ❌ | ✅ Scripts / Values / Containers / Data / Services |
+| Apply Mode por tipo | ❌ | ✅ Auto / Manual |
+| Full Sync | ❌ | ✅ |
+| Resync / Reconstruir estado | ❌ | ✅ |
+| Historial de cambios | ❌ | ✅ |
+| Sync multi-place | ❌ | ✅ Hasta 3 places con almacenamiento aislado |
+| Cobertura avanzada de tools | Conjunto base | Conjunto avanzado más amplio |
+| Eficiencia de tokens IA | Estándar | Mejor con acciones masivas / de alto impacto |

package/docs/es/tools/overview.md

@@ -2,6 +2,10 @@
 
 Conecta la IA con Roblox Studio para automatizar diversas tareas. A continuacion se presenta lo que puedes hacer por categoria.
 
+Politica de Sync:
+- Basic: Studio -> Local (una via)
+- Pro: Sync bidireccional + funcionalidades avanzadas mas amplias (mejor eficiencia de tokens IA con operaciones masivas)
+
 ---
 
 ## Basic (Gratis)

package/docs/id/README.md

@@ -53,6 +53,12 @@ Instalasi cuma dua langkah:
 
 5 menit kelar. 👉 [Lihat panduan instalasi](installation/README.md)
 
+## Mulai dengan Pro
+
+Bangun tanpa batas. Sync dua arah, kemampuan kreasi lanjutan, dan efisiensi token AI — semua dalam satu upgrade.
+
+👉 [Panduan Upgrade Pro](pro-upgrade.md)
+
 ## Link
 
 - [GitHub](https://github.com/hope1026/roblox-mcp)

package/docs/id/installation/ai-apps/gemini-cli.md

@@ -1,6 +1,6 @@
-# Konfigurasi Gemini CLI
+# Pengaturan Gemini CLI
 
-Cara menggunakan Roblox MCP di [Google Gemini CLI](https://github.com/google-gemini/gemini-cli).
+Cara menggunakan Roblox MCP dengan [Google Gemini CLI](https://github.com/google-gemini/gemini-cli).
 
 ## Prasyarat
 
@@ -9,16 +9,32 @@ Cara menggunakan Roblox MCP di [Google Gemini CLI](https://github.com/google-gem
    node --version
    ```
 
-2. **Gemini CLI** sudah terinstal
+2. **Gemini CLI** terinstal
    ```bash
    npm install -g @google/gemini-cli
    ```
 
-3. **Plugin Roblox Studio** sudah terinstal
+3. **Plugin Roblox Studio** terinstal
 
-## Registrasi MCP Server
+## Mendaftarkan Server MCP
 
-### Metode 1: Edit File Konfigurasi (Disarankan)
+### Metode 1: Perintah CLI (Disarankan)
+
+Daftarkan dengan satu perintah di terminal Anda:
+
+```bash
+gemini mcp add weppy-roblox-mcp npx --trust -- -y @weppy/roblox-mcp
+```
+
+> Flag `--trust` melewati prompt konfirmasi untuk setiap pemanggilan tool.
+
+Untuk mendaftar secara global, tambahkan `-s user`:
+
+```bash
+gemini mcp add weppy-roblox-mcp npx -s user --trust -- -y @weppy/roblox-mcp
+```
+
+### Metode 2: Edit File Konfigurasi
 
 Tambahkan konten berikut ke file `.gemini/settings.json`:
 
@@ -34,15 +50,21 @@ Tambahkan konten berikut ke file `.gemini/settings.json`:
 ```
 
 **Lokasi file konfigurasi:**
-| Cakupan | Path |
+| Lingkup | Path |
 |---------|------|
 | Proyek | `<proyek>/.gemini/settings.json` |
 | Global | `~/.gemini/settings.json` |
 
-### Metode 2: Menggunakan Environment Variable
+### Metode 3: Menggunakan Variabel Lingkungan
+
+Jika variabel lingkungan tertentu diperlukan:
 
-Jika diperlukan environment variable tertentu:
+**CLI:**
+```bash
+gemini mcp add weppy-roblox-mcp npx --trust -e MCP_PORT=3002 -- -y @weppy/roblox-mcp
+```
 
+**File konfigurasi:**
 ```json
 {
   "mcpServers": {
@@ -59,67 +81,38 @@ Jika diperlukan environment variable tertentu:
 
 ## Tes Koneksi
 
-1. Jalankan **Roblox Studio** → Tab Plugins → **W-MCP** → **Connect**
-2. Jalankan **Gemini CLI** lalu masukkan:
+1. Buka **Roblox Studio** → tab Plugins → **W-MCP** → **Connect**
+2. Jalankan **Gemini CLI** dan masukkan:
    ```
-   Beritahu apa yang sedang dipilih di Roblox Studio
+   Beritahu saya apa yang sedang dipilih di Roblox Studio
    ```
 
-## Periksa Status MCP Server
+## Memeriksa Status Server MCP
 
-Anda dapat memeriksa status server yang terhubung dengan perintah `/mcp` di dalam Gemini CLI:
+Anda dapat memeriksa status server yang terhubung dengan perintah `/mcp` di Gemini CLI:
 
 ```
 /mcp
 ```
 
-## Konfigurasi Lanjutan
-
-### Filtering Tools
-
-Anda dapat menggunakan atau mengecualikan tools tertentu:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"],
-      "excludeTools": ["execute_script"],
-      "includeTools": ["get_selection", "create_instance", "set_property"]
-    }
-  }
-}
-```
-
-> `excludeTools` lebih diprioritaskan daripada `includeTools`.
-
-### Mode Debug
-
-Untuk debugging masalah koneksi:
-
-```bash
-gemini --debug
-```
-
 ## Pemecahan Masalah
 
-### Saat server tidak dimulai
+### Server tidak dapat dimulai
 
-Jalankan MCP server langsung untuk memeriksa error:
+Jalankan server MCP secara langsung untuk memeriksa kesalahan:
 ```bash
 npx -y @weppy/roblox-mcp
 ```
 
 ### Koneksi gagal
 
-- Pastikan plugin Roblox Studio dalam status **Connected**
-- Pastikan port 3002 tidak diblokir oleh firewall
+- Verifikasi bahwa plugin Roblox Studio dalam status **Connected**
+- Periksa apakah port 3002 diblokir oleh firewall
 - Periksa status server dengan perintah `/mcp`
 
-### Konflik tools
+### Konflik tool
 
-Jika ada tools dengan nama yang sama dari beberapa MCP server, akan ditambahkan prefix dalam format `serverAlias__toolName`.
+Jika beberapa server MCP memiliki tool dengan nama yang sama, mereka akan diberi awalan dengan format `serverAlias__toolName`.
 
 ## Referensi
 

package/docs/id/installation/roblox-plugin.md

@@ -4,23 +4,28 @@ Panduan instalasi plugin untuk menghubungkan AI agent di Roblox Studio.
 
 ## 1. Unduh Plugin
 
-1. Unduh `weppy-roblox-mcp-basic-v{versi}.zip` dari [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
-2. Ekstrak file ZIP — Anda akan menemukan file `roblox-plugin/WeppyRobloxMCP.rbxm` dan panduan instalasi
+1. Buka [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
+2. Unduh `weppy-roblox-mcp-v{version}.zip`
+3. Ekstrak ZIP - Anda akan menemukan `roblox-plugin/WeppyRobloxMCP.rbxm` dan panduan instalasi
+
+Catatan:
+- Basic menggunakan paket plugin yang sama dengan kebijakan Basic (Studio -> Local satu arah)
+- Setelah lisensi langganan Pro aktif, sync dua arah dan fitur lanjutan yang lebih luas akan terbuka
 
 ## 2. Instal Plugin
 
 1. Jalankan **Roblox Studio**
-2. Klik tab **Plugins** di menu atas
-3. Klik tombol **Plugins Folder**
+2. Klik tab **Plugins**
+3. Klik **Plugins Folder**
 
 ![Buka Plugins Folder](../../assets/screenshots/plugins_menu.png)
 
-4. **Salin** file `WeppyRobloxMCP.rbxm` dari folder yang diekstrak ke folder Plugins yang terbuka
+4. **Salin** `WeppyRobloxMCP.rbxm` ke folder Plugins
 5. **Restart Roblox Studio**
 
 ## 3. Verifikasi Instalasi
 
-Setelah restart, tombol **W-MCP** akan muncul di tab Plugins.
+Setelah restart, tombol **W-MCP** muncul di tab Plugins.
 
 ![Tombol W-MCP](../../assets/screenshots/weppy_plugin_toolbar.png)
 
@@ -28,7 +33,7 @@ Setelah restart, tombol **W-MCP** akan muncul di tab Plugins.
 
 ### Persiapan
 
-MCP server harus sudah terinstal. Selesaikan panduan yang sesuai dengan aplikasi AI yang Anda gunakan terlebih dahulu:
+MCP server harus sudah terinstal. Selesaikan dulu panduan app AI yang Anda pakai:
 
 | Aplikasi AI | Panduan Instalasi |
 |-------------|-------------------|
@@ -42,38 +47,38 @@ MCP server harus sudah terinstal. Selesaikan panduan yang sesuai dengan aplikasi
 ### Menghubungkan
 
 1. Buka proyek apa saja di **Roblox Studio**
-2. Tab **Plugins** di atas → Klik **W-MCP**
-3. Klik tombol **Connect** di jendela plugin
-4. Jika status **"Connected"** ditampilkan, koneksi berhasil!
+2. Tab **Plugins** -> **W-MCP**
+3. Klik **Connect**
+4. Jika status **"Connected"** tampil, koneksi berhasil
 
 ![Layar Utama Plugin](../../assets/screenshots/plugin_main.png)
 
 ## 5. Pengaturan (Opsional)
 
-Klik tombol pengaturan di kanan atas plugin untuk mengubah berbagai opsi.
+Gunakan tombol pengaturan di kanan atas plugin.
 
 ![Layar Pengaturan](../../assets/screenshots/settings.png)
 
-- **Auto Connect**: Otomatis terhubung ke MCP server saat Studio dimulai
-- **Auto Reconnect**: Otomatis mencoba menghubungkan kembali jika koneksi terputus
-- **Auto Camera Focus**: Kamera otomatis bergerak ke objek yang dibuat
-- **Language**: Ubah bahasa UI plugin
+- **Auto Connect**
+- **Auto Reconnect**
+- **Auto Camera Focus**
+- **Language**
 
 ## Pemecahan Masalah
 
 ### Plugin tidak terlihat
 
-- Tutup Roblox Studio sepenuhnya lalu restart
-- Pastikan file sudah disalin dengan benar ke Plugins Folder
-- Pastikan file `.rbxm` tidak rusak
+- Restart Roblox Studio sepenuhnya
+- Pastikan file sudah disalin benar
+- Pastikan `.rbxm` tidak rusak
 
 ### Tidak dapat terhubung
 
-- Pastikan MCP server berjalan di aplikasi AI
-- Klik tombol **Connect** lagi di plugin
-- Pastikan port 3002 tidak digunakan oleh program lain
+- Pastikan MCP server berjalan
+- Klik **Connect** lagi
+- Cek konflik port 3002
 
 ### Koneksi sering terputus
 
-- Aktifkan opsi **Auto Reconnect** di pengaturan
-- Coba restart aplikasi AI
+- Aktifkan **Auto Reconnect**
+- Restart app AI

package/docs/id/pro-upgrade.md

@@ -2,50 +2,56 @@
 
 ## Mengapa Pro?
 
-**Hemat Token AI** - Satu perintah operasi massal menggantikan puluhan operasi individual. Penggunaan token berkurang karena tugas berulang diminimalkan dan hasilnya lebih cepat.
+### Sync dua arah untuk alur kerja pengembangan nyata
 
-**Game yang Lebih Lengkap** - Dengan tools terrain, environment, asset, dan spatial, Anda dapat membuat dunia game yang lengkap, bukan hanya prototipe.
+Pro Sync melampaui sekadar export satu arah. Edit script secara lokal dan kirim ke Studio. Buat perubahan di Studio dan tarik kembali ke disk. Pro menjaga keduanya tetap sinkron.
 
-## Tools yang Ditambahkan Pro
+- **Sync dua arah** — Perubahan mengalir dua arah antara Studio dan file lokal.
+- **Direction per tipe** — Atur arah secara independen untuk Scripts, Values, Containers, Data, dan Services.
+- **Apply Mode per tipe** — Pilih Auto atau Manual per tipe untuk menyeimbangkan kecepatan dan kontrol.
+- **Full Sync / Resync** — Bangun ulang state proyek yang bersih setelah perubahan besar atau reconnect.
+- **Riwayat Perubahan** — Lacak apa yang berubah, kapan, dan ke arah mana sebelum menerapkan.
+- **Sync multi-place** — Sync hingga 3 Roblox Place sekaligus, masing-masing dengan penyimpanan terisolasi dan riwayat perubahan sendiri.
 
-| Kategori | Fungsi |
-|----------|--------|
-| **Operasi Massal** | Buat 100 pohon dengan satu perintah. Ubah semua part secara bersamaan. |
-| **Pembuatan Terrain** | Hasilkan gunung, gua, dan lanskap secara prosedural. |
-| **Manajemen Asset** | Cari di Creator Store lalu sisipkan model langsung. |
-| **Raycast** | Temukan posisi spawn, deteksi tabrakan, analisis area yang dapat dilalui. |
-| **Kontrol Environment** | Atur pencahayaan, atmosfer, langit, dan waktu hari. |
-| **Visualisasi** | Tampilkan area, buat marker, sorot zona. |
+### Hemat token AI dengan workflow berdampak tinggi
 
-## Cara Pembelian
+Aksi massal dan lanjutan mengurangi panggilan berulang — lakukan lebih banyak per prompt.
 
-### Langkah 1: Beli di Gumroad
+### Kemampuan lanjutan yang lebih luas
 
-1. Kunjungi [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/chllph?utm_source=github&utm_medium=repo&utm_campaign=sunity_plugin)
-2. Unduh plugin
+Pembuatan terrain, pencarian aset, analisis spasial, animasi, audio, dan otomasi skala produksi.
 
-### Langkah 2: Instal Plugin
+## Langganan dan unduhan
 
-1. Jalankan Roblox Studio
-2. Tab Plugins → Klik **Plugins Folder**
-3. **Hapus** `WeppyRobloxMCP.rbxm` (versi Basic) yang ada
-4. **Salin** `WeppyRobloxMCP-Pro.rbxm` yang diunduh ke folder
-5. Restart Roblox Studio
+### Langkah 1: Berlangganan di Gumroad
+
+1. Buka [Gumroad - Weppy Roblox Plugin](https://gumroad.com/l/faccjs?utm_source=github&utm_medium=repo&utm_campaign=pro_upgrade_md)
+2. Selesaikan pembelian lisensi langganan Pro
+
+### Langkah 2: Unduh dari GitHub Releases
+
+1. Buka [GitHub Releases](https://github.com/hope1026/roblox-mcp/releases/latest)
+2. Unduh `weppy-roblox-mcp-v{version}.zip`
+3. Ekstrak lalu salin `roblox-plugin/WeppyRobloxMCP.rbxm` ke folder Plugins Roblox
 
 ### Langkah 3: Verifikasi
 
-1. Buka plugin W-MCP
-2. Periksa apakah badge "Pro" ditampilkan
-3. Semua tools dapat digunakan!
+1. Buka W-MCP di Roblox Studio
+2. Pastikan badge Pro terlihat
+3. Jalankan aksi Pro (misalnya: `manage_sync` atau operasi massal)
 
 ## Perbandingan Fitur
 
 | Fitur | Basic | Pro |
 |-------|:-----:|:---:|
-| Instance, Script, Property | ✅ Akses penuh | ✅ Akses penuh |
+| Manajemen Script, Instance, Property | ✅ Akses penuh | ✅ Akses penuh |
 | Selection, Tag, Camera, Log | ✅ Akses penuh | ✅ Akses penuh |
-| Operasi Massal (Bulk) | ― | ✅ Tanpa batas |
-| Pencarian & Penyisipan Asset | ― | ✅ Tanpa batas |
-| Pembuatan Terrain | ― | ✅ Tanpa batas |
-| Environment, Raycast, Spatial | ― | ✅ Tanpa batas |
-| Tools Visualisasi | ― | ✅ Tanpa batas |
+| Arah Sync | Studio → Local (satu arah) | Dua arah |
+| Sync Direction per tipe | ❌ | ✅ Scripts / Values / Containers / Data / Services |
+| Apply Mode per tipe | ❌ | ✅ Auto / Manual |
+| Full Sync | ❌ | ✅ |
+| Resync / Bangun ulang state | ❌ | ✅ |
+| Riwayat Perubahan | ❌ | ✅ |
+| Sync multi-place | ❌ | ✅ Hingga 3 place dengan penyimpanan terisolasi |
+| Cakupan tools lanjutan | Set dasar | Set lanjutan lebih luas |
+| Efisiensi token AI | Standar | Lebih efisien dengan aksi massal / berdampak tinggi |

package/docs/id/tools/overview.md

@@ -2,6 +2,10 @@
 
 Hubungkan AI dengan Roblox Studio dan otomatiskan berbagai pekerjaan. Berikut adalah hal-hal yang bisa kamu lakukan berdasarkan kategori.
 
+Kebijakan Sync:
+- Basic: Studio -> Local (satu arah)
+- Pro: Sync dua arah + cakupan fitur lanjutan lebih luas (efisiensi token AI lebih baik lewat operasi massal)
+
 ---
 
 ## Basic (Gratis)

package/docs/ja/README.md

@@ -53,6 +53,12 @@ Creator Storeから無料モデルとアセットを検索して、すぐにゲ
 
 5分で終わります。👉 [インストールガイド](installation/README.md)
 
+## Proで始めよう
+
+制限なく制作しましょう。双方向Sync、高度な制作機能、AIトークン効率 — 一度のアップグレードで全てを手に入れる。
+
+👉 [Proアップグレードガイド](pro-upgrade.md)
+
 ## リンク
 
 - [GitHub](https://github.com/hope1026/roblox-mcp)

package/docs/ja/installation/README.md

@@ -29,11 +29,11 @@ GitHubからプラグインファイルをダウンロードして、Roblox Stud
 | AIアプリ | 設定方法 |
 |---------|---------|
 | Claude Code | [設定手順](ai-apps/claude-code.md) |
-| Cline | [設定手順](ai-apps/cline.md) |
-| Roo Code | [設定手順](ai-apps/roo-code.md) |
-| Cursor | [設定手順](ai-apps/cursor.md) |
-| Zed | [設定手順](ai-apps/zed.md) |
-| その他のMCP対応アプリ | [設定手順](ai-apps/other-mcp-clients.md) |
+| Claude Desktop | [設定手順](ai-apps/claude-app.md) |
+| Codex CLI | [設定手順](ai-apps/codex-cli.md) |
+| Codex Desktop | [設定手順](ai-apps/codex-app.md) |
+| Gemini CLI | [設定手順](ai-apps/gemini-cli.md) |
+| Antigravity | [設定手順](ai-apps/antigravity.md) |
 
 > 上記のリストにないAIアプリでも、MCPをサポートしていれば使用できます。MCPサーバーコマンド: `npx -y @weppy/roblox-mcp`
 

package/docs/ja/installation/ai-apps/gemini-cli.md

@@ -1,4 +1,4 @@
-# Gemini CLI 設定
+# Gemini CLI セットアップ
 
 [Google Gemini CLI](https://github.com/google-gemini/gemini-cli)でRoblox MCPを使用する方法です。
 
@@ -9,18 +9,34 @@
    node --version
    ```
 
-2. **Gemini CLI** がインストール済み
+2. **Gemini CLI** インストール済み
    ```bash
    npm install -g @google/gemini-cli
    ```
 
-3. **Roblox Studioプラグイン** のインストール完了
+3. **Roblox Studioプラグイン** インストール完了
 
 ## MCPサーバーの登録
 
-### 方法1: 設定ファイルの編集 (推奨)
+### 方法1: CLIコマンド（推奨）
 
-`.gemini/settings.json` ファイルに以下の内容を追加してください:
+ターミナルで1行で登録できます：
+
+```bash
+gemini mcp add weppy-roblox-mcp npx --trust -- -y @weppy/roblox-mcp
+```
+
+> `--trust`フラグは、ツール呼び出し時の確認プロンプトをスキップします。
+
+グローバル設定として登録するには、`-s user`を追加してください：
+
+```bash
+gemini mcp add weppy-roblox-mcp npx -s user --trust -- -y @weppy/roblox-mcp
+```
+
+### 方法2: 設定ファイルの編集
+
+`.gemini/settings.json`ファイルに以下の内容を追加してください：
 
 ```json
 {
@@ -34,15 +50,21 @@
 ```
 
 **設定ファイルの場所:**
-| 範囲 | パス |
-|------|------|
+| スコープ | パス |
+|----------|------|
 | プロジェクト | `<プロジェクト>/.gemini/settings.json` |
 | グローバル | `~/.gemini/settings.json` |
 
-### 方法2: 環境変数の使用
+### 方法3: 環境変数の使用
+
+特定の環境変数が必要な場合：
 
-特定の環境変数が必要な場合:
+**CLI:**
+```bash
+gemini mcp add weppy-roblox-mcp npx --trust -e MCP_PORT=3002 -- -y @weppy/roblox-mcp
+```
 
+**設定ファイル:**
 ```json
 {
   "mcpServers": {
@@ -59,67 +81,38 @@
 
 ## 接続テスト
 
-1. **Roblox Studio** を起動 → Pluginsタブ → **W-MCP** → **Connect**
-2. **Gemini CLI** を起動して以下を入力:
+1. **Roblox Studio**を起動 → Pluginsタブ → **W-MCP** → **Connect**
+2. **Gemini CLI**を実行して次のように入力：
    ```
    Roblox Studioで現在選択されているものを教えて
    ```
 
-## MCPサーバー状態の確認
+## MCPサーバーの状態確認
 
-Gemini CLI内で `/mcp` コマンドを使用して接続されているサーバーの状態を確認できます:
+Gemini CLI内で`/mcp`コマンドを使用して、接続されたサーバーの状態を確認できます：
 
 ```
 /mcp
 ```
 
-## 詳細設定
-
-### ツールのフィルタリング
-
-特定のツールのみを使用したり、除外したりできます:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"],
-      "excludeTools": ["execute_script"],
-      "includeTools": ["get_selection", "create_instance", "set_property"]
-    }
-  }
-}
-```
-
-> `excludeTools` は `includeTools` より優先されます。
-
-### デバッグモード
-
-接続の問題をデバッグするには:
-
-```bash
-gemini --debug
-```
-
 ## トラブルシューティング
 
 ### サーバーが起動しない場合
 
-MCPサーバーを直接実行してエラーを確認してください:
+MCPサーバーを直接実行してエラーを確認してください：
 ```bash
 npx -y @weppy/roblox-mcp
 ```
 
 ### 接続失敗
 
-- Roblox Studioプラグインが **Connected** 状態か確認
+- Roblox Studioプラグインが**Connected**状態であることを確認
 - ポート3002がファイアウォールでブロックされていないか確認
-- `/mcp` コマンドでサーバー状態を確認
+- `/mcp`コマンドでサーバーの状態を確認
 
 ### ツールの競合
 
-複数のMCPサーバーで同じ名前のツールがある場合、`serverAlias__toolName` 形式でプレフィックスが付きます。
+複数のMCPサーバーに同じ名前のツールがある場合、`serverAlias__toolName`形式でプレフィックスが付けられます。
 
 ## 参考資料