Solución técnica de problemas

Primer paso en todos los casos: pide al chat que ejecute ps_get_shop_info y ps_check_shop_health. Juntos informan de las versiones, la edición y el estado de la licencia, las áreas de escritura (qué interruptores están activados y hasta cuándo), el nivel de datos de clientes, los permisos que faltan al empleado, los límites por hora restantes y los módulos enganchados a los guardados. La tarjeta Registro de conexiones (últimas 50) muestra cada llamada con IP, resultado y hora.

Conexión

El conector no se conecta desde Claude o ChatGPT.

Comprueba en este orden:

1. La dirección es https://your-shop.com/module/tellmyshop/mcp (con el inicio de sesión del chat, sin token; con la dirección con clave del método antiguo, con el token completo). El endpoint rechaza HTTP sin cifrar (403).

2. El conector está activado. El paso 1 de la tarjeta Inicio (Activar el conector) lo activa; desactivado devuelve 503 «connector disabled».

3. «Comprobar la conexión de nuevo» en el módulo funciona (token de prueba, válido 2 minutos). La prueba comprueba también el inicio de sesión del chat:

   • «El hosting elimina la cabecera con el pase del chat (Authorization)»: el servidor o un proxy quita la cabecera Authorization. Pide al hosting que la transmita. Si no es posible, activa Dirección con clave (método antiguo) en Chats conectados → Avanzado: cómo se conectan los chats y usa esa dirección.
   • «El chat no encontrará la configuración de inicio de sesión»: la dirección /.well-known/ de la tienda no responde. Suele ayudar activar las URL amigables (Parámetros de la tienda → Tráfico y SEO → URL amigables). Si la tienda está en una subcarpeta o el hosting bloquea las direcciones /.well-known/, usa la dirección con clave.

   La prueba no detecta bloqueos por país o IP en una CDN; la primera llamada real del chat en el registro de conexiones sí.

4. Nada delante de la tienda bloquea POST a /module/tellmyshop/mcp: autenticación básica, página de mantenimiento, WAF, Cloudflare Bot Fight Mode o desafíos gestionados. Añade una regla de excepción solo para esa ruta.

5. La lista de IP permitidas en Ajustes: seguridad, alertas, límites está vacía, o incluye las direcciones de tu aplicación de chat. Con ChatGPT déjala vacía: OpenAI no publica una lista fija de direcciones. Para Claude, la tarjeta de ajustes tiene un botón que añade las direcciones de Anthropic.

6. Tienda detrás de Cloudflare u otro proxy: activa Tienda detrás de un proxy / Cloudflare e indica los rangos del proxy en Proxies de confianza; si no, la lista de IP ve la IP del proxy.

7. En ChatGPT, la tienda se añade en Plugins como servidor MCP personalizado con la autenticación OAuth.

403 Forbidden.

Causas probables:

• Origin. Una petición con cabecera Origin solo se acepta desde https://claude.ai, https://claude.com, https://chatgpt.com o https://chat.openai.com. Las peticiones sin Origin pasan. Una herramienta de prueba en el navegador con otro Origin se rechaza.
• Lista de IP permitidas. La IP no está en la lista.
• HTTP simple.

503 Servicio no disponible.

El conector está desactivado, o no existe el empleado del conector (borrado, o convertido en SuperAdmin). Vuelve a ejecutar el paso 1 de la tarjeta Inicio; crea la cuenta si falta.

429 Demasiados intentos fallidos.

20 autenticaciones fallidas desde una IP en 10 minutos bloquean esa IP hasta que pasa la ventana; el propietario recibe una alerta. Causa típica: un token antiguo aún configurado en la aplicación de chat o en un script de monitorización. Corrige el token y espera 10 minutos.

401 después de regenerar un token (dirección con clave, método antiguo).

Un token nuevo revoca el antiguo de inmediato. Actualiza la dirección con clave en Claude o ChatGPT, o la cabecera Authorization: Bearer en la configuración de Claude Code / Claude Desktop.

Claude Code o Claude Desktop (local) no se conecta.

Con la dirección con clave (método antiguo), usa --header "Authorization: Bearer <token>" en lugar de un token en la URL. El endpoint necesita HTTPS incluso en local (mkcert). Las peticiones sin cabecera Origin pasan. Si hay una lista de IP, añade la IP pública del equipo.

Error de versión del protocolo.

Compatibles: 2026-07-28, y 2025-11-25, 2025-06-18, 2025-03-26. Una versión no compatible devuelve 400 con la lista de versiones aceptadas.

El guardado no funciona

El chat solo lee y planifica.

O la licencia no está activa (Pro sin licencia activa funciona como Free), o es TellMyShop Free, que no tiene herramientas de escritura. ps_get_shop_info dice cuál (edición audit o audit_free). Revisa la tarjeta Licencia y haz clic en Actualizar.

