Ir al contenido
Zapito
Abrir la app

Usa Zapito desde Claude o Cursor vía MCP

Zapito incluye un servidor de Model Context Protocol, así que cualquier cliente MCP — Claude Code, Claude Desktop, Cursor — puede listar tus bots, leer y editar sus flujos, consultar el uso y chatear con un bot, directamente desde tu editor.

En la app, ve a Ajustes → Claves de API → Claves de API de Zapito, ponle una etiqueta a la clave (p. ej. Claude Code) y pulsa Crear clave. Copia el token zap_live_… de inmediato — solo se guarda su hash, así que se muestra exactamente una vez. Una clave actúa como todo tu espacio de trabajo; revócala cuando quieras desde el mismo panel.

Los tokens conservan el prefijo histórico zap_live_ de antes del renombre a Zapito — las claves existentes siguen siendo válidas, y las nuevas usan el mismo prefijo a propósito.

El servidor habla Streamable HTTP en:

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

Claude Code

Terminal window
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_…" }
}
}
}
Herramienta Qué hace
guided_build Crea un agente de soporte con los mismos pasos que el formulario de la app: plataformas (WhatsApp / Telegram / widget web) → negocio (businessName + businessDescription de una línea) → conocimiento. Llámala con lo que ya sepas — los datos que falten vuelven como la siguiente pregunta exacta que hacer, con las opciones a ofrecer. No hay argumento de modelo: la generación es determinista, el modelo lo gestiona Zapito y el bot toma el nombre del negocio. Las fuentes de conocimiento se añaden luego en la app.
list_bots Cada bot con id, estado, canales conectados y número de nodos.
get_flow El lienzo completo de un bot — JSON de nodos y aristas.
update_flow Reemplaza el lienzo de un bot (flujo completo, misma forma que devuelve get_flow).
get_usage Totales de mensajes/conversaciones + desgloses por canal y por modelo.
send_test_message Chatea con un bot en el canal de prueba — devuelve la respuesta, la confianza y la traza nodo a nodo.

Prueba: «Lista mis bots de Zapito y envía al bot de FAQ un mensaje de prueba preguntando por devoluciones.» El canal de prueba ejecuta el mismo motor que producción, así que la traza que recibes es exactamente lo que haría un mensaje de un cliente.

  • La misma clave también autentica la API REST normal (/api/bots, /api/usage, …) con Authorization: Bearer zap_live_….
  • update_flow reemplaza el lienzo entero — haz que el cliente lea get_flow primero y devuelva el grafo completo editado.
  • Las claves tienen el alcance del espacio de trabajo. Trátalas como contraseñas; revócalas de inmediato si una se filtra.