Conectar QrX a su asistente de IA (MCP)

Puede conectar QrX a un asistente de IA como Claude, ChatGPT o Cursor. Después puede hacer preguntas en lenguaje normal, por ejemplo "¿Qué productos tienen poco stock?", "¿Cuántos pedidos esperan a ser empaquetados?", "¿Cuál es el estado de pago del pedido 10452?" o "¿Qué requiere mi atención hoy?". El asistente lee la respuesta directamente de su cuenta de QrX. Si usted lo permite, el asistente también puede hacer algunos cambios en el almacén, siempre después de su confirmación.

La conexión usa MCP (Model Context Protocol), el estándar abierto con el que los asistentes de IA se comunican con otro software. QrX tiene un servidor MCP; su asistente se conecta a él como conector personalizado.

Quién puede usarlo

El conector de IA está incluido en los planes de pago de QrX. No tiene un precio aparte.
Usted inicia sesión con su propia cuenta del portal de QrX. El asistente recibe los mismos permisos que usted tiene en QrX, nunca más.
Las preguntas sobre stock y almacén y los cambios en el almacén requieren el módulo QrX Warehouse (WMS). Las preguntas sobre devoluciones requieren el permiso para gestionar devoluciones en su rol de QrX. Las herramientas de un módulo que no usa no se muestran al asistente.
Las cuentas de administrador de QrX no pueden conectarse. Si está viendo PortalX como otro usuario, deje de hacerlo primero e inicie sesión con su propia cuenta.
Las preguntas sobre el CRM necesitan los permisos de CRM de tu rol en QrX (toda cuenta QrX tiene el plan CRM gratuito). Los cambios en el CRM necesitan además el permiso para editar el CRM.

Qué necesita

Un asistente de IA que admita conectores MCP personalizados (también llamados servidores MCP remotos o apps personalizadas).
La URL del servidor MCP de QrX: https://api.qr-x.net/mcp
Su cuenta del portal de QrX (la que usa en portal.qr-x.app).

Cómo conectar (cualquier asistente)

En su asistente de IA, abra el lugar donde se añaden conectores y elija añadir un conector personalizado (o un servidor MCP personalizado).
Póngale un nombre, por ejemplo "QrX", e introduzca la URL del servidor https://api.qr-x.net/mcp. No necesita clave API, ID de cliente ni secreto.
Inicie el inicio de sesión. Se abre el portal de QrX. Inicie sesión con su cuenta del portal de QrX si aún no lo ha hecho.
La página de QrX "Conectar [asistente] a QrX" muestra la aplicación, adónde se le devuelve y una lista de lo que el asistente puede leer. Marque solo lo que quiera compartir. El significado de cada opción se explica en "Qué puede y qué no puede hacer el conector de IA de QrX".
Opcional: marque Cambios en el almacén si el asistente también puede hacer cambios en el almacén. Está desactivado por defecto y requiere Stock y almacén.
Opcional: marca Cambios en el CRM si el asistente puede crear o actualizar personas, empresas, oportunidades, notas y tareas del CRM, mover oportunidades e iniciar una llamada. Está desactivado por defecto y necesita CRM.
Opcional: marca Respuestas del Centro de mensajes, Gestión de devoluciones, Etiquetas de pedido o Cambios de productos si el asistente también puede responder en conversaciones, gestionar devoluciones, cambiar etiquetas de pedido o retirar un producto y fijar su stock. Cada opción está desactivada por defecto y necesita su opción de lectura (Texto de los mensajes, Devoluciones, Pedidos, Productos). Consulta "Usar el conector de IA de QrX para conversaciones, devoluciones, pedidos y productos".
Haga clic en Permitir. Vuelve a su asistente y la conexión está lista. Haga clic en Denegar para cancelar sin conectar.

La nueva conexión aparece ahora en QrX en Configuración > Avanzado > Aplicaciones conectadas.

Pasos según el asistente

