Reestruturamos o onboarding em torno do MCP e a instalação do SDK aumentou

• A DevCycle reestruturou completamente o processo de onboarding em torno da integração com o MCP, fazendo com que o desenvolvedor instalasse o SDK dentro do próprio editor de código desde o começo, o que gerou um aumento de aproximadamente 3x na taxa de instalação do SDK
• Antes, era desenhado para uma experiência por meio de app de exemplo ou sandbox, porém, para o desenvolvedor, era percebido como uma rota alternativa sem relação com o projeto real, resultando em alta taxa de saída
• O novo fluxo combina o assistente de codificação por IA (CLAUDE Code, Cursor etc.) com a integração do MCP para detectar automaticamente linguagem e framework e oferecer um processo de instalação personalizado
• A instalação do SDK e a criação de feature flags podem ser concluídas com apenas dois prompts de linguagem natural, com possibilidade de verificar os resultados imediatamente no dashboard
• A DevCycle é significativa por mostrar que, com essa transição, o onboarding passa de focado em “aprender” para focado em “usar”, apresentando um novo modelo de onboarding de produto para a era dos assistentes de codificação por IA

---

Mudança de contexto

• O objetivo do onboarding da DevCycle é fazer o usuário experimentar rapidamente o valor central do produto
  • No caso de produtos baseados em SDK, o “momento aha” ocorre quando o SDK é instalado no próprio app
  • O tutorial anterior oferecia três caminhos (navegador no-code, code sandbox, app de exemplo), porém a maioria dos desenvolvedores considerava a instalação do app de exemplo trabalhosa, o que levava à saída
• Como resultado, mesmo após concluir o tutorial, o SDK não era aplicado no app real, criando uma estrutura em que o valor real do produto não era percebido

Limitações do fluxo anterior do app de exemplo

• Pontos fortes: explica de forma eficaz os conceitos centrais e a estrutura da plataforma DevCycle
• Pontos fracos:
  • Parecia complexo, gerando alta taxa de saída
  • O trabalho ocorria em um ambiente separado do projeto real, então a experiência de valor era indireta
  • O objetivo final, instalação de SDK, era necessário separadamente após o tutorial

Motivo da adoção da integração com MCP

• MCP (Model-Context-Protocol) é um protocolo pelo qual assistentes de codificação IA se comunicam diretamente com a plataforma e automatizam chamadas de API e trabalho de código
  • É possível automatizar, dentro do IDE usado pelo desenvolvedor, o processo de instalação e inicialização do SDK
  • O assistente de código realiza diretamente a detecção de linguagem e framework, a inserção da chave SDK e a criação de recursos da plataforma
• Como resultado, o desenvolvedor pode seguir um fluxo direto da criação de conta até a instalação do SDK

Nova estrutura de onboarding baseada em MCP

• O onboarding foi reduzido a 3 etapas
  • 1. Instalação do DevCycle MCP
    • Escolha o assistente de IA utilizado (Cursor, Claude Code, VS Code etc.) e ofereça instalação com um clique ou guia detalhado
    • Ao detectar o evento de conclusão da instalação (mcp_ready), avança automaticamente
  • 2. Instalação do SDK
    • Digite no assistente: “Install the DevCycle SDK.”
    • O MCP envia automaticamente o comando correto e a chave SDK para o ambiente do app e realiza a instalação
    • Ao concluir a instalação, avança automaticamente para a próxima etapa
  • 3. Criação de banner Hello World
    • Digite: “Create a Hello World banner and gate it behind a flag.”
    • O MCP cria Feature e Variable e conecta ao código do cliente
    • O resultado pode ser conferido em tempo real no dashboard

Comparação com o formato anterior

• Local de trabalho: app de exemplo no navegador/local → repositório de código real do usuário
• Caminho de instalação: instalação do app de exemplo → instalação direta do SDK
• Forma de progresso: tutorial passo a passo → automação por duas frases em linguagem natural
• Ponto de conclusão: aprendizado com SDK não instalado → SDK instalado + feature flag em funcionamento

Como funciona internamente

• O MCP detecta linguagem e framework por meio do assistente de IA e gera prompts de instalação personalizados
• A DevCycle detecta eventos MCP/SDK (por exemplo, instalação, inicialização, avaliação de variável) e desbloqueia as próximas etapas automaticamente
• O trabalho real é resumido em dois prompts em linguagem natural
  1. “Install the DevCycle SDK.”
  2. “Create a Hello World banner feature and gate it behind a flag.”

Resultado e impacto

• Instalação de SDK aproximadamente 3x maior
• Como o desenvolvedor avança dentro de um fluxo natural, a taxa de saída cai
• A experiência de valor melhora com a percepção do feature flag imediatamente após a instalação

Lições ao adotar o MCP

• PMs de produto: é necessário encarar o MCP não como uma conexão simples com IA, mas como um novo ponto de contato com o produto
• Engenheiros: o MCP funciona como uma camada que automatiza de forma determinística processos complexos de instalação e configuração
• Usuários de IA: a IA pode executar trabalho real estruturado, como edição de código e configuração de ambiente

Pendências e respostas

• A fricção da instalação/autenticação do MCP ainda existe
• O problema de comportamento não determinístico da IA é tratado com controle de permissões e guardrails de API
• Para garantir confiabilidade de código, todas as alterações são projetadas para revisão por diff

Notas de implementação técnica

• Modelo de eventos: mcp_installed → sdk_initialized → variable_evaluated
• Os prompts incluem solicitações legíveis por humanos junto com comandos orientados a ferramentas
• Há proteções (permissões, opção de pular) para evitar ações destrutivas

Planos futuros

• Está previsto o fornecimento de uma receita “Day-1” escalável no exemplo inicial (Hello World)
• Há planos para dar suporte à automação de migração de código entre outras plataformas de Feature Flagging no futuro

Conclusão

• O MCP ainda está em estágio inicial, mas atua como ferramenta que reduz drasticamente o atrito do onboarding em produtos baseados em SDK
• Ao mudar o onboarding para o centro no MCP, a DevCycle mudou de uma experiência de “aprendizado” para uma de “uso direto”
• Apresentou um caso de novo paradigma de onboarding adequado à era dos assistentes de codificação por IA

[jjw9512151]

Última vez que me ocorreu escrever um README separado para o agente de IA quando vou implantar alguma coisa...