@weppy/roblox-mcp 2.5.1 → 2.6.0

package/docs/pt-br/dashboard/sync.md

@@ -1,68 +0,0 @@
-# Sync
-
-> Monitore o status atual, configuracao de direcao e logs da sincronizacao Studio <-> arquivos locais.
-
-![Sync — status de sincronizacao, configuracao de direcao, logs](../../assets/screenshots/dashboard/dashboard_sync.png)
-
-> Para o guia detalhado da funcionalidade Sync em si, consulte o [Guia detalhado de Sync](../sync/overview.md).
-
-## Visao geral
-
-A pagina Sync exibe visualmente o status atual e as configuracoes da sincronizacao Studio <-> arquivos locais. So fica acessivel quando o dashboard esta em estado **Studio conectado**.
-
-## Sync Status
-
-Exibe o status atual da sincronizacao:
-
-| Status | Significado |
-|--------|-------------|
-| **Idle** | Aguardando sincronizacao |
-| **Initializing** | Sincronizacao inicial em andamento |
-| **Syncing** | Sincronizacao incremental em andamento |
-| **Error** | Erro de sincronizacao ocorrido |
-
-O card de status tambem exibe o caminho de sincronizacao, a quantidade de instancias sincronizadas e o modo de aplicacao atual (Auto/Manual).
-
-## Sync Directions
-
-Exibe em tabela a direcao de sincronizacao por tipo:
-
-| Coluna | Descricao |
-|--------|-----------|
-| Type | Tipo do alvo de sincronizacao (Scripts, Values, Instances, Data, Services) |
-| Direction | Direcao da sincronizacao (Local -> Studio, Studio -> Local) |
-| Apply Mode | Modo de aplicacao (Auto/Manual) |
-
-Verifique a direcao de sincronizacao de cada tipo para entender em qual sentido as alteracoes sao refletidas.
-
-## Sync Log
-
-Exibe os eventos de sincronizacao em ordem cronologica. Cada entrada de log inclui uma tag de tipo de alteracao (create, update, delete, etc.) e o caminho do alvo.
-
-## Casos de uso
-
-### Verificacao do status de sincronizacao
-
-```
-"Quero verificar se o Sync esta funcionando corretamente"
-```
-
-Confirme se o Sync Status esta Idle e verifique no Sync Log se as alteracoes recentes foram registradas normalmente.
-
-### Identificacao da direcao de sincronizacao
-
-```
-"Quero saber em qual direcao as alteracoes de script sao sincronizadas"
-```
-
-Verifique a Direction do tipo Scripts na tabela Sync Directions.
-
-## Documentos relacionados
-
-- [WEPPY Dashboard Overview](overview.md)
-- [Changelog](changelog.md)
-- [Connection](connection.md)
-- [Playtest](playtest.md)
-- [Tools](tools.md)
-- [Settings](settings.md)
-- [Guia detalhado de Sync](../sync/overview.md)

package/docs/pt-br/dashboard/tools.md

@@ -1,69 +0,0 @@
-# Tools
-
-> Verifique o historico e as estatisticas das ferramentas MCP executadas pela IA.
-
-![Tools — historico de execucao e estatisticas das ferramentas](../../assets/screenshots/dashboard/dashboard_tools.png)
-
-## Visao geral
-
-A pagina Tools fornece o historico e as estatisticas das ferramentas MCP executadas pela IA. E composta por duas sub-abas: **History** e **Statistics**. Esta sempre acessivel quando o dashboard esta em estado **Servidor conectado** ou **Studio conectado**.
-
-## Aba History
-
-Exibe o historico de execucao das ferramentas em tabela cronologica:
-
-| Coluna | Descricao |
-|--------|-----------|
-| Time | Horario de execucao |
-| Tool.Action | Ferramenta e acao executadas (ex.: `query_instances.get_instance`) |
-| Duration | Tempo de execucao |
-| Status | Status do resultado (OK/Error) |
-| Tier | Tier utilizado (Basic/Pro) |
-
-Funcionalidades:
-- Dropdown **Tool filter** para filtrar uma ferramenta especifica
-- Paginacao para navegar por grandes volumes de registros
-- Adicao de novos registros de execucao em tempo real
-
-## Aba Statistics
-
-Analisa visualmente as estatisticas de uso das ferramentas:
-
-- **Distribuicao por tier** — Proporcao de uso de ferramentas Basic/Pro
-- **Estatisticas por ferramenta** — Quantidade de chamadas e tempo medio de resposta de cada ferramenta
-- **Analise por acao** — Estatisticas detalhadas por acao dentro de cada ferramenta
-
-## Funcionalidades exclusivas do tier Basic
-
-Para usuarios do tier Basic, uma UI adicional e exibida:
-
-- **Tier Usage Progress** — Barra de progresso de uso
-- **Modal comparativo Basic vs Pro** — Apresenta as funcionalidades adicionais do tier Pro
-
-## Casos de uso
-
-### Analise de desempenho de ferramentas
-
-```
-"Quero saber qual ferramenta demora mais"
-```
-
-Verifique o tempo medio de resposta por ferramenta na aba Statistics.
-
-### Rastreamento de erros
-
-```
-"Quero saber por que a ferramenta que acabei de executar falhou"
-```
-
-Encontre o item com Status Error na aba History para verificar as informacoes detalhadas.
-
-## Documentos relacionados
-
-- [WEPPY Dashboard Overview](overview.md)
-- [Changelog](changelog.md)
-- [Connection](connection.md)
-- [Sync](sync.md)
-- [Playtest](playtest.md)
-- [Settings](settings.md)
-- [Lista completa de Tools](../tools/overview.md)

