MCP do Kasy

O MCP do Kasy (kasy-mcp) é o caminho principal de uso do kit. Em vez de digitar kasy no terminal, você conversa com o assistente (Cursor, Claude Code, Claude Desktop…) e ele chama as tools certas.

Pense no MCP como um plug: de um lado a IA, do outro a CLI kasy. Por baixo é a mesma ferramenta (mesma licença, mesmos comandos). Muda só como você fala com ela.

A propostaCopiar link da âncora

Hoje o MCP já cobre o fluxo completo do dia a dia: preparar a máquina, criar projeto, rodar e resetar o app, adicionar ou remover feature, atualizar o kit, trocar cor/splash/ícone, ler o design system antes de montar uma tela, configurar credenciais (Apple, Facebook, assinatura iOS/Android, Codemagic, RevenueCat/Sentry/Mixpanel/AdMob…), publicar nas lojas (iOS e Android, local ou via Codemagic), configurar domínio e checar/consertar o projeto.

A direção do produto é ir além: em poucas semanas, o MCP deve conseguir fazer tudo conectado ao fluxo da Kasy pelo chat, sem a pessoa precisar ficar digitando comando no terminal. Você pede; o assistente executa.

A CLI no terminal continua existindo. Quem preferir digitar kasy usa o instalador. Os dois caminhos usam a mesma kasy-cli por baixo.

O que o MCP faz (e o que não faz)Copiar link da âncora

Roda local (kasy mcp setup instala kasy-mcp global na sua máquina). Não há servidor hospedado pela Kasy no meio. O pacote já traz a kasy-cli pro assistente. Detalhe em Instalar o Kasy.

ToolsCopiar link da âncora

Cada tool é um pedido que o assistente pode fazer. Você não chama pelo nome: fala em português e o modelo escolhe.

Preparar e consertar a máquinaCopiar link da âncora

O loop esperado: prepare_machine → se faltar algo, run_setup_command → check_kasy_updates → se precisar, upgrade_kasy e reinício do app do assistente → prepare_machine de novo, até passar. O assistente não deve só diagnosticar e parar.

Criar e gerenciar o projetoCopiar link da âncora

create_project só cobre o caminho Rápido (não interativo). Antes de perguntar qualquer coisa, o assistente deve te oferecer a escolha entre Rápido (aqui, poucas perguntas) e Avançado (Passo a passo com todas as perguntas, só no terminal com kasy new). Recomenda Rápido, mas nos dois dá pra adicionar ou remover feature depois (kasy add/kasy remove, ou add_feature/remove_feature no chat).

No Rápido, se você já descreveu o produto (barbearia, estoque, delivery), o assistente trata como o app inteiro: resume com você até você dizer que está ok, mostra um plano e só então cria o projeto. O backend é escolhido agora e a conexão remota fica para depois. Se você só pediu o setup da Kasy, ele cria o projeto e para.

No Supabase/API, o assistente pergunta só push (não pergunta Google separado; Google vem ligado por padrão): sem push = sem Firebase companion (Google no scaffold; provedor Enabled no Supabase Auth; credenciais depois com configure_google_login); com push = projeto Firebase companion gratuito (FCM) e Google OAuth pode ser configurado automaticamente nesse passo.

Para não receber uma lista numerada gigante no chat:

• Cursor / Claude Code: o assistente usa AskQuestion (quiz estruturado) e chama create_project com directory, backend, região e push já preenchidos. Não chame create_project sem esses campos no Cursor (retorna MISSING_PREFS).
• Claude Desktop e outros sem quiz: create_project com useElicitationForm: true e sem directory/backend abre o formulário MCP.

Depois de um update_project, se o kit sobrescrever um arquivo que você customizou, o assistente deve reconciliar a sua mudança com o código novo (não descartar em silêncio).

kanban lê e edita o board do projeto (o mesmo que a tela Kanban do app mostra) sem precisar de senha nova: no Firebase usa seu próprio login gcloud, no Supabase usa a service_role_key do projeto já linkado. Só Firebase e Supabase, backend API REST próprio não é suportado (não tem como assumir uma credencial de admin genérica). Veja Kanban.

Rodar e resetar o appCopiar link da âncora

Quando você pede "rode o app". O assistente deve usar quiz estruturado (não lista em markdown) para:

1. Plataforma: iOS, Android ou web
2. Se for web:
   • Padrão: só devolve a URL http://localhost:5555
   • openBrowser=true: abre no navegador padrão do sistema (--open-browser)
   • flutterChrome=true: Chrome isolado do Flutter (--open)
   • freshStorage=true: limpa localStorage, sessionStorage e IndexedDB ao abrir (--fresh, inclui sessão Firebase Auth). Combine com openBrowser e device preview em aba iOS/Android/iPad pra testar onboarding como primeira vez

Para limpar com o app já rodando: clear_web_storage ou reset_app com platform=web.

Não use run_kasy_command pra kasy run. Essa tool espera o processo terminar e mataria a sessão.

Branding (Personalização)Copiar link da âncora

OrquestraçãoCopiar link da âncora

