Cómo conectar tu asistente de IA a OlaClick
Conecta Claude, Cursor u otro asistente compatible directamente a tu cuenta y pregunta sobre tus ventas, pedidos y clientes en lenguaje natural, sin exportar nada manualmente.
Qué es esta conexión
OlaClick pone a disposición un servidor MCP (Model Context Protocol), un estándar abierto que permite que los asistentes de IA accedan a sistemas externos de forma segura.
En la práctica: en vez de entrar al panel y aplicar filtros, le preguntas a tu asistente "¿cuánto vendí esta semana en comparación con la anterior?" y él consulta los datos de tu cuenta para responderte.
No se instala nada en tu computadora. El servidor está alojado por OlaClick, y la conexión se hace con un token de acceso que tú mismo generas y puedes revocar cuando quieras.
Disponibilidad: el acceso por API está disponible para negocios con planes Premium, Elite e Infinity.
Asistentes compatibles
El panel ofrece configuración asistida para:
| Asistente | Tipo de configuración |
|---|---|
| Claude (web y escritorio) | Guiado |
| Claude Code (terminal) | Guiado |
| Cursor (editor de código) | 1 clic |
| VS Code (Copilot) | 1 clic |
| Kiro (IDE agéntico) | 1 clic |
| Cualquier otro cliente compatible con MCP | Guiado |
1 clic abre la aplicación y configura todo solo. Guiado muestra los pasos con botones de copiar, porque esos clientes no aceptan enlaces de instalación.
Qué puede consultar el asistente
Una vez conectado, el asistente tiene acceso a la información que habilites al momento de configurar:
- Ventas y pedidos: pedidos con filtros por estado, tipo de servicio, origen, período y método de pago, además de estadísticas de productos más vendidos.
- Clientes: lista de clientes con filtros por nombre, teléfono, puntos de fidelidad y comportamiento de compra.
- Menú: categorías, productos, variantes, precios y disponibilidad.
- Negocio: datos del negocio, horarios de atención y si está abierto en este momento.
- Reportes: datos consolidados de tu operación.
Cómo conectar
Paso 1. Abre la pantalla de conexión
En el panel de OlaClick, ve al menú lateral en Integraciones > API Keys y haz clic en CONECTAR CON IA.
Paso 2. Elige tu asistente
Selecciona el asistente que usas. El panel genera la clave y arma la configuración para ese cliente específico.
Paso 3. Define los permisos
Eliges qué puede hacer el asistente con tus datos:
- Solo lectura (recomendado): el asistente consulta tus datos, pero no modifica nada.
- Lectura y edición de menú: además de consultar, puede modificar nombres y descripciones de productos.
Con solo lectura, el asistente no puede cambiar precios, cancelar pedidos ni tocar tu menú. Es la opción recomendada para empezar.
En esa misma pantalla defines el vencimiento de la clave (90 días es el valor recomendado) y el nombre de la clave, para reconocerla después en la lista de tokens.
Haz clic en GENERAR CLAVE Y CONECTAR.
Paso 4. Termina en tu asistente
Para clientes de 1 clic (Cursor, VS Code, Kiro), el panel abre la aplicación y la configuración se aplica automáticamente.
Para Claude, sigue los pasos que aparecen en pantalla:
- En Claude, abre Personalizar > Connectors, toca Add y elige Add custom connector.
- Ponle un nombre al conector (por ejemplo, OlaClick) y pega la URL del servidor MCP que aparece en pantalla. Toca Continue.
- En Authentication, elige None.
- En Request headers, elige authorization en la lista de nombres y pega el valor que entrega el panel, manteniendo la palabra Bearer al inicio.
- Guarda. En cualquier conversación, toca + > Connectors y activa OlaClick.
Atención al paso 3. Claude viene con Always required preseleccionado, porque detecta que el servidor pide autenticación. Hay que cambiarlo a None: OlaClick usa una clave de acceso, no OAuth. Si queda en "Always required", la conexión falla.
Cómo probar que funcionó
Con la conexión activa, hazle una pregunta simple al asistente:
- "¿Cuánto vendí esta semana en comparación con la anterior?"
- "¿Cuáles son mis 5 productos más vendidos este mes?"
- "¿Qué clientes no compran hace 30 días?"
- "Muéstrame los pedidos de delivery cancelados de ayer."
- "¿Mi restaurante está abierto ahora? ¿Cuál es el horario de hoy?"
Si el asistente responde con datos de tu negocio, está todo listo.
Cómo gestionar y revocar el acceso
Todos los tokens generados quedan listados en Integraciones > API Keys, con nombre, permisos, fecha de creación, último uso y estado. En el botón VER de cada fila encuentras:
- Detalle: información de la clave, incluyendo permisos, fecha de creación, último uso y vencimiento.
- Editar permisos: cambia a qué puede acceder el asistente. El cambio aplica de inmediato.
- Revocar: termina el acceso al instante.
La revocación no se puede deshacer. Quien estaba usando ese token pierde el acceso de inmediato y empieza a recibir errores. Para restablecer la conexión hay que generar un token nuevo y configurarlo otra vez.
Seguridad
- El token aparece una sola vez, en el momento en que se crea. Guárdalo en un lugar seguro.
- Concede solo los permisos necesarios. Si únicamente quieres consultar datos, usa solo lectura.
- Define un vencimiento. Las claves con plazo reducen el riesgo en caso de filtración.
- Trata el token como una contraseña: no lo compartas en grupos, documentos abiertos ni capturas de pantalla.
- Si sospechas que quedó expuesto, revócalo y genera otro.
Preguntas frecuentes
¿Necesito instalar algún programa? No. El servidor está alojado por OlaClick. La configuración ocurre dentro del asistente que ya usas.
¿El asistente puede modificar datos de mi restaurante? Solo si le concedes permiso de edición. En la opción solo lectura, únicamente consulta.
Conecté y el asistente no responde. ¿Qué reviso? En Claude, el error más común es dejar Authentication en "Always required". Debe ser None. Confirma también que el header authorization se haya pegado completo, incluyendo la palabra Bearer.
Perdí el token. ¿Puedo verlo de nuevo? No. El valor completo se muestra solo al crearlo. Genera un token nuevo y revoca el anterior.
¿Qué pasa cuando el token vence? La conexión deja de funcionar. Genera un token nuevo y rehaz la configuración en el asistente.
¿Dónde encuentro la documentación técnica? En https://developers.olaclick.app/docs/mcp, con la lista completa de herramientas y parámetros.
Última actualización: 15/09/2026 · por Pedro B.