> ## Documentation Index
> Fetch the complete documentation index at: https://devs.izap.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Assistente de configuração

> Monte uma integração iZap funcional na sua stack com @izap/wizard.

`@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

```bash theme={null}
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:

```bash theme={null}
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

<Columns cols={2}>
  <Card title="Cliente MCP" icon="robot">
    Instala o servidor iZap Analytics MCP em `.mcp.json`, além de um cliente em
    TypeScript ou Python. Veja [Analytics MCP](/pt/api-reference/mcp).
  </Card>

  <Card title="Cliente REST" icon="code">
    Scaffold de cliente JWT ou OAuth 2.0 + PKCE para TypeScript ou Python. Veja
    [Autenticação](/pt/api-reference/authentication).
  </Card>

  <Card title="Webhooks e SSE" icon="bolt">
    Um receptor de webhook ou um cliente Server-Sent Events para streams de chat
    ao vivo.
  </Card>

  <Card title="Superfícies de WhatsApp" icon="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.
  </Card>
</Columns>

## Comandos comuns

```bash theme={null}
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):

```bash theme={null}
izap-wizard ai "add iZap MCP to my Next.js app"
# → Wrote izap-integration-brief.md (detected stack, recipe, edit points)
```

<Note>
  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`.
</Note>