Shiny Gen

npx add-mcp 'https://mcp.shinygen.ai/mcp'

Conecte o Claude ou o ChatGPT ao Shiny Gen

O Shiny Gen inclui um servidor MCP hospedado em https://mcp.shinygen.ai/mcp. Conecte um assistente de IA (Claude, ChatGPT ou qualquer cliente MCP) e ele poderá criar, editar e testar seu projeto Shiny Gen, ao vivo no seu navegador. Não há nada para instalar: ao contrário de integrações MCP que fazem ponte com um mecanismo de desktop rodando na sua máquina, o servidor do Shiny Gen é remoto e opera o projeto na sua aba aberta do navegador.

MCP (Model Context Protocol) é um padrão aberto que permite que assistentes de IA usem ferramentas externas. O Shiny Gen expõe seus editores e modelos de geração como ferramentas MCP.

Conectar

1. Comece a hospedar no Shiny Gen: abra seu jogo em shinygen.ai, abra a aba Agente, toque no nome do modelo para abrir o seletor de modelos de IA, escolha Conectar modelo externo com MCP e pressione Hospedar Agente Externo. O aplicativo mostra "Aguardando sua IA conectar". Seu assistente não pode conectar até que você faça isso, uma vez por sessão, e os passos para cada cliente aparecem ali mesmo no aplicativo.
2. Claude (web ou desktop): adicione um conector personalizado em Configurações e cole a URL do servidor: https://mcp.shinygen.ai/mcp
3. Claude Code:

   claude mcp add --transport http shinygen https://mcp.shinygen.ai/mcp
   

4. ChatGPT ou qualquer outro cliente MCP: adicione a mesma URL onde seu cliente configura conectores ou servidores MCP.
5. Aprove o acesso: seu navegador abre uma página de consentimento do Shiny Gen. Entre e aprove. A autorização usa OAuth, e você pode desconectar a qualquer momento.
6. Mantenha o Shiny Gen aberto: o assistente opera sua sessão ao vivo, então o aplicativo deve permanecer aberto enquanto ele trabalha. A hospedagem permanece aberta enquanto o aplicativo estiver aberto.

Crie seu próprio cliente MCP

Você não precisa do Claude ou do ChatGPT. Qualquer programa que fale MCP pode conectar, incluindo um agente de IA que escreve seu próprio cliente em código. Tudo é padrão, então um SDK MCP padrão resolve:

• Transporte: HTTP Streamable em https://mcp.shinygen.ai/mcp.
• Login: OAuth 2.1 com PKCE (S256). Uma solicitação sem token recebe um 401 cujo cabeçalho WWW-Authenticate aponta para o documento de descoberta, https://mcp.shinygen.ai/.well-known/oauth-protected-resource.
• Registro: clientes se registram em https://mcp.shinygen.ai/oauth/register. Apenas clientes públicos: não há segredo de cliente.
• Endereço de retorno: o URI de redirecionamento deve ser https, ou loopback http (127.0.0.1, localhost ou [::1]) para um cliente que captura o redirecionamento em uma porta local. O código de autorização é válido por dois minutos.
• Aprovação: a página de consentimento tem seu próprio formulário de login, então o navegador que aprova não precisa executar o aplicativo.
• A hospedagem é por conta, não por máquina: a aba que pressionou Hospedar Agente Externo pode estar em um computador diferente do cliente. Entre na mesma conta em ambos os lugares.

Compartilhamento: get_share_link retorna um link para o jogo, e esse link o abre para seu proprietário quando ele está conectado. Não aceita opções e não pode mudar quem mais pode abrir o jogo, por design. Para deixar outras pessoas entrarem, abra o jogo no Shiny Gen, pressione Compartilhar e escolha Somente Jogar ou Jogar e Duplicar.

Se seu agente tem seu próprio computador

Tudo acima assume que a pessoa está na sua própria aba do Shiny Gen quando sua IA conecta. Alguns agentes não são construídos assim: eles têm sua própria máquina e seu próprio navegador, sem interface de conector para colar uma URL, e sem jeito de completar um login como outra pessoa. Para esses, a pessoa pode entregar uma sessão em vez disso.

