Use o Zapito no Claude ou Cursor via MCP

O Zapito inclui um servidor de Model Context Protocol, então qualquer cliente MCP — Claude Code, Claude Desktop, Cursor — pode listar os seus bots, ler e editar os fluxos, consultar o uso e conversar com um bot, direto do seu editor.

1. Crie uma chave de API do Zapito

No app, vá em Configurações → Chaves de API → Chaves de API do Zapito, dê um rótulo à chave (por ex. Claude Code) e clique em Criar chave. Copie o token zap_live_… na hora — só o hash é armazenado, então ele aparece exatamente uma vez. Uma chave age como o seu workspace inteiro; revogue quando quiser no mesmo painel.

Os tokens mantêm o prefixo histórico zap_live_ de antes da renomeação para Zapito — chaves existentes continuam válidas, e as novas usam o mesmo prefixo de propósito.

2. Conecte o seu cliente

O servidor fala Streamable HTTP em:

https://api.zapito.ai/api/mcp

Claude Code

claude mcp add --transport http zapito \
  https://api.zapito.ai/api/mcp \
  --header "Authorization: Bearer zap_live_…"

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "zapito": {
      "url": "https://api.zapito.ai/api/mcp",
      "headers": { "Authorization": "Bearer zap_live_…" }
    }
  }
}

3. O que você pode fazer

Ferramenta	O que faz
guided_build	Cria um agente de suporte pelos mesmos passos do formulário do app: plataformas (WhatsApp / Telegram / widget web) → negócio (businessName + businessDescription de uma linha) → conhecimento. Chame com o que você já souber — o que faltar volta como a próxima pergunta exata a fazer, com as opções a oferecer. Não há argumento de modelo: a geração é determinista, o modelo é gerenciado pelo Zapito e o bot recebe o nome do negócio. As fontes de conhecimento são adicionadas depois, no app.
list_bots	Cada bot com id, status, canais conectados e número de nós.
get_flow	O canvas completo de um bot — JSON de nós e arestas.
update_flow	Substitui o canvas de um bot (fluxo inteiro, mesmo formato que get_flow devolve).
get_usage	Totais de mensagens/conversas + detalhamentos por canal e por modelo.
send_test_message	Converse com um bot no canal de teste — devolve a resposta, a confiança e o trace nó a nó.

Experimente: “Liste os meus bots do Zapito e envie ao bot de FAQ uma mensagem de teste perguntando sobre devoluções.” O canal de teste roda o mesmo motor da produção, então o trace que você recebe é exatamente o que uma mensagem de cliente faria.

Notas

• A mesma chave também autentica a API REST comum (/api/bots, /api/usage, …) com Authorization: Bearer zap_live_….
• update_flow substitui o canvas inteiro — faça o cliente ler get_flow primeiro e devolver o grafo completo editado.
• As chaves têm escopo de workspace. Trate-as como senhas; revogue imediatamente se uma vazar.