@weppy/roblox-mcp 2.5.0 → 2.6.0

package/docs/pt-br/installation/ai-apps/antigravity.md

@@ -1,89 +0,0 @@
-# Configuração do Antigravity
-
-Como usar o Roblox MCP com o [Google Antigravity](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/).
-
-> **Antigravity** é a plataforma de desenvolvimento baseada em agentes do Google, em que agentes de IA realizam tarefas complexas de forma autônoma alternando entre edição de código, terminal e navegador.
-
-## Pré-requisitos
-
-1. **Antigravity** instalado (consulte a documentação oficial para SO suportados/requisitos)
-2. **Node.js** (v18.0.0 ou superior, `npx` disponível)
-3. **Plugin do Roblox Studio** instalado
-
-## Registrar servidor MCP
-
-No Antigravity, os servidores MCP são gerenciados no **painel do agente (Agent pane)**.
-
-### Registro manual via raw config (recomendado)
-
-1. No painel do agente, clique em **⋯** → **MCP Servers** → **Manage MCP Servers** → **View raw config**
-
-![Abrir menu MCP Servers](../../../assets/screenshots/antigravity/antigravity_mcp_services_menu.png)
-
-2. No JSON exibido, adicione/mescle o conteúdo abaixo:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-![Editar raw config](../../../assets/screenshots/antigravity/antigravity_mcp_raw.png)
-
-3. Após salvar, faça **Refresh** (ou reinicie/atualize conforme a UI orientar)
-
-> O caminho/nome real do arquivo de configuração pode variar conforme o SO e a versão do Antigravity. Sempre edite com base no local indicado em **View raw config**.
-
-### Opção: Ajustar porta/logs via variáveis de ambiente
-
-Recomendamos manter o padrão (HTTP `127.0.0.1:3002`). Se necessário, você pode definir variáveis de ambiente assim:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"],
-      "env": {
-        "HTTP_HOST": "127.0.0.1",
-        "HTTP_PORT": "3002",
-        "LOG_LEVEL": "INFO"
-      }
-    }
-  }
-}
-```
-
-## Teste de conexão
-
-1. Abra o **Roblox Studio** → aba Plugins → **WEPPY** → **Connect**
-2. No **Antigravity**, digite:
-   ```
-   Diga-me o que está selecionado atualmente no Roblox Studio
-   ```
-
-## Solução de problemas
-
-### Se o servidor não iniciar
-
-Execute o servidor MCP diretamente para verificar o erro:
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### Falha na conexão
-
-- Verifique se o plugin do Roblox Studio está em **Connected**
-- Verifique se a porta **3002** não está bloqueada pelo firewall
-- Verifique o status do servidor no painel do agente **⋯** → **MCP Servers**
-- (Avançado) Se você alterou `HTTP_PORT`, o plugin/bridge do Roblox Studio também precisa usar a mesma porta.
-
-## Materiais de referência
-
-- [Introdução ao Google Antigravity](https://developers.googleblog.com/build-with-google-antigravity-our-new-agentic-development-platform/)
-- [Guia de primeiros passos do Antigravity (Codelab)](https://codelabs.developers.google.com/getting-started-google-antigravity)

package/docs/pt-br/installation/ai-apps/claude-app.md

@@ -1,78 +0,0 @@
-# Configuracao do Claude Desktop App
-
-Como usar o Roblox MCP no [Claude Desktop App](https://claude.ai/download).
-
-## Pre-requisitos
-
-- **Claude Desktop App** instalado
-- **Node.js** (v18.0.0 ou superior)
-- **Plugin do Roblox Studio** instalado
-
-## Registrar o Servidor MCP
-
-### Metodo 1: Desktop Extensions (Recomendado)
-
-> A partir de 2026, instalacao com um clique disponivel como extensoes de navegador
-
-1. Claude Desktop → **Settings** → **Extensions**
-2. Pesquise por `weppy-roblox-mcp`
-3. Clique em **Install**
-
-### Metodo 2: Editar Arquivo de Configuracao Diretamente
-
-1. Claude Desktop → **Settings** → **Developers** → Clique em **Edit Config**
-
-2. Adicione o seguinte conteudo ao arquivo `claude_desktop_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-3. **Feche completamente** o Claude Desktop e reinicie
-
-**Localizacao do arquivo de configuracao:**
-
-| SO | Caminho |
-|----|---------|
-| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
-| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
-
-## Teste de Conexao
-
-1. Inicie o **Roblox Studio** → Aba Plugins → **WEPPY** → **Connect**
-2. Inicie uma nova conversa no **Claude Desktop** e teste:
-   ```
-   Crie uma parte azul no Roblox Studio
-   ```
-
-## Solucao de Problemas
-
-### O servidor MCP nao carrega
-
-1. **Verifique a sintaxe JSON**: Valide o arquivo de configuracao com um validador JSON online
-2. **Reinicie completamente o Claude Desktop**: Apos alterar as configuracoes, sempre feche completamente o aplicativo e reinicie
-3. **Verifique o caminho**: Confirme se command e args estao corretos
-
-### O servidor nao inicia
-
-Execute o servidor MCP diretamente para verificar erros:
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### Falha na conexao
-
-- Verifique se o plugin do Roblox Studio esta no estado **Connected**
-- Verifique se a porta 3002 nao esta bloqueada pelo firewall
-
-## Referencias
-
-- [Guia Oficial de MCP do Claude Desktop](https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop)
-- [Guia de Conexao de Servidor MCP](https://modelcontextprotocol.io/docs/develop/connect-local-servers)

package/docs/pt-br/installation/ai-apps/claude-code.md

@@ -1,104 +0,0 @@
-# Configuracao do Claude Code
-
-Como usar o Roblox MCP no [Claude Code](https://claude.ai/code) (ferramenta de codificacao com IA baseada em terminal).
-
-## Pre-requisitos
-
-- **Claude Code** instalado
-- **Plugin do Roblox Studio** instalado
-
-## Instalacao
-
-```bash
-npm install -g @anthropic-ai/claude-code
-```
-
-## Registrar o Servidor MCP
-
-### Metodo 1: Instalar pelo Marketplace (Recomendado)
-
-Execute no terminal do Claude Code:
-
-```bash
-# Adicionar marketplace
-/plugin marketplace add hope1026/weppy-roblox-mcp
-
-# Instalar plugin
-/plugin install weppy-roblox-mcp@hope1026-roblox-mcp
-```
-
-Verificar instalacao:
-```bash
-/plugin list
-```
-
-### Metodo 2: Editar Arquivo de Configuracao Diretamente
-
-Crie o arquivo `.mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-**Localizacao do arquivo de configuracao:**
-
-| Escopo | Caminho |
-|--------|---------|
-| Projeto | `<projeto>/.mcp.json` |
-| Global | `~/.claude/mcp.json` |
-
-## Gerenciamento Automatico do Servidor
-
-O Claude Code gerencia o servidor MCP automaticamente:
-
-- Inicia automaticamente quando necessario
-- Para automaticamente ao encerrar a sessao
-- Nenhuma configuracao adicional necessaria
-
-## Teste de Conexao
-
-1. Inicie o **Roblox Studio** → Aba Plugins → **WEPPY** → **Connect**
-2. Teste no **Claude Code**:
-   ```
-   Crie uma parte azul no Roblox Studio
-   ```
-
-## Solucao de Problemas
-
-### Falha na instalacao do plugin
-
-```bash
-# Limpe o cache e tente novamente
-/plugin cache clear
-/plugin install weppy-roblox-mcp@hope1026-roblox-mcp
-```
-
-### O servidor nao inicia
-
-1. Verifique a versao do Node.js (requer 18.0 ou superior):
-   ```bash
-   node --version
-   ```
-
-2. Teste iniciando o servidor manualmente:
-   ```bash
-   npx -y @weppy/roblox-mcp
-   ```
-
-### Ferramentas MCP nao aparecem
-
-Verifique no Claude Code:
-```
-Mostre a lista de ferramentas MCP disponiveis
-```
-
-## Referencias
-
-- [Documentacao Oficial do Claude Code](https://docs.anthropic.com/claude-code)

package/docs/pt-br/installation/ai-apps/codex-app.md

@@ -1,56 +0,0 @@
-# Configuracao do Codex App
-
-Como usar o Roblox MCP no [OpenAI Codex App](https://openai.com/codex/) (macOS).
-
-> **Lancado em 2 de fevereiro de 2026** - Aplicativo nativo para macOS que suporta fluxos de trabalho multi-agentes
-
-## Pre-requisitos
-
-- **Codex App** instalado (macOS)
-- **Plugin do Roblox Studio** instalado
-
-## Registrar o Servidor MCP
-
-### Sincronizacao Automatica com Configuracao do Codex CLI
-
-Se voce ja configurou o MCP no Codex CLI, pode usar **diretamente no aplicativo sem configuracao adicional**.
-
-```
-O historico de sessao e as configuracoes do CLI sao automaticamente sincronizados com o aplicativo.
-```
-
-### Para Nova Configuracao
-
-Adicione em **Settings** → **MCP Servers** no aplicativo:
-
-```
-Server name: weppy-roblox-mcp
-Command: npx -y @weppy/roblox-mcp
-```
-
-## Teste de Conexao
-
-1. Inicie o **Roblox Studio** → Aba Plugins → **WEPPY** → **Connect**
-2. Inicie uma nova conversa no **Codex App** e teste:
-   ```
-   Diga-me o que esta selecionado atualmente no Roblox Studio
-   ```
-
-## Solucao de Problemas
-
-### O servidor nao inicia
-
-Execute o servidor MCP diretamente para verificar erros:
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### Falha na conexao
-
-- Verifique se o plugin do Roblox Studio esta no estado **Connected**
-- Verifique se a porta 3002 nao esta bloqueada pelo firewall
-
-## Referencias
-
-- [Introducao ao Codex App](https://openai.com/index/introducing-the-codex-app/)
-- [Documentacao Oficial de MCP do Codex](https://developers.openai.com/codex/mcp/)

package/docs/pt-br/installation/ai-apps/codex-cli.md

@@ -1,67 +0,0 @@
-# Configuracao do Codex CLI
-
-Como usar o Roblox MCP no [OpenAI Codex CLI](https://github.com/openai/codex) (ferramenta de codificacao com IA baseada em terminal).
-
-## Pre-requisitos
-
-- **Node.js** (v18.0.0 ou superior)
-- **Plugin do Roblox Studio** instalado
-
-## Instalacao
-
-```bash
-npm install -g @openai/codex
-```
-
-## Registrar o Servidor MCP
-
-### Metodo 1: Comando CLI (Recomendado)
-
-```bash
-codex mcp add weppy-roblox-mcp -- npx -y @weppy/roblox-mcp
-```
-
-### Metodo 2: Editar Arquivo de Configuracao Diretamente
-
-Adicione o seguinte conteudo ao arquivo `~/.codex/config.toml`:
-
-```toml
-[mcp_servers.weppy-roblox-mcp]
-command = "npx"
-args = ["-y", "@weppy/roblox-mcp"]
-```
-
-**Localizacao do arquivo de configuracao:**
-
-| SO | Caminho |
-|----|---------|
-| macOS/Linux | `~/.codex/config.toml` |
-| Windows | `%USERPROFILE%\.codex\config.toml` |
-
-## Teste de Conexao
-
-1. Inicie o **Roblox Studio** → Aba Plugins → **WEPPY** → **Connect**
-2. Inicie o **Codex CLI** e digite:
-   ```
-   Diga-me o que esta selecionado atualmente no Roblox Studio
-   ```
-
-## Solucao de Problemas
-
-### O servidor nao inicia
-
-Execute o servidor MCP diretamente para verificar erros:
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### Falha na conexao
-
-- Verifique se o plugin do Roblox Studio esta no estado **Connected**
-- Verifique se a porta 3002 nao esta bloqueada pelo firewall
-
-## Referencias
-
-- [GitHub do Codex CLI](https://github.com/openai/codex)
-- [Documentacao Oficial de MCP do Codex](https://developers.openai.com/codex/mcp/)
-- [Referencia de Configuracao do Codex](https://developers.openai.com/codex/config-reference/)

package/docs/pt-br/installation/ai-apps/cursor.md

@@ -1,77 +0,0 @@
-# Configuração do Cursor
-
-Como usar o Roblox MCP com [Cursor](https://cursor.com/).
-
-## Pré-requisitos
-
-- **Cursor** instalado
-- **Node.js** (v18.0.0 ou superior)
-- **Plugin do Roblox Studio** instalado
-
-## Registrar o servidor MCP
-
-### Método 1: Configuração do projeto
-
-Adicione o seguinte em `.cursor/mcp.json` dentro do seu projeto:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-### Método 2: Configuração global
-
-Adicione o mesmo conteúdo ao arquivo global de configuração do Cursor.
-
-**Locais do arquivo de configuração:**
-
-| Escopo | Caminho |
-|--------|---------|
-| Projeto | `<projeto>/.cursor/mcp.json` |
-| Global (macOS/Linux) | `~/.cursor/mcp.json` |
-| Global (Windows) | `%USERPROFILE%\\.cursor\\mcp.json` |
-
-> Se o arquivo já existir, mescle a entrada `weppy-roblox-mcp` dentro do objeto `mcpServers`.
-
-### Aplicar alterações
-
-Depois de editar a configuração, recarregue a janela do Cursor ou reinicie o aplicativo.
-
-## Teste de conexão
-
-1. Abra o **Roblox Studio** → aba Plugins → **WEPPY** → **Connect**
-2. No **Cursor**, digite:
-   ```
-   Tell me what's currently selected in Roblox Studio
-   ```
-
-## Solução de problemas
-
-### O servidor MCP não aparece
-
-- Verifique se o caminho do arquivo de configuração está correto
-- Confirme que a sintaxe JSON está válida
-- Recarregue o Cursor após editar a configuração
-
-### O servidor não inicia
-
-Execute o servidor MCP diretamente para verificar erros:
-
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### Falha na conexão
-
-- Verifique se o plugin do Roblox Studio está no estado **Connected**
-- Confira se a porta 3002 está bloqueada pelo firewall
-
-## Referência
-
-- [Documentação do Cursor MCP](https://docs.cursor.com/context/model-context-protocol)

package/docs/pt-br/installation/ai-apps/gemini-cli.md

@@ -1,120 +0,0 @@
-# Configuração do Gemini CLI
-
-Como usar o Roblox MCP com [Google Gemini CLI](https://github.com/google-gemini/gemini-cli).
-
-## Pré-requisitos
-
-1. **Node.js** (v18.0.0 ou superior)
-   ```bash
-   node --version
-   ```
-
-2. **Gemini CLI** instalado
-   ```bash
-   npm install -g @google/gemini-cli
-   ```
-
-3. **Plugin do Roblox Studio** instalado
-
-## Registrar servidor MCP
-
-### Método 1: Comando CLI (Recomendado)
-
-Registre com um único comando no terminal:
-
-```bash
-gemini mcp add weppy-roblox-mcp npx --trust -- -y @weppy/roblox-mcp
-```
-
-> A flag `--trust` ignora as solicitações de confirmação para cada chamada de ferramenta.
-
-Para registrar globalmente, adicione `-s user`:
-
-```bash
-gemini mcp add weppy-roblox-mcp npx -s user --trust -- -y @weppy/roblox-mcp
-```
-
-### Método 2: Editar arquivo de configuração
-
-Adicione o seguinte conteúdo ao arquivo `.gemini/settings.json`:
-
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"]
-    }
-  }
-}
-```
-
-**Localizações do arquivo de configuração:**
-| Escopo | Caminho |
-|--------|---------|
-| Projeto | `<projeto>/.gemini/settings.json` |
-| Global | `~/.gemini/settings.json` |
-
-### Método 3: Usando variáveis de ambiente
-
-Se variáveis de ambiente específicas forem necessárias:
-
-**CLI:**
-```bash
-gemini mcp add weppy-roblox-mcp npx --trust -e HTTP_PORT=3002 -- -y @weppy/roblox-mcp
-```
-
-**Arquivo de configuração:**
-```json
-{
-  "mcpServers": {
-    "weppy-roblox-mcp": {
-      "command": "npx",
-      "args": ["-y", "@weppy/roblox-mcp"],
-      "env": {
-        "HTTP_PORT": "3002"
-      }
-    }
-  }
-}
-```
-
-## Teste de conexão
-
-1. Abra o **Roblox Studio** → aba Plugins → **WEPPY** → **Connect**
-2. Execute o **Gemini CLI** e digite:
-   ```
-   Me diga o que está selecionado atualmente no Roblox Studio
-   ```
-
-## Verificar status do servidor MCP
-
-Você pode verificar o status dos servidores conectados com o comando `/mcp` no Gemini CLI:
-
-```
-/mcp
-```
-
-## Solução de problemas
-
-### Servidor não inicia
-
-Execute o servidor MCP diretamente para verificar erros:
-```bash
-npx -y @weppy/roblox-mcp
-```
-
-### Falha na conexão
-
-- Verifique se o plugin do Roblox Studio está no estado **Connected**
-- Verifique se a porta 3002 está bloqueada por um firewall
-- Verifique o status do servidor com o comando `/mcp`
-
-### Conflitos de ferramentas
-
-Se vários servidores MCP tiverem ferramentas com o mesmo nome, elas receberão o prefixo no formato `serverAlias__toolName`.
-
-## Referências
-
-- [Documentação oficial do Gemini CLI MCP](https://geminicli.com/docs/tools/mcp-server/)
-- [Guia de configuração do Gemini CLI](https://geminicli.com/docs/get-started/configuration/)

package/docs/pt-br/installation/roblox-explorer.md

@@ -1,58 +0,0 @@
-# WEPPY Roblox Explorer (Extensão VSCode)
-
-Visualização em árvore de instâncias similar ao Explorer do Roblox Studio, dentro do VSCode. Navegue por instâncias sincronizadas, abra scripts diretamente e acompanhe o status de sincronização sem sair do editor.
-Esta é uma extensao complementar do WEPPY, e não uma integração Roblox independente.
-
-![WEPPY Roblox Explorer](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
-
-## Requisitos
-
-- VSCode 1.85+
-- [Roblox MCP](../../../README.md) instalado com Sync habilitado (Basic ou Pro)
-- O Sync ja gerou `weppy-project-sync/place_*/.sync-meta.json` na raiz do projeto
-
-## Instalação
-
-Pesquise **WEPPY Roblox Explorer** na barra lateral de Extensões do VSCode (`Ctrl+Shift+X` / `Cmd+Shift+X`) e clique em **Install**.
-
-Ou instale diretamente por um destes marketplaces:
-
-- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
-- [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer)
-
-A navegação basica da arvore funciona a partir dos arquivos sincronizados em disco. Status sync ao vivo, indicadores de direction e envio de telemetria do Explorer ficam disponiveis quando o servidor MCP local está acessivel.
-
-## Funcionalidades
-
-- **Árvore de instâncias**: Hierarquia de serviços/instâncias idêntica ao Roblox Studio
-- **Ícones de classes Roblox**: Mais de 200 ícones com suporte a temas escuro/claro
-- **Multi-Place**: Raízes de árvore separadas por Place sincronizado
-- **Abrir ao clicar**: Abre arquivos de suporte (`.server.luau`, `.client.luau`, `.module.luau`, `.props.json`)
-- **Pesquisa de instâncias**: Pesquisa QuickPick em todos os serviços
-- **Badges de status Sync**: Visualize os estados `modified`, `studio`, `conflict` de relance
-- **Atualização automática**: A árvore é atualizada automaticamente quando os arquivos Sync mudam (debounce 500ms)
-- **Copiar caminho de instância**: Clique com o botão direito para copiar caminhos no formato `game.Workspace.Part`
-
-## Configurações
-
-| Configuração | Padrão | Descrição |
-|--------------|--------|-----------|
-| `robloxExplorer.syncRoot` | `""` | Caminho absoluto para a raiz do `weppy-project-sync`. Se estiver vazio, e detectado automaticamente. O WEPPY usa `{projectRoot}/weppy-project-sync`. |
-| `robloxExplorer.hidePropsFiles` | `false` | Oculta arquivos de Sync (`.props.json`, `_tree.json`, `.value.json`) no explorador padrão do VSCode. |
-| `robloxExplorer.autoRefresh` | `true` | Atualiza automaticamente a árvore quando os arquivos Sync mudam. |
-| `robloxExplorer.showSyncStatus` | `true` | Exibe decorações de status Sync nos itens da árvore. |
-
-## Comandos
-
-| Comando | Descrição |
-|---------|-----------|
-| `WEPPY Explorer: Refresh` | Atualizar manualmente a árvore de instâncias |
-| `WEPPY Explorer: Search Instances` | Pesquisar instâncias em todos os serviços |
-| `WEPPY Explorer: Open Backing File` | Abrir o arquivo de suporte de uma instância selecionada |
-| `WEPPY Explorer: Copy Instance Path` | Copiar o caminho completo da instância (ex. `game.Workspace.Part`) |
-| `WEPPY Explorer: Reveal in Explorer` | Mostrar o arquivo no explorador padrão do VSCode |
-
-## Relacionado
-
-- [Guia detalhado de Sync](../sync/overview.md)
-- [Guia de instalação](README.md)