VendeTuti es un sistema multi-tenant: cada comercio tiene su propia instancia y sus propios datos, así que no existe una clave de API global ni un sandbox público compartido — la clave de integración es propia de cada comercio y la genera quien administra esa cuenta.
Desde el panel de un comercio: Configuración → Asistente → Generar clave. Esa clave
viaja en el header X-Api-Key (o Authorization: Bearer <clave>) en las
dos integraciones externas disponibles:
POST /api/asistente/externo): pensado para
WhatsApp/n8n/Make — se le manda una pregunta en texto y devuelve la respuesta del asistente sobre los
datos del comercio.POST /api/mcp): protocolo JSON-RPC 2.0 estándar de
Model Context Protocol, para conectar el comercio directamente a un cliente MCP (por ejemplo Claude
o cualquier agente compatible) sin pasar por el asistente externo. Transporte "streamable HTTP" en
modo simple (una respuesta JSON por request, sin stream SSE). Manifiesto de descubrimiento en
/.well-known/mcp.json.Hay una instancia pública de demostración con datos de ejemplo en
demo.ferreteriaclarita.com.ar (usuario y clave:
admin / admin) para explorar el panel completo, incluida la pantalla
Asistente → Conexiones donde se genera la clave de prueba.
Los endpoints públicos, con esquemas tipados, están documentados en formato OpenAPI 3.1 en /openapi.json — ver también /docs para ejemplos.