RAE AI · MCP
Primeiros passos com o RAE AI
O MCP conecta seu agente de IA ao editor RAE em execução. Descreva a tarefa com suas palavras: o agente pode ler e alterar os dados do jogo pelo editor.
Versão rápida — 3 passos
Reinicie o RAE
Abra os arquivos do jogo e mantenha o editor aberto.
Reinicie seu agente
Nova conversa: Codex → GPT 6 Astra ou Claude Code → Opus 5.5, medium.
Envie o pedido abaixo
Clique em ‘Copiar pedido’, cole na conversa do agente e envie.
Primeiro pedido: verificar a conexão
Use a skill rae-mcp e a conexão RAE MCP. Verifique a conexão com rae_status. Mostre a instância do RAE conectada, os arquivos do jogo abertos e as operações disponíveis. Não altere nem salve nada. Se não houver conexão, informe isso.
A resposta deve listar os arquivos realmente abertos e o estado do RAE. Confira os caminhos do seu projeto. Se o agente apenas explicar o MCP, peça que execute rae_status pela ferramenta conectada.
Começar
Reinicie o RAE e o agente
Após instalar o MCP, feche completamente e abra novamente o RAE e o agente selecionado. Execute ambos no mesmo computador Windows e na mesma conta de usuário da instalação. Mantenha o RAE aberto.
Abra os dados do jogo
Abra os dados do projeto no RAE, como elements.data. Para missões, loja ou spawns, abra os arquivos correspondentes. Uma cópia do projeto é útil para experimentar as primeiras alterações.
Inicie uma nova conversa
Abra o Codex, Claude Code ou outro agente conectado. Escolha o modelo e cole o pedido abaixo. Se o agente solicitar acesso às ferramentas rae, permita para esta tarefa.
Exemplos de pedidos
Substitua 12345 e o nome pelos seus valores. Revise o plano e os registros afetados. Aplicar altera os dados no editor; salvar grava os arquivos originais e pode incluir alterações manuais ainda não salvas. O RAE AI trabalha com arquivos, não com o servidor do jogo em execução. Publicar as alterações é uma etapa separada.
Encontrar um item e suas fontes
Pelo RAE MCP, encontre o item ‘NOME DO ITEM’. Se houver vários resultados, mostre os IDs para eu escolher. Para o item escolhido, descubra onde pode ser obtido e onde é usado. Informe os arquivos verificados e os dados ausentes. Não altere nada.
Entender uma missão
Pelo RAE MCP, encontre a missão de ID 12345 e explique os requisitos, as condições de conclusão e as recompensas. Verifique referências a itens e NPCs nos dados disponíveis. Informe problemas e relações não verificadas. Não altere nada.
Preparar uma alteração de preço
Pelo RAE MCP, encontre a oferta da loja para o item de ID 12345. Se houver variantes, mostre-as primeiro. Para a escolhida, prepare uma redução de 20% do preço atual. Mostre os preços antigo e novo com unidades e os arquivos afetados. Apenas prévia: não aplique nem salve.
Criar um item a partir de outro
Pelo RAE MCP, prepare uma cópia do item de ID 12345 chamada ‘Recompensa do evento’, com um ID livre atribuído automaticamente. Preserve o original. Mostre o que será copiado e quais referências serão mantidas. Apenas prévia, sem aplicar nem salvar.
Revisar → aplicar → salvar
Aplique o plano apresentado pelo RAE MCP se ainda estiver atualizado. Se os dados mudaram, mostre uma nova prévia. Depois, releia os registros alterados e informe o resultado. Ainda não salve os arquivos.
Resolver problemas
O RAE precisa estar aberto? O agente o inicia?
Sim. Inicie o RAE e mantenha-o aberto durante o trabalho. O servidor MCP funciona dentro do editor; o agente se conecta ao endereço local. A instalação adiciona a conexão e a skill, mas não inicia o RAE automaticamente. Ao fechar o RAE, o MCP fica indisponível. O agente pode abrir arquivos compatíveis pelo RAE já em execução.
O agente não encontra o RAE MCP
Confira se selecionou esse agente na instalação e reinicie-o completamente. Procure a conexão rae nas configurações de MCP. Se não existir, repita a instalação pelo menu RAE AI. O instalador configura o perfil local; sessões remotas ou na nuvem não se conectam automaticamente.
O RAE não responde
Verifique se o RAE está aberto e a licença AI está ativa. Leia o aviso do instalador ou do RAE: se o Windows negou a reserva do endereço MCP, siga a correção indicada. Com várias instâncias, confira a instância e os caminhos do primeiro pedido.
Arquivo ausente ou alteração bloqueada
Peça a lista de arquivos disponíveis pelo RAE MCP e o motivo exato da restrição em rae_status. Abra o arquivo no RAE ou peça ao agente que o selecione entre os encontrados. O suporte depende do formato, versão e build. Não contorne a restrição editando arquivos diretamente.
Usando o Cursor
No instalador, clique em ‘Cursor: copy User Rules text’ e cole em Cursor → Customize → Rules. Reinicie o Cursor e execute o primeiro pedido.
Salvar ou desfazer
Para salvar: ‘Salve os arquivos alterados pelo RAE MCP e informe a verificação; antes, liste outras alterações não salvas que serão incluídas.’ Para desfazer: ‘Liste os grupos recentes de alterações do RAE e prepare a reversão do grupo [nome].’ Confira o grupo e possíveis conflitos.