01Começar
- Crie sua conta em freegma › começar grátis. Você confirma o e-mail e o estúdio já abre.
- Adicione o Freegma no seu chat, como no passo 2 abaixo.
- Peça a primeira tela. A IA cria o projeto se ele ainda não existir.
Nada para instalar: o estúdio abre no navegador e mostra as telas enquanto a IA trabalha. Deixe-o aberto para acompanhar.
02Adicionar no chat
Todos os chats usam o mesmo endereço:
https://freegma.app/mcp
Claude
No site ou no app do Claude: Configurações → Conectores → Adicionar conector personalizado. Dê o nome Freegma, cole o endereço e clique em conectar. Uma janela do Freegma pede para você entrar e autorizar. Depois disso o conector funciona também no celular.
ChatGPT
Primeiro ligue o modo de desenvolvedor em Configurações → Apps e conectores → Avançado; funciona em qualquer plano, até no grátis. Depois, em Apps e conectores → Criar, cole o endereço e autorize com a sua conta Freegma.
Terminal (Claude Code, Cursor, Gemini e outros)
No Claude Code, rode o comando abaixo e depois digite /mcp para entrar com a sua conta. Os outros programas pedem o mesmo endereço na tela de conectores.
$ claude mcp add --transport http freegma https://freegma.app/mcpOutros apps, com token
Para apps que não entram com a sua conta, como o llama.cpp e o LM Studio: no painel, em Conectar sua IA → Token, dê um nome e clique em Gerar token. O painel mostra, uma vez só:
- um endereço com o token embutido, para apps que só pedem a URL: cole e pronto;
- o token, para apps que pedem um cabeçalho: use o endereço normal com
Authorization: Bearerseguido do token. O comando pronto para o Claude Code também aparece ali.
Apps que rodam no navegador, como a tela do llama.cpp, conectam direto, sem precisar de proxy. Cada token funciona como a sua conta: não compartilhe o endereço nem o token e revogue no painel se vazar.
Você pode autorizar quantos chats quiser. Eles aparecem no painel, onde dá para revogar qualquer um.
03Pedir telas
Escreva como falaria com uma pessoa e mencione o Freegma para a IA saber onde desenhar:
Crie no Freegma a landing page da Padaria Trigo Bom, com cardápio, horários e um botão de WhatsApp.
No Freegma, desenhe a tela de login e o painel de um app de controle de gastos, em tons de verde.
Monte no Freegma a interface de um jogo de cartas: menu inicial, mesa e tela de vitória.
Depois peça ajustes no mesmo chat: "deixe o título maior", "faça uma versão escura", "crie três alternativas para o topo". A IA lê o que já existe antes de mudar.
04O estúdio
- Projetos agrupam as telas de um mesmo trabalho e guardam o guia de design (cores, fontes, espaçamentos), que a IA segue em todas as telas.
- Limites: cada projeto tem até 50 MB. O Free tem 1 projeto e 50 MB; os planos pagos vão de 10 projetos e 500 MB (Pro) a projetos sem limite e 10 GB (Ilimitado).
- Cada tela tem um link que abre direto no navegador. Quem tem o link vê a tela, então mande só para quem precisa.
- Imagens: envie pelo botão Imagens do estúdio, ou solte o arquivo no canvas, e peça para a IA usar pelo nome. Elas já saem otimizadas para a web e vão junto quando você baixa o site, prontas para produção. Para usar uma imagem direto no seu site, clique em Copiar link no painel: o link abre só a imagem, não as suas telas, e dá para tirar do ar quando quiser. Imagens que nenhuma tela usa somem depois de duas semanas, menos as que têm link público.
- Baixar: no estúdio, baixe o projeto inteiro (.zip) ou o site pronto para publicar, com as imagens.
05Limite e planos pagos
Cada vez que a IA cria, lê ou ajusta algo no estúdio conta como uma ação da IA. O plano Free inclui 50 ações da IA por mês. Ao chegar no limite a IA recebe um aviso e nada é perdido.
Os planos pagos liberam 30 dias de ações sem limite e mudam só os projetos e o espaço: Pro (R$ 14,99, 10 projetos, 500 MB), Plus (R$ 39,99, 20 projetos, 1 GB), Max (R$ 99,99, 100 projetos, 5 GB), Ilimitado (R$ 299,99, projetos ilimitados, 10 GB). O pagamento é por Pix, cartão à vista ou boleto, sem renovação automática. Pix e cartão liberam na hora; o boleto, em até 3 dias úteis. Pagar antes de vencer soma os dias; trocar de plano converte os dias que faltam pelo preço de cada um. Veja os preços.
Mexer nas telas e enviar imagens pelo estúdio não gasta ações.
06Conta e acesso
- Uma sessão no navegador por vez. Entrar no site em outro lugar encerra a sessão anterior.
- Chats autorizados não contam como login. Eles continuam funcionando até você revogar no painel.
- Idioma: o site, o painel, o estúdio e os e-mails estão em português, inglês e espanhol. Troque pelo seletor de idioma no topo da página.
- Esqueceu a senha? Use redefinir senha.
07Algo deu errado
A IA diz que o projeto é só para leitura
O Free edita 1 projeto, e cada plano pago tem o seu limite. Se o plano venceu ou você desceu para um com menos projetos, os mais novos ficam só para leitura até você renovar ou subir de plano. Nada é apagado sem você pedir: para liberar a vaga, apague no estúdio um projeto que não usa (botão Apagar na lista de projetos).
O chat não encontra o Freegma
Confira se o conector está ativo na conversa (no Claude, pelo botão de ferramentas abaixo da caixa de texto) e peça mencionando "no Freegma".
Paguei e o plano não apareceu
No Pix e no cartão, a confirmação costuma levar alguns segundos; no boleto, até 3 dias úteis. Se passar de alguns minutos, escreva para support@freegma.app com o e-mail da sua conta.