Conecte o Claude ou o Cursor à Cinevva (servidor MCP)

A Cinevva oferece um servidor MCP hospedado que permite ao Claude, Claude Code, Cursor ou qualquer cliente MCP criar seus jogos. A IA que você já usa se torna o cérebro: ela lê e edita os arquivos dos seus jogos diretamente em nossos servidores, sem precisar manter uma aba do navegador aberta. Abra também seu jogo no criador da Cinevva e a sessão entrará ao vivo: a IA poderá importar recursos da nossa biblioteca CC0, criar rigs e animar modelos 3D, capturar telas, simular comandos para testar o jogo em execução e atualizar a prévia enquanto cada alteração aparece na sua tela.

O que você precisa

Uma conta da Cinevva (a gratuita funciona; a criação de rigs 3D consome créditos do seu saldo) e um cliente MCP que ofereça suporte a servidores remotos com OAuth. A URL do servidor é:

https://api.cinevva.com/create/mcp

Ele usa Streamable HTTP e autenticação com OAuth 2.0. Quando você se conecta, seu cliente abre uma página de login da Cinevva no navegador. Autorize o acesso uma vez e o cliente permanecerá conectado.

Edite de qualquer lugar. Entre ao vivo para acompanhar e testar.

Para editar arquivos, basta a conexão. As ferramentas de arquivos leem e gravam a cópia oficial dos seus jogos em nossos servidores. Assim, seu assistente pode corrigir um bug ou adicionar um recurso mesmo sem nenhuma aba da Cinevva aberta. Informe o nome do jogo desejado (ou deixe a IA escolher entre seus jogos) e faça seus pedidos.

Entrar ao vivo é uma opção a mais, não uma exigência. Abra o jogo em cinevva.com/create, aguarde o carregamento da prévia e clique em Agente externo na barra de ferramentas do criador (o ícone de plugue, também disponível no menu "mais" em telas pequenas). O painel muda para "Agente ao vivo" quando a conexão é estabelecida. Uma sessão ao vivo dá à IA olhos e mãos sobre o jogo em execução: capturas de tela, logs do console, comandos simulados, importação de recursos e criação de rigs 3D. Ela também transmite cada edição para sua tela assim que é aplicada, seja a alteração feita por essa aba ou sem interface aberta. O vínculo ao vivo permanece ativo em visitas futuras até você clicar em "Encerrar sessão ao vivo".

A ferramenta list_live_sessions mostra o que está conectado e, quando exatamente um jogo está aberto, ele é selecionado automaticamente.

Configuração no Claude (claude.ai e aplicativo para desktop)

1. Abra Configurações, depois Conectores, e escolha "Adicionar conector personalizado".
2. Dê a ele o nome Cinevva e cole https://api.cinevva.com/create/mcp como URL. Verifique se não há caracteres extras: a URL deve terminar em /create/mcp.
3. Clique em Adicionar e depois em Conectar. Entre com sua conta da Cinevva quando a página de autorização for aberta (a mesma conta conectada na aba do seu jogo).
4. Peça ao Claude algo como "liste os arquivos dos meus jogos da Cinevva" para confirmar a conexão. Para fazer testes ao vivo, abra seu jogo em cinevva.com/create em outra aba e clique em Agente externo na barra de ferramentas.

Configuração no Claude Code

claude mcp add --transport http cinevva https://api.cinevva.com/create/mcp

No primeiro uso, o Claude Code orienta você pelo login com OAuth. Depois disso, peça para ele ler os arquivos do seu jogo ou fazer uma alteração. Ele funciona diretamente pelo terminal, sem nenhuma aba do navegador aberta.

Configuração no Cursor

Adicione isto a .cursor/mcp.json (por projeto) ou ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "cinevva": {
      "url": "https://api.cinevva.com/create/mcp"
    }
  }
}

O Cursor detecta o servidor, executa o fluxo OAuth no navegador e lista as ferramentas nas configurações de MCP.

O que as ferramentas fazem

Grupo	Ferramentas	Precisa de uma sessão ao vivo?
Ler o jogo	list_game_files, read_files, search_game_file	Não, lê a cópia no servidor de qualquer um dos seus jogos
Editar o jogo	edit_files, write_files, delete_files, rename_files	Não, as edições são aplicadas no servidor e transmitidas para uma aba aberta
Prévia	game_ready	Atualiza a prévia de uma aba ao vivo; caso contrário, salva sem interface aberta
Observar o jogo	read_console_logs, take_screenshot	Sim
Testes	execute_js, simulate_input, get_task_status	Sim
Recursos	search_assets, list_asset_packs, import_asset, search_fonts	Sim. Cerca de 7.000 objetos, áudios e HDRIs CC0
Criação de rigs 3D	rig_model, apply_animation	Sim, consome créditos
Documentação	list_library_docs, search_library_docs, read_library_docs, list_animations	Sim

A criação de rigs custa a mesma quantidade de créditos que no Criador de Jogos do aplicativo. Todo o restante é gratuito. O criador no aplicativo também gera imagens, músicas, efeitos sonoros e skyboxes com IA; essas ferramentas ficam no próprio aplicativo da Cinevva e não fazem parte do conector MCP.

Solução de problemas

"Nenhum servidor MCP foi encontrado na URL informada" durante a configuração geralmente significa que há um erro de digitação ou um caractere extra no final da URL. Ela deve ser exatamente https://api.cinevva.com/create/mcp.

"Nenhuma sessão ao vivo" aparece apenas nas ferramentas de execução (capturas de tela, console, comandos, recursos e criação de rigs). Isso significa que nenhuma aba do navegador está com esse jogo aberto e o vínculo ao vivo ativado. Abra seu jogo, clique em Agente externo na barra de ferramentas e tente novamente. As ferramentas de arquivos nunca precisam disso: sem uma sessão, elas funcionam em qualquer um dos seus jogos por meio do gameId e listam seus jogos se você não informar um.

Se as ferramentas travarem em uma conexão recém-estabelecida, atualize a aba do jogo para que ela se reconecte e depois chame list_live_sessions.

Dúvidas ou problemas: [email protected].