1. No Shiny Gen, eles criam um link de sessão de agente. Na tela +, vale por um novo jogo, ou um remix de um jogo que eles têm permissão de remixar. No seletor de modelos, com um jogo aberto, vale por aquele jogo. Eles escolhem quanto tempo dura: uma hora ou vinte e quatro horas.
2. Eles enviam o link. Ele se parece com https://shinygen.ai/agent_session#.... A parte depois do # é um código de uso único. Navegadores nunca enviam essa parte para um servidor, então ela fica entre a pessoa e o agente.
3. O agente abre o link inteiro em um navegador. Se ele pode executar código, ele pode fazer isso: um Chromium headless que seu próprio código inicia (Playwright ou Puppeteer) é um navegador real aqui, e a página tem scripts de copiar-e-colar para isso. Buscar o link como texto dá instruções e nada mais, de propósito. A página usa o código uma vez, dentro de uma hora de sua criação, vai direto para um editor do Shiny Gen rodando naquele navegador, e deixa um token MCP no armazenamento daquele navegador.
4. O agente conecta seu cliente MCP a https://mcp.shinygen.ai/mcp com Authorization: Bearer <token>. Não há etapa de registro, página de consentimento, nem nada para pressionar no aplicativo: criar o link foi a permissão.

Tal sessão funciona em o jogo que recebeu e jogos que cria para a pessoa (create_game move a sessão para o novo jogo, open_game volta). Ela pode ler os outros jogos da pessoa e o catálogo público com browse_games, list_game_files e read_game_file, nunca alterando-os e nunca alcançando o jogo privado de outra pessoa. Não pode alcançar configurações, compras ou a conta, e o servidor recusa tudo isso quer o aplicativo ofereça ou não. Gems funcionam exatamente como sempre: o mesmo limite diário, a mesma mesada, o mesmo interruptor para desligar gastos do agente. Um link de novo jogo só cria um novo jogo: não pode assumir um que a conta já tem, e se o nome estiver ocupado, o jogo simplesmente recebe um nome único. Um link de remix abre uma cópia, e o original nunca é alterado. O agente deve chamar get_context primeiro: ele diz para qual jogo a sessão é, quais ferramentas estão indisponíveis e por quê, e quantas gems restam hoje.

A pessoa continua no comando. As sessões que ela distribuiu estão listadas em Acesso e gastos do agente com um botão Revogar, que é o único jeito de encerrar uma sessão manualmente. Abrir o jogo por conta própria não a encerra: ela pode jogar e olhar enquanto o agente trabalha. Enquanto uma sessão de agente trabalha em um jogo, esse jogo abre somente leitura para a pessoa, então os dois não podem se sobrescrever. Uma conta tem uma sessão de agente por vez, então usar um link mais novo encerra a sessão mais antiga, e até 10 links não usados podem ficar esperando de uma vez.

Se o agente já resgatou o link

O link funciona uma vez. O token não: ele é a sessão, e é válido até a sessão expirar ou a pessoa encerrá-la. Um agente cujo navegador foi fechado, redefinido ou destruído entre turnos não precisa de um novo convite.

1. Abra https://shinygen.ai/agent_session/resume e cole o token MCP. Esse endereço não carrega código nem token: a página envia o token como um cabeçalho Authorization. É também o que toda resposta no_live_tab devolve como resume_url, ao lado do id do jogo, do nome do jogo e do momento em que o token expira.
2. Ou faça diretamente: POST https://api.shinygen.ai/agent_session/resume com Authorization: Bearer <token>. A resposta é o mesmo objeto que o resgate retornou.
3. Apenas duas respostas significam que um novo convite é necessário: session_revoked e token_expired.

Um agente também deve chamar save_game como a última ferramenta de cada turno. Cada escrita salva por conta própria, mas save_game só retorna quando a nuvem tem o jogo, e seu cloud_md5 é a impressão digital da cópia que a pessoa baixa. Isso importa mais para agentes cujo sandbox termina com o turno.

Se a conexão falhar

• O assistente diz que o Shiny Gen não está hospedando um agente externo: pressione Hospedar Agente Externo no aplicativo (o primeiro passo acima) e conecte novamente. Se o Shiny Gen foi fechado ou perdeu a conexão, a hospedagem parou junto: pressione o botão de novo.
• Nenhuma janela de login apareceu, e o cliente diz que a conexão falhou: seu navegador quase certamente está bloqueando o pop-up. Clientes abrem a página de login do Shiny Gen em uma nova janela, e um pop-up bloqueado geralmente aparece como um erro genérico de conexão. Permita pop-ups para o site do seu cliente de IA e conecte novamente.
• Verifique se a URL inclui o caminho: o endereço do servidor é https://mcp.shinygen.ai/mcp. O host sozinho não é o endpoint.
• O assistente diz que o acesso do agente está desligado: "Permitir que agentes de IA conectem" está desligado para sua conta. A página de consentimento oferece religar, ou ligue no aplicativo em Acesso e gastos do agente.

Permissões