Los nombres de los menús de los asistentes de IA cambian a menudo. Si un paso de abajo no coincide con lo que ve, siga los pasos generales de arriba y las páginas de ayuda de su asistente. Los nombres de los menús aparecen en inglés, como en el asistente.

Claude (Free, Pro y Max): vaya a Customize > Connectors, haga clic en + y después en Add custom connector, introduzca el nombre y la URL https://api.qr-x.net/mcp, continúe e inicie sesión con QrX. Active el conector en un chat con el botón +, Connectors. Con el plan Claude Free puede añadir un conector personalizado.
Claude (Team y Enterprise): un Owner añade el conector una vez en Organization settings > Connectors, Add, Custom, Web, con la misma URL. Después, cada miembro va a Customize > Connectors, busca QrX y hace clic en Connect para iniciar sesión con su propia cuenta de QrX.
ChatGPT (Business, Enterprise y Edu): las apps MCP personalizadas requieren el developer mode, que activa un administrador del espacio de trabajo. Después vaya a Settings > Apps > Create (los administradores también pueden usar Workspace settings), introduzca la URL https://api.qr-x.net/mcp, elija OAuth, haga clic en Scan Tools, inicie sesión con QrX y haga clic en Create.
Cursor: añada QrX como servidor MCP remoto con la URL https://api.qr-x.net/mcp (en la configuración MCP o en mcp.json) e inicie sesión con QrX cuando Cursor lo pida.

Cada persona se conecta con su propia cuenta de QrX, también cuando un conector se comparte en un espacio de trabajo de equipo. El asistente solo ve entonces lo que esa persona puede ver en QrX.

Conviene saber

"No verificada" en la página de conexión significa que QrX no ha verificado la aplicación y que la aplicación eligió su propio nombre. Continúe solo si inició la conexión usted mismo desde un asistente de confianza. La página muestra adónde van sus datos.
Lo que el asistente lee se envía a la empresa que gestiona su asistente de IA, para que pueda responderle. Comparta solo lo necesario. El texto de los mensajes nunca se comparte, salvo que marque Texto de los mensajes.
Puede desconectar en cualquier momento en Configuración > Avanzado > Aplicaciones conectadas. Consulte "Desconectar (revocar) una app de IA conectada".
Más sobre el conector de IA de QrX: qrx.eu/mcp.

Problemas frecuentes

"Este enlace de conexión no es válido": el enlace ha caducado o ya se usó. Vuelva a iniciar la conexión desde su asistente de IA.
"Inicia sesión para continuar": su sesión de QrX terminó. Vuelva a iniciar sesión y la conexión continúa.
"Tu cuenta no puede conectar aplicaciones": su cuenta no tiene acceso al portal de QrX. Pida acceso a un administrador de su empresa.
"Las cuentas de administrador de QrX no pueden conectarse": inicie sesión con una cuenta de comercio.
Una opción de la página de conexión aparece en gris: "Este módulo no está activo en tu cuenta" significa que no usa ese módulo de QrX. "Tu rol no lo permite" significa que su rol de QrX no tiene el permiso; consulte a un administrador de su cuenta.
El asistente dice que no tiene acceso o le pide iniciar sesión de nuevo: la conexión se cortó, por ejemplo en Aplicaciones conectadas, porque cerró sesión en todos los dispositivos, o tras restablecer la contraseña. Vuelva a conectar.
El asistente dice que se alcanzó un límite: espere un minuto y vuelva a intentarlo. Los límites se explican en "Qué puede y qué no puede hacer el conector de IA de QrX".

Cuándo contactar con nuestro equipo de soporte

Contacte con el soporte de QrX si la conexión sigue fallando tras seguir los pasos, si ve en Aplicaciones conectadas una conexión que nadie de su empresa reconoce, o si el asistente muestra datos que en su opinión no debería ver. Indique el asistente que usa, la hora del intento y el mensaje exacto en pantalla. No envíe nunca contraseñas ni tokens.