«Writing in the … area is off. Nothing was saved.»

Ventas, Tema, Módulos y Mantenimiento solo guardan mientras su interruptor está activado en la tarjeta Guardado por áreas. Ventas sigue activado hasta que lo desactives; Tema y Módulos durante 24 horas; Mantenimiento durante 3 horas. Un interruptor que caduca a mitad de conversación deja de guardar al momento. La vista previa sigue funcionando, así que el chat puede mostrar el plan antes de que actives el interruptor. Desde la 2.7.0 no hay un conector de servicio aparte: una sola dirección cubre todas las áreas.

Tema, Módulos o Mantenimiento no se activan.

Activarlos necesita una confirmación marcada y una copia de la base de datos terminada. En una tienda grande la copia se hace por partes: deja la página abierta o haz clic en Terminar la copia. Sin espacio libre en disco de unas dos veces el tamaño de la base, estos interruptores siguen desactivados; Contenido, Catálogo y Ventas siguen funcionando.

ps_restore_file_backup rechazado.

Restaurar necesita el interruptor de la zona del archivo: Tema para archivos del tema, Módulos para archivos de módulos, Mantenimiento para otros archivos de la tienda. La tarjeta Copias de archivos del panel restaura sin interruptor, con los permisos del propio empleado.

La herramienta de atención al cliente se niega.

ps_customer_service se niega mientras el nivel de datos de clientes es Desactivado. Elige Seudonimizado o Acceso completo (temporal) en la tarjeta Datos de clientes (RGPD).

Faltan las herramientas de blog.

Las 5 herramientas de blog solo se registran si se detecta SmartBlog. Otros módulos de blog no son compatibles. ps_check_shop_health informa «sin blog» como información.

Límites

Límite alcanzado.

Valores iniciales por hora: 300 llamadas, 150 escrituras, 20 escrituras de archivos (rangos 10–2000, 1–500, 1–200), en Ajustes: seguridad, alertas, límites. Una escritura con un lote de hasta 50 elementos cuenta como una, y el límite de escritura se comprueba antes de guardar, así que un lote nunca se queda a medias. Reparte los trabajos grandes en varias horas o sube los límites mientras dure el trabajo; ps_check_capacity comprueba antes un trabajo previsto.

Lote rechazado con un error de límite.

Límites por llamada, por ejemplo: ps_update_product_content 50, ps_update_category_content 20, ps_update_image_legends 100, ps_set_product_categories 200, ps_update_prices 100, ps_update_stock 100, ps_manage_combinations 100, ps_set_product_redirect 100, ps_translate_catalog_items 200, ps_manage_redirects 100, ps_db_query 200 filas, ps_db_execute 1000 filas copiadas. Tabla completa: Especificación §11.1.

Escrituras

change_token caducado, usado o que no coincide.

El token es un HMAC de la herramienta, los argumentos y un hash del estado «antes», válido 30 minutos, de un solo uso. Repite con argumentos idénticos o haz una vista previa nueva.

Ejecución bloqueada: los datos cambiaron desde la vista previa.

El estado «antes» ya no coincide, por ejemplo por una edición en el panel, una importación o un módulo de feeds. Haz una vista previa nueva.

El resultado lista cambios fuera de la vista previa.

El registro de filas vio durante la escritura filas cambiadas que la vista previa no mostraba, normalmente por el hook de otro módulo. El chat se las muestra al propietario y le pregunta qué hacer; no las restaura por su cuenta. Deshacer la operación devuelve todas las filas registradas a su estado anterior.

Cambio de precio rechazado.

ps_update_prices rechaza un precio de 0 y los cambios de más del 30 % sin allow_big_change. ps_manage_specific_prices y ps_manage_catalog_price_rules exigen allow_big_change por encima del 90 % de descuento (aviso por encima del 50 %). El chat pone esa marca solo después de que el comerciante aprueba un cambio de ese tamaño.

Regla de carrito creada pero inactiva / no se puede borrar.

ps_manage_cart_rules crea las reglas inactivas por diseño; usa action=set_active. No hay acción de borrado; desactívala. Una regla sin código necesita auto_apply.

Error de validación al guardar.

ObjectWriter valida cada campo con las reglas de la clase (validateField, isCleanHtml, longitudes). Los nombres de producto no pueden contener <>;=#{} y tienen un máximo de 128 caracteres. El mensaje nombra el campo.

Otro módulo no reacciona al cambio.

ObjectWriter llama a update(), que dispara actionObject<Class>Update* (y actionProductSave / actionProductUpdate para productos). Los módulos que solo escuchan los hooks de los formularios del panel no ven el cambio. ps_check_shop_health los lista.

Permiso denegado.

