Pular para o conteúdo principal
@izap/wizard é uma CLI voltada para desenvolvedores que adiciona a iZap a uma aplicação existente. Ela é orientada por receitas e determinística: detecta sua stack, grava edições pequenas e explícitas e scaffolds baseados em código-fonte, e mostra uma prévia de cada mudança antes de tocar em um arquivo. Nenhuma chave de API ou chamada de LLM é necessária.

​
Executando

npx @izap/wizard                              # assistente interativo (em um TTY)
npx @izap/wizard run "add iZap MCP"           # o mesmo, com um objetivo declarado
npx @izap/wizard plan "connect an AI client"  # plano somente leitura, não grava nada
Ou instale o binário globalmente: 
npm install -g @izap/wizard
izap-wizard doctor
Em um terminal, o comando puro abre um assistente em tela cheia com uma checklist de tarefas ao vivo e abas Status / Logs / Reference. Em um pipe ou CI, ele imprime os mesmos passos linha a linha. --dry-run mostra a prévia sem gravar; --yes pula a etapa de confirmação.

​
O que ele monta

Cliente MCP

Instala o servidor iZap Analytics MCP em .mcp.json, além de um cliente em TypeScript ou Python. Veja Analytics MCP.

Cliente REST

Scaffold de cliente JWT ou OAuth 2.0 + PKCE para TypeScript ou Python. Veja Autenticação.

Webhooks e SSE

Um receptor de webhook ou um cliente Server-Sent Events para streams de chat ao vivo.

Superfícies de WhatsApp

Templates, transmissões (broadcasts), envio de mensagens e uma página de conexão com Meta Embedded Signup — do lado do servidor, para que seu JWT nunca chegue ao navegador.

​
Comandos comuns

izap-wizard mcp add                              # instala o servidor MCP da iZap
izap-wizard mcp client --stack typescript        # monta um cliente MCP
izap-wizard rest client --stack python --auth oauth
izap-wizard webhook receiver --stack typescript
izap-wizard sse client --stack python
izap-wizard whatsapp connect                     # página de onboarding do WhatsApp Business

​
Handoff para agentes

izap-wizard ai "<goal>" executa a mesma detecção e planejamento, e depois grava um izap-integration-brief.md que você pode entregar a um agente de código (Claude Code, Cursor ou um agente conectado via MCP): 
izap-wizard ai "add iZap MCP to my Next.js app"
# → Wrote izap-integration-brief.md (detected stack, recipe, edit points)
O assistente nunca lê os valores do seu .env e nunca grava segredos. Ele prioriza gravações idempotentes e mostra as mudanças planejadas com --dry-run.