package/docs/pt-br/explorer/overview.md

@@ -1,104 +0,0 @@
-# Guia detalhado do WEPPY Roblox Explorer
-
-O **WEPPY Roblox Explorer** e uma extensao complementar para VSCode / Antigravity que replica a arvore do Explorer do Roblox Studio dentro do seu editor. Navegue por instancias sincronizadas, abra scripts e edite propriedades sem precisar alternar entre o Studio e o editor.
-
-> **Opcional** — o Explorer nao e obrigatorio. O servidor MCP e o plugin do Roblox Studio sao suficientes para usar todos os recursos principais. Instale o Explorer quando quiser navegar pela estrutura do projeto ou inspecionar e editar propriedades diretamente do editor.
-
-![WEPPY Roblox Explorer — arvore de instancias do Studio exibida na barra lateral do VSCode](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
-
-## Por que usar o Explorer
-
-Agentes de IA ja conseguem entender o contexto completo do projeto a partir dos arquivos gerados pelo Sync, mas quando um humano navega pelo mirror os caminhos de arquivo sozinhos nem sempre deixam a hierarquia clara. O Explorer reutiliza os mesmos dados de sync e os apresenta com a **mesma arvore que voce ve no Roblox Studio**, o que facilita muito:
-
-- Ver de relance a qual servico / instancia um script pertence
-- Localizar rapidamente instancias entre servicos por nome ou caminho
-- Verificar o status de sync por arquivo (modified / studio / conflict)
-- Editar propriedades sem abrir o Studio
-
-## Requisitos
-
-- VSCode 1.85+ ou Antigravity
-- [Roblox MCP](../installation/README.md) instalado com Sync habilitado (Basic ou Pro)
-- Um arquivo `weppy-project-sync/place_*/.sync-meta.json` gerado pelo Sync na raiz do projeto
-
-O Explorer funciona apenas com os arquivos de sync em disco. Quando o servidor MCP local esta em execucao, o estado de sync ao vivo e as informacoes de direction tambem sao refletidos.
-
-## Instalacao
-
-Procure por **WEPPY Roblox Explorer** na barra lateral de Extensions (`Ctrl+Shift+X` / `Cmd+Shift+X`) do VSCode ou Antigravity e clique em **Install**.
-
-Links diretos dos 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)
-
-## Navegando pela arvore de instancias
-
-Apos a instalacao, uma visao **WEPPY Explorer** aparece na Activity Bar do VSCode e descobre automaticamente o diretorio de sync a partir da raiz do projeto.
-
-- **Raizes de servicos**: Servicos sincronizados como `Workspace`, `ReplicatedStorage` e `ServerScriptService` aparecem no nivel superior.
-- **Icones de classes Roblox**: Mais de 200 icones no estilo do Studio que alternam automaticamente entre tema escuro e claro.
-- **Multi Place**: Cada Place sincronizado e mostrado com sua propria raiz de arvore quando ha varios places.
-- **Atualizacao automatica**: A arvore e atualizada com um debounce de 500ms sempre que arquivos de sync mudam.
-- **Badges de status de sync**: Os estados `modified`, `studio` e `conflict` aparecem ao lado dos icones para voce notar mudancas e conflitos na hora.
-
-Clicar em um item da arvore abre o arquivo que respalda a instancia (`.server.luau`, `.client.luau`, `.module.luau`, `.props.json`, ...). O menu de contexto permite copiar o caminho da instancia no formato `game.Workspace.Part` ou revelar o arquivo no explorador padrao do VSCode.
-
-## Painel de propriedades
-
-Selecione uma instancia na arvore do Explorer e execute **Open Properties** para abrir um painel parecido com a janela Properties do Studio. Voce pode inspecionar e editar propriedades agrupadas sem mexer diretamente no arquivo `.props.json`.
-
-![Painel de propriedades — edite propriedades no estilo Studio dentro do VSCode](../../assets/screenshots/roblox-explorer/roblox-explorer-property-window.png)
-
-- **Exibicao agrupada**: As propriedades sao organizadas nos mesmos grupos do Studio (Appearance, Behavior, Data, Part, Transform etc.).
-- **Editores por tipo**: Os widgets de entrada combinam com o tipo da propriedade — numeros, strings, booleanos, cores, Vector3, enums e muito mais.
-- **Edicao baseada em arquivo**: As mudancas sao escritas no arquivo `*.props.json` da instancia e retornam ao Studio pelo caminho reverso do Sync (Pro, quando bidirectional esta ativado).
-- **Editor personalizado**: Abrir um arquivo `.props.json` diretamente carrega o Painel de propriedades em vez do editor de texto padrao.
-
-Se voce quiser que o Painel de propriedades abra automaticamente enquanto navega pela arvore, defina `robloxExplorer.propertyPanel.autoOpen` como `true` nas configuracoes.
-
-## Busca de instancias
-
-Execute o comando `WEPPY Explorer: Search Instances` (pelo icone do titulo da visao ou pela Command Palette) para abrir um QuickPick que busca em todos os servicos sincronizados.
-
-- Correspondencia parcial sobre os nomes de instancia
-- Selecionar um resultado foca a arvore no item correspondente
-- Quando varios places estao sincronizados, os resultados sao delimitados por place
-
-## Configuracoes
-
-| Configuracao | Padrao | Descricao |
-|--------------|--------|-----------|
-| `robloxExplorer.mcpBaseUrl` | `""` | URL HTTP base do MCP local. Vazio faz o Explorer tentar `http://127.0.0.1:3002` e depois `http://127.0.0.1:3003`. |
-| `robloxExplorer.syncRoot` | `""` | Caminho absoluto para a raiz `weppy-project-sync`. Descoberto automaticamente pelas pastas do workspace quando vazio. |
-| `robloxExplorer.hidePropsFiles` | `false` | Oculta os arquivos de sync (`.props.json`, `_tree.json`, `.value.json`) no explorador padrao do VSCode. |
-| `robloxExplorer.autoRefresh` | `true` | Atualiza automaticamente a arvore quando arquivos de sync mudam. |
-| `robloxExplorer.showSyncStatus` | `true` | Mostra decoracoes de status de sync nos itens da arvore. |
-| `robloxExplorer.followFocusCue` | `false` | Segue arquivos externos de focus cue para expandir a arvore e abrir arquivos relacionados. |
-| `robloxExplorer.propertyPanel.autoOpen` | `false` | Abre o Painel de propriedades automaticamente ao selecionar uma instancia na arvore. |
-
-## Comandos
-
-| Comando | Descricao |
-|---------|-----------|
-| `WEPPY Explorer: Refresh` | Atualiza manualmente a arvore de instancias |
-| `WEPPY Explorer: Search Instances` | Busca instancias em todos os servicos |
-| `WEPPY Explorer: Open Backing File` | Abre o arquivo da instancia selecionada |
-| `WEPPY Explorer: Open Properties` | Abre o Painel de propriedades da instancia selecionada |
-| `WEPPY Explorer: Copy Instance Path` | Copia o caminho completo da instancia (ex.: `game.Workspace.Part`) |
-| `WEPPY Explorer: Reveal in Explorer` | Mostra o arquivo no explorador padrao do VSCode |
-| `WEPPY Explorer: Collapse All` | Recolhe todos os nos da arvore |
-| `WEPPY Explorer: Open Settings` | Abre a pagina de configuracoes do Explorer |
-
-## Solucao de problemas
-
-- **Arvore vazia**: Verifique se o diretorio `weppy-project-sync/place_*` existe e se o Sync completou pelo menos um Full Sync. Defina `robloxExplorer.syncRoot` manualmente se necessario.
-- **Status de sync nao aparece**: Confirme que o servidor MCP local esta em execucao e tente definir `robloxExplorer.mcpBaseUrl` de forma explicita.
-- **Painel de propriedades nao abre**: Se um arquivo `.props.json` abrir no editor de texto padrao, clique com o direito sobre ele e escolha **Reopen Editor With... → WEPPY Property Panel**.
-- **Icones quebrados**: Selecione novamente o tema do VSCode ou reinicie a janela para atualizar o cache de icones.
-
-## Documentos relacionados
-
-- [Guia de instalacao do Roblox MCP](../installation/README.md)
-- [Guia de Sync](../sync/overview.md)
-- [Visao geral das ferramentas](../tools/overview.md)

