Conecte um cliente MCP local

O que o MCP faz no GBA Studio

MCP é uma ponte para que um cliente local, como o Codex, consulte o projeto aberto no GBA Studio e use esse contexto para responder melhor às suas perguntas. Em vez de enviar arquivos manualmente, você pode pedir um resumo, uma revisão ou um diagnóstico com os dados do próprio projeto.

A integração atual é local e funciona por stdio. Cada projeto precisa autorizar o acesso, e a automação disponível hoje é de consulta: ela ajuda a investigar e organizar o trabalho sem alterar os arquivos do jogo.

Antes de começar

• Tenha o GBA Studio instalado e um projeto salvo no formato .gba-project. O MCP fica desligado até você autorizar esse projeto.
• Use um cliente MCP compatível instalado localmente. O Codex é o primeiro cliente validado neste fluxo; outros clientes ainda precisam ser verificados individualmente.
• Os instaladores da beta incluem o Engine Pack e as ferramentas de build. O orçamento técnico usa esse componente.
• Comece autorizando um único projeto e confirme o resultado antes de repetir a configuração em outros projetos.

Autorize o acesso no projeto

1. 1

   Salve ou abra o projeto que você quer consultar.

2. 2

   Abra Ajustes e entre na seção Avançado > MCP local.

3. 3

   Ative o MCP local e salve o projeto novamente.

4. 4

   Clique em Copiar configuração e registre essa configuração no seu cliente MCP.

Conecte o cliente local

1. 1

   Depois de salvar o projeto, use Copiar configuração na seção MCP local.

2. 2

   No seu cliente compatível, adicione a configuração copiada como um servidor MCP local.

3. 3

   Reconecte o cliente e confirme que ele consegue iniciar o GBA Studio para esse projeto.

4. 4

   Se você trocar de projeto, copie a configuração novamente para não apontar o cliente para a pasta errada.

O que você pode fazer com o MCP

• Usar gbs_project_summary para entender a estrutura, as cenas, os assets e os recursos do projeto.
• Usar gbs_project_diagnostics para encontrar referências quebradas e problemas do contrato do projeto.
• Usar gbs_list_assets para localizar imagens, mapas, sprites, áudio e outros recursos importados.
• Usar gbs_inspect_asset para examinar um asset específico dentro da pasta autorizada.
• Usar gbs_project_budget para consultar o orçamento técnico quando o Engine Pack estiver disponível.

Faça pedidos que geram respostas úteis

O MCP funciona melhor quando o pedido tem um objetivo claro e aponta para uma decisão que você precisa tomar. Peça primeiro uma leitura do estado do projeto e depois aprofunde em uma cena, asset ou diagnóstico específico.

• “Resuma meu projeto e me diga quais cenas estão conectadas.”
• “Liste as referências quebradas e explique em que parte do jogo elas aparecem.”
• “Encontre os assets que parecem não estar sendo usados.”
• “Inspecione o asset do personagem principal e descreva o formato e os dados disponíveis.”
• “Consulte o orçamento do projeto e aponte os recursos que merecem atenção.”

Mantenha os limites claros

O servidor é local, funciona por stdio e é somente leitura. Ele não abre um servidor HTTP, não edita o projeto, não exporta ROMs e não executa comandos enviados pelo cliente. O cliente também só deve enxergar o projeto que você autorizou.

• Se o MCP estiver desligado, as consultas retornam MCP_DISABLED até você ativá-lo e reconectar o cliente.
• A inspeção de assets respeita a pasta do projeto e não deve ser usada para abrir caminhos externos ou arquivos fora dela.
• O orçamento depende do Engine Pack e pode não estar disponível em uma instalação sem esse componente.

Se a conexão não funcionar

1. 1

   Abra o projeto correto no GBA Studio, confirme que MCP local está ativado e salve novamente.

2. 2

   Copie uma configuração nova e substitua a configuração antiga no cliente.

3. 3

   Reconecte o cliente depois de reiniciar o GBA Studio ou trocar a pasta do projeto.

4. 4

   Se apenas o orçamento falhar, confirme se o Engine Pack está instalado e disponível no cliente local.