ExecutionContext::requirePermissions comprueba al empleado del conector por pestaña y acción. Desde la 2.7.0, el perfil creado en el paso 1 recibe los permisos de todas las áreas; si el perfil se editó a mano, ps_get_shop_info lista lo que falta. En algunas versiones de PrestaShop los módulos ignoran los guardados de un empleado sin permiso de «ver» en módulos; la tarjeta Inicio ofrece una corrección con un clic.

Deshacer rechazado.

ps_revert_change no puede deshacer: la creación de un tema hijo, la instalación, actualización o desinstalación de un módulo, DDL, imágenes borradas, un producto creado que ya está en un pedido, cambios de URL (usa un nuevo ps_change_url), ediciones de archivos (usa las copias de archivos). Deshacer un cambio de Ventas, Tema, Módulos o Mantenimiento necesita ese interruptor; la tarjeta Historial de cambios y deshacer puede deshacer cualquier cosa con los permisos del empleado que ha iniciado sesión. Las entradas cifradas del historial necesitan el archivo de clave.

URL

Cambio de URL bloqueado.

ps_change_url se niega cuando la redirección canónica es 302 (Parámetros de la tienda > Tráfico y SEO, pon 301), el modo de desarrollo está activado (_PS_MODE_DEV_) o un módulo sobrescribe las rutas (UrlGuard; ps_check_shop_health lo nombra). Los cambios de URL del blog necesitan activada la opción «Redirecciones 301 para el blog» en los ajustes.

Redirección rechazada por ps_manage_redirects.

La vista previa solo acepta orígenes que hoy devuelven 404 o 410 y destinos que devuelven 200 en el dominio de la tienda. Las cadenas y los bucles se bloquean. Hasta 100 elementos por add, 100 ID por disable/enable; origen de hasta 1.024 caracteres, URL de destino de hasta 2.048. No hay borrado: usa disable o deshaz desde el historial de cambios.

Archivos, tema y caché

El cambio no se ve después de escribir en el tema.

Ejecuta ps_clear_cache (ámbito smarty; all también vacía la caché de Symfony). Vacía aparte los módulos de caché de página completa y la caché de la CDN.

Error de validación de Smarty.

Solo se permiten etiquetas y modificadores de la lista blanca, y después una compilación de prueba; {php}, {include_php} y el acceso estático a clases se rechazan. No se ha guardado nada.

«search must appear exactly once».

Usa un fragmento más largo o escribe el archivo entero con content.

Acceso al archivo denegado.

Las rutas deben ser relativas, sin .., resolverse dentro de la zona (realpath) y tener una extensión de texto. Siempre denegados: parameters.php/yml, settings.inc.php, .env*, claves y certificados, volcados SQL, archivos comprimidos y .bak, .git, var/logs, upload, download, el directorio privado del módulo y el propio módulo.

Escritura de un archivo PHP rechazada.

La comprobación de sintaxis (token_get_all(TOKEN_PARSE)) ha encontrado un error de análisis. Los errores en tiempo de ejecución (por ejemplo, una función no definida) no se detectan; por eso cada escritura PHP tiene una copia y existe la clave de rescate.

Restaurar tras un cambio que rompe la tienda.

ps_list_file_backups, luego ps_restore_file_backup (antes copia la versión actual), luego ps_clear_cache. Si el panel no funciona: abre la dirección de rescate e introduce la clave de emergencia; recupera los archivos cambiados por el conector y desactiva Mantenimiento, pero no toca la base de datos. Para la base de datos usa las copias de la base del módulo (tarjeta Guardado por áreas, Descargar, y luego importa con tus herramientas habituales).

SQL (Mantenimiento)

Consulta rechazada.

Una sola instrucción, sin comentarios que oculten contenido. Nunca accesibles: tablas de empleados, sesiones, accesos y perfiles, configuration (usa ps_config), tablas del webservice y de la API, tablas del conector. Nunca modificables: impuestos, vínculos de módulos de pago, pedidos, estados, pagos, facturas. Operaciones con archivos y usuarios de MySQL bloqueadas. Tablas con datos personales solo en el nivel de datos de clientes pseudo (enmascarado) o full.

ps_db_execute revertido.

Cambiaron más filas de las declaradas, o habría que copiar más de 1000 filas. Acota el WHERE o divide el cambio.

Qué cambió desde la 2.6

Informar de un problema

Envía a [email protected]: dominio, versiones de PrestaShop y PHP, versión del módulo, paquete (Pro o Free), aplicación de chat (Claude o ChatGPT), nombre de la herramienta, texto exacto del error y hora. Envía solo el prefijo del token, nunca el token completo.

---

PrestaShop es una marca registrada de PrestaShop SA. Claude es una marca de Anthropic. ChatGPT es una marca de OpenAI. TellMyShop no está afiliado a ninguna de ellas.