package/docs/pt-br/installation/README.md

@@ -1,93 +0,0 @@
-# Guia de Instalação
-
-Para usar o Roblox MCP você precisa instalar **duas coisas**.
-
-```
-App de IA (Claude, Codex, Gemini, etc.)
-       │
-   Servidor MCP ← Aqui os comandos da IA são convertidos para o formato do Roblox
-       │
-Plugin Roblox Studio ← Executa os comandos dentro do Studio
-```
-
-Quando o app de IA diz "cria uma parte azul", o servidor MCP converte o pedido e o plugin do Roblox Studio cria a parte de verdade.
-
----
-
-## Instalação em um comando (Recomendado)
-
-Instale tudo com um único comando:
-
-**macOS / Linux**
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
-```
-
-**Windows (PowerShell)**
-
-```powershell
-irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
-```
-
-Reinicie o Roblox Studio — pronto!
-
-O registro automático de MCP suporta **Claude Code, Claude Desktop, Cursor, Codex CLI/App, Gemini CLI e Antigravity**.
-
-Se a execução do PowerShell estiver bloqueada no Windows, siga a instalação manual abaixo. Se estiver usando o pacote ZIP, você também pode executar `setup-plugin.bat` e `setup-mcp.bat`.
-
----
-
-## Instalação manual
-
-Se a instalacao em um comando nao funcionar, ou quando a instalacao automatica nao puder ser usada no seu ambiente, use a instalacao manual abaixo como alternativa.
-
-### Passo 1: Instalar plugin do Roblox Studio
-
-Baixe o arquivo do plugin no GitHub e coloque na pasta Plugins do Roblox Studio.
-
-👉 [Guia de instalação do plugin](https://weppyai.com/en/install#plugin)
-
----
-
-### Passo 2: Registrar servidor MCP no app de IA
-
-Registre o servidor MCP no seu app de IA. Funciona com qualquer app que suporte MCP.
-
-| App de IA | Guia de Instalação |
-|-----------|-------------------|
-| Claude Code | [Como Configurar](ai-apps/claude-code.md) |
-| Claude Desktop | [Como Configurar](ai-apps/claude-app.md) |
-| Cursor | [Como Configurar](ai-apps/cursor.md) |
-| Codex CLI | [Como Configurar](ai-apps/codex-cli.md) |
-| Codex Desktop | [Como Configurar](ai-apps/codex-app.md) |
-| Gemini CLI | [Como Configurar](ai-apps/gemini-cli.md) |
-| Antigravity | [Como Configurar](ai-apps/antigravity.md) |
-
-> Apps de IA que não estão na lista também funcionam se suportarem MCP. O comando do servidor MCP é `npx -y @weppy/roblox-mcp`.
-
----
-
-## Opcional: Instalar WEPPY Roblox Explorer (Extensão VSCode)
-
-Navegue pelas árvores de instâncias sincronizadas dentro do VSCode com ícones de classes Roblox.
-Esta extensao opcional exige que a instalacao do Roblox MCP acima ja esteja concluida, porque o Explorer le os dados de Sync em `weppy-project-sync` dentro da raiz do projeto.
-
-👉 [Guia de instalação do WEPPY Roblox Explorer](https://weppyai.com/en/install#explorer)
-
-Instalação direta:
-- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
-- [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer)
-
----
-
-## Depois da instalação
-
-1. Abra o **Roblox Studio** e na aba Plugins clique em **WEPPY** → **Connect**
-2. No **app de IA** teste assim:
-
-```
-Crie uma parte azul no Roblox Studio
-```
-
-Se a parte aparecer, a instalação está completa!

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/)