Três tools guiam a IA. As instruções longas saem pelo MCP, só com assinatura ativa, e melhoram sem você atualizar o kasy-mcp. Sem assinatura ou sem internet, a tool avisa e não entrega o texto. Elas não são uma página pública nem um arquivo do projeto.

O rebrand espera o sim do preview. Uma tela sozinha não espera um plano. O plano existe no finalize_project, quando o pedido é o app inteiro. Se você mandou uma imagem, ela vale para o app inteiro: boas-vindas, login, cadastro, perfil, o visual de configurações e o menu nascem dela. A tela de assinatura e o administrativo ficam como o kit. Sem imagem, essas telas base ficam como o kit e só entram as telas do produto. Na verificação (kasy-cli 1.91.0 e kasy-mcp 0.25.0), a ferramenta abre o app, troca claro e escuro, celular e largura larga, compara a cor com a imagem, aperta os toques do plano e roda o analyzer. Um arquivo dizendo que a tela foi vista não passa. A cada tela, o assistente diz o que está fazendo.

Credenciais e integraçõesCopiar link da âncora

Essas nove viviam presas ao terminal porque o MCP fecha o stdin (não dá pra responder pergunta por pergunta). O jeito que passou a funcionar: o assistente coleta os valores com quiz estruturado (AskQuestion) ou formulário MCP, depois chama a tool uma vez só com tudo, nada fica esperando resposta no meio do processo. Chaves de licença e OAuth são texto livre, não quiz de múltipla escolha. Nenhuma delas gera credencial nova (keystore, chave de API, app no Meta/Apple/Codemagic): isso continua manual, feito uma vez nos respectivos painéis. configure_license é a exceção: a chave em si vem por email na hora da compra em kasy.dev, não é gerada pela tool.

Publicar (lojas e web)Copiar link da âncora

Consertar o projeto (Referência)Copiar link da âncora

Design system e telaCopiar link da âncora

A lista vem do projeto atual, não de um cache. Depois de um rebrand ou kasy update, o conjunto pode mudar. O assistente não deve inventar Material cru (Scaffold, AlertDialog, TextField…) se existir equivalente Kasy.

Validar no navegador (Browser QA)Copiar link da âncora

Flutter Web pinta em canvas, sem a árvore de semantics ligada, um agente de navegador (Cursor, Claude, Playwright) não enxerga botão nem campo, só pixels. O kit já liga isso em debug/profile (ver Guia Web); browser_qa_guide confirma a ponte em lib/main.dart e devolve docs/agent-browser-qa.md. Mapa completo dos arquivos de IA: Orientação para IA.

Importante: o MCP é um processo headless, não abre navegador sozinho. A tool só devolve o roteiro; quem executa é o navegador que o próprio agente já tem (o Browser pane do Claude Code, o navegador do Cursor, etc.).

Qualquer outro comando da CLICopiar link da âncora

Prefira a tool dedicada quando existir. run_kasy_command é o canivete: só roda o binário kasy, nunca shell arbitrário. Nunca use pra kasy run.

read_kasy_docs busca a doc publicada (não a base de treino, que pode estar desatualizada) em markdown limpo, em pt/en/es. Serve pra confirmar uma flag rara, ler o guia completo de uma feature (ex.: funcionalidades/stripe) antes de configurar, ou consultar referencia/troubleshooting quando algo falha de um jeito não familiar.

Telemetria (o assistente chama, não você)Copiar link da âncora

Corrigir é obrigatório; reportar sozinho não resolve nada pra você. O caminho normal é resolved: true com o comando exato que funcionou. Isso vira melhoria no kasy doctor. Sem PII: sem nome, e-mail, chave ou path completo.

ResourcesCopiar link da âncora

Além das tools, o MCP expõe dois resources que o assistente lê sozinho:

Nada de cor ou fonte fixa no pacote do MCP. Depois de um rebrand, a fonte da verdade continua sendo o projeto no disco.

Pedidos típicosCopiar link da âncora

Com o MCP ligado, dá pra falar assim:

Prepara minha máquina com o Kasy

Cria um projeto chamado meu-app com Firebase, modo rápido

Adiciona revenuecat no meu projeto

Publica o iOS

Publica no Codemagic o Android e me diz o status

Adiciona app.meudominio.com nos domínios autorizados

O assistente escolhe a tool (prepare_machine, create_project, run_app, release_ios, codemagic_release…). Você não precisa lembrar o nome.

Limitação conhecida (v1)Copiar link da âncora

Tools e resources sem directory explícito resolvem relativo ao diretório de trabalho do processo do MCP.

• Cursor / Claude Code: confiável (cwd = projeto aberto).
• Claude Desktop: não tem conceito de "projeto aberto". Depois do create_project, o assistente precisa passar directory explícito em list_components, check_status, etc.

MCP do Kasy vs MCP de terceirosCopiar link da âncora

São coisas diferentes:

Dá pra usar os três juntos: o MCP do Kasy liga a feature no código; o da Stripe/RevenueCat monta o catálogo no painel.

Próximo passoCopiar link da âncora

1. Instalar o MCP (se ainda não instalou)
2. Preparar a máquina
3. Criar o primeiro app

Atualizado em 03/11/2026