Saltar al contenido

[ Desarrolladores ]

Construye sobre Vitrina.

Conecta tu IA, tu sitio y tus sistemas con el servidor MCP, la API, el SDK y los webhooks.

Ver la documentaciónConectar tu IA

Tu IA, adentro de Vitrina. Conecta Claude, ChatGPT o Cursor con el servidor MCP y pregúntale a tu negocio con tus palabras.

Guía del MCP
ClaudeChatGPTCursorClaude Code

¿Quién pidió test drive de la Sportage y todavía no tiene hora?

vitrina · leads_kanbanetapa: Test drive · sin cita
JNJaviera NúñezInstagramSportage
MAMatías AlarcónWhatsAppSportage
vitrina · call_operationGET /appointments/availability
Sáb 10:00Sáb 11:30

Javiera y Matías. El sábado hay hora a las 10:00 y a las 11:30. ¿Los agendo?

Sí. Javiera a las 10:00 y Matías a las 11:30.

vitrina · call_operationPOST /appointments ×2
Javiera Núñez · Sáb 10:00 Matías Alarcón · Sáb 11:30

Listo. Las dos citas quedaron en tu agenda con la Sportage.

claude mcp add --transport http vitrina https://api.vitrinadev.com/mcpclaude mcp login vitrina

Se abre tu navegador, entras con tu cuenta de Vitrina y queda conectado.

  1. 1

    Agrega el servidorUna URL en tu cliente de IA.

  2. 2

    Entra con tu cuentaTu IA ve lo que tú ves en Vitrina.

  3. 3

    Pregúntale a tu negocioLee todo y escribe solo donde lo activas.

[ 01 ]
Leads
Conversaciones
Agenda
Stock
Anuncios

Lee tu negocio. Leads, conversaciones, agenda, stock y anuncios, con el rol y la visibilidad de quien conectó.

[ 02 ]
Contactos
Leads
Agenda
Mensajes a clientes
Campañas y plantillas

Escribe donde tú autorizas. La escritura se activa por área y viene apagada. Tú decides qué puede cambiar tu IA.

[ 03 ]
GET /authorizeOAuth 2.1

OAuth con tus permisos. Se conecta con tu cuenta de Vitrina y se revoca cuando quieras. Sin llaves pegadas en un chat.

[ 04 ]
search_operations()
describe_operation()
call_operation()

Cualquier operación. Tres herramientas genéricas buscan, describen y llaman cualquier operación que tu credencial permita.

Una API para todo el sistema. Stock, leads, citas, conversaciones y anuncios por HTTP, o con el SDK tipado para TypeScript.

Referencia de la APIGuía del SDK
curl https://api.vitrinadev.com/api/v1/stock?marca=Mazda \  -H "Authorization: Bearer $VITRINA_KEY"

Responde JSON con tu stock filtrado por marca.

  • Publica tu stock en tu sitioGET /stock
  • Crea un lead desde un formularioPOST /website-leads
  • Agenda una cita en una hora librePOST /appointments
  • Abre una conversaciónPOST /conversations
[ 01 ]
sk_live_8f2c…
stock:readleads:writeappointments:writewebhooks:write

Llaves con permisos. Cada llave vive en un workspace, con permisos por recurso y rotación con período de gracia.

[ 02 ]
POST /sandbox/automotivesk_test_…

Sandbox con datos de ejemplo. Una llave de prueba y datos sintéticos para construir sin tocar clientes reales.

[ 03 ]
Idempotency-Key: 8c1f…{ error: { code, message,
requestId: "req_…" } }

Reintentos seguros. Idempotency-Key en las escrituras y errores con código y requestId para rastrear cada llamada.

Entérate cuando pasa. Un evento firmado cada vez que entra un contacto, se agenda una cita o un lead cambia de etapa.

Eventos y firmas

POST https://tu-app.cl/webhooks

X-Webhook-Signature: t=1760745600,v1=5f2b…

const event = vitrina.events.constructEvent({  secret: process.env.VITRINA_WEBHOOK_SECRET!,  signatureHeader: req.header('X-Webhook-Signature')!,  rawBody: req.body,});if (event.type === 'appointment.booked') notifyTeam(event.data);

Si la firma no coincide o llegó tarde, constructEvent lanza un error y el evento no se procesa.

[ 01 ]
t=1760745600,v1=5f2b…HMAC SHA256 · tu secreto firma válida

Firmados con HMAC. Verifica cada entrega con tu secreto. El SDK lo hace en una línea.

[ 02 ]
{
  "type": "appointment.booked",
  "data": { la cita completa }
}

Con el recurso adentro. Pide el dato junto al evento y ahórrate la segunda llamada.

Vitrina en tu sitio. El chat de tu agente y la medición de tus anuncios con una sola etiqueta.

Instalar la etiqueta
<script  src="https://api.vitrinadev.com/tag.js?site=pk_live_…"  async></script>

Pégala una vez en tu sitio. El chat y la medición quedan en todas tus páginas.

tuautomotora.cl

Hola, ¿la CX-5 sigue disponible?

Sí, 41.000 km. ¿Te acomoda verla el sábado?

[ 01 ]
pk_live_…
tuautomotora.clotro-sitio.com

Llave pública, bloqueada a tu dominio. Solo lee tu stock, recibe leads y abre el chat. Nada más.

[ 02 ]

¿Tienen hora el sábado?

Sí, a las 11:00. ¿Te la reservo?

El agente que ya configuraste. Responde con el mismo conocimiento y agenda en tu misma agenda.

[ 03 ]
Clic en el anuncio
Lead en Vitrina
Venta cerrada

Cada visita, hasta la venta. La etiqueta conecta el clic del anuncio con el lead y la venta en Vitrina Ads.

Skills para tu IA. Instrucciones listas para que Claude Code, Cursor o Codex integren la API, mejoren tu agente o revisen tu embudo.

Ver las skills
/plugin marketplace add VitrinaDev/skills/plugin install vitrina-skills@vitrina

Después pídele a Claude que integre Vitrina en tu proyecto.

  • 01Integrar la API de Vitrina
  • 02Mejorar tu agente
  • 03Analizar tu embudo
  • 04Revisión semanal

¿Listo para construir?

docs.vitrinadev.com
Ver la documentaciónAgendar demo

La API, el SDK y el servidor MCP están en beta. Los cambios se avisan en el registro de cambios de la documentación.