Escopo	O que permite
projects.read	Ver seu projeto: o que está na tela, o documento focado e seu estado atual.
projects.write	Escrever e editar código do jogo e documentos de assets. Edições de código são gratuitas.
assets.generate	Executar geração de IA (imagens, e modelos 3D, arte 2D, partituras de áudio e comportamento escrito como código); isso gasta suas gems, e um limite diário de gems limita quanto um assistente conectado pode gastar em um dia.

O que um assistente conectado pode fazer

• Ler o que está na tela e qual documento está focado.
• Escrever ou corrigir o GDScript do jogo; o jogo compila, roda e reporta erros de volta com números de linha.
• Iniciar um novo jogo para você, listar os jogos na sua conta e abrir qualquer um deles — então você pode dizer "volte para o jogo de plataforma" e ele volta.
• Tirar capturas de tela para ver o que você vê, incluindo rajadas de quadros para verificar movimento.
• Pressionar teclas e ações no jogo em execução para testar o que construiu, incluindo linhas do tempo de entrada inteiras quando um jogo precisa de dois controles ao mesmo tempo.
• Gerar imagens com os modelos de geração do Shiny Gen, transformar uma imagem em um modelo 3D texturizado ou uma folha de sprites animada, navegar e restaurar versões anteriores de um asset e remover o fundo de uma imagem.
• Construir e editar modelos 3D, arte 2D, partituras de áudio e comportamento por entidade como código, e renderizar visualizações de um modelo para verificá-lo. Cada um desses formatos pode ser escrito pelo próprio assistente de graça, ou gerado a partir de uma descrição por gems, e de qualquer jeito o que você recebe é um documento que você e ele podem continuar editando. As mesmas duas maneiras se aplicam a mudar algo que já existe: o assistente edita o documento por conta própria de graça, ou tem um modelo escrevendo a revisão por gems, e o que volta ainda é um documento daquele tipo — música continua uma partitura, um desenho continua um desenho que você pode editar, não uma imagem chapada dele.
• Obter um link de compartilhamento para o jogo em que esteve trabalhando.

O que custa, e os limites

Conectar é grátis, e escrever código é sempre grátis — apenas geração de IA gasta gems. Dois limites separados se aplicam a um assistente trabalhando no seu projeto:

• Um limite diário de gems. Limita quantas gems um assistente conectado pode gastar em um único dia, então um assistente deixado rodando não pode drenar seu saldo. Cada resultado pago reporta suas gems antes, gastas e restantes.
• Uma mesada semanal de ações no plano gratuito. Sua primeira conexão inicia um teste de conector completo de 30 dias. Depois disso, contas gratuitas recebem uma mesada de ações de assistente que mudam algo (escrever código, gerar, rodar o jogo) por semana, atualmente 300, reiniciando toda segunda-feira (UTC). Leitura nunca é limitada, e qualquer um que fez uma compra não está sujeito a essa mesada de forma alguma. O conector reporta seu status atual e quando a mesada reinicia.

O agente de IA embutido no aplicativo

Você não precisa de um assistente externo: o Shiny Gen tem seu próprio agente de IA embutido no aplicativo, com as mesmas habilidades descritas nesta página — ele lê seu projeto, escreve código do jogo, gera assets e testa o que constrói. Conecte o Claude ou o ChatGPT quando preferir dirigir de uma ferramenta que você já usa; caso contrário, o agente no aplicativo está bem ali.

Ambos funcionam do mesmo jeito onde importa: geração gasta gems, e o limite diário de gems e a mesada semanal do plano gratuito se aplicam a ambos. A diferença é quem roda o modelo. Um assistente externo roda no seu próprio plano de IA, então editar código não gasta gems. O modelo do agente embutido roda no Shiny Gen, então cada passo de chat gasta gems; o seletor de modelos mostra quanto cada modelo custa.

A documentação viaja com o conector

Uma vez conectado, o assistente recebe automaticamente as referências de linguagem do Shiny Gen e a superfície exata da API para código do jogo, servidas pelo próprio conector. Você não precisa ensinar nada ao seu assistente nem colar documentação; ele consulta o contrato enquanto trabalha.

Segurança

• As permissões são limitadas e revogáveis; desconecte-se a qualquer momento.
• Tudo o que o assistente faz acontece na sua aba aberta; você acompanha as edições ao vivo e pode pausar ou interromper pelo aplicativo.
• Escrever código é gratuito; apenas a geração por IA consome gems, com um limite diário de gems para assistentes conectados. Cada geração informa seu saldo restante.

Dúvidas? Veja a seção MCP das Perguntas Frequentes ou entre em contato com o suporte.

Última atualização: 8 de outubro de 2026