Resolución de Problemas

Esta página proporciona soluciones a problemas comunes que puedes encontrar al usar PrestaShop MCP Server.

Error OAuth: "OAuth no implementado"

Problema: Al conectar tu aplicación de IA a tu MCP Server, recibes un mensaje de error que indica "OAuth no implementado" o un error similar relacionado con OAuth.

Solución:

Este error generalmente ocurre cuando el flujo de autenticación OAuth no se puede completar. Verifica lo siguiente:

1. Configuración de Cloudflare

Si estás usando Cloudflare, verifica que:

• Cloudflare permita el acceso a las rutas .well-known/*
• Estas rutas son esenciales para el proceso de descubrimiento OAuth
• Asegúrate de que Cloudflare no esté bloqueando o almacenando en caché estos puntos finales

2. Configuración .htaccess y .htpasswd

Verifica tu archivo .htaccess para asegurarte de que permite el encabezado Authorization:

# Permitir encabezado Authorization
SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1

El encabezado Authorization es necesario para que la autenticación OAuth funcione correctamente.

Si usas un .htpasswd, necesitas solicitar mcp con autenticación básica en tu URL.

Ejemplo: https://username:password@your_domain.com/mcp

3. Modo de Mantenimiento de PrestaShop

Asegúrate de que tu tienda PrestaShop no esté en modo de mantenimiento:

• El modo de mantenimiento bloquea el acceso externo a tu tienda
• Esto impide que el flujo de autenticación OAuth se complete
• Desactiva el modo de mantenimiento antes de intentar conectar tu aplicación de IA

Consejo: Después de hacer estos cambios, intenta reconectar tu aplicación de IA a tu MCP Server.

Error de Configuración de Conexión: "Se produjo un error durante la configuración de la conexión"

Problema: Al intentar conectar tu aplicación de IA, recibes un mensaje de error que indica "Se produjo un error durante la configuración de la conexión".

Solución:

Este error generalmente ocurre cuando no estás conectado con la cuenta correcta autorizada para acceder al MCP Server.

Verificar Tu Cuenta

1. Ve a accounts.distribution.prestashop.net
2. Verifica la dirección de correo electrónico con la que estás conectado
3. Vuelve a la página de configuración de PS MCP Server y navega a la pestaña "Miembros"
4. Verifica que estés conectado con la dirección de correo electrónico autorizada para conectarse al MCP Server

Si Estás Usando la Cuenta Incorrecta

Si descubres que estás conectado con la cuenta incorrecta:

1. Desconéctate de la cuenta actual
2. Reconéctate con la dirección de correo electrónico autorizada correcta
3. Intenta reconectar tu aplicación de IA

Si tienes un error con Accounts

1. Necesitas restablecer el módulo ps_accounts
2. Vuelve a intentar el paso de incorporación de cuentas

Error de Clase No Encontrada: "class psMcpTools/LanguagesTool not found"

Problema: Encuentras un mensaje de error que indica "class psMcpTools/LanguagesTool not found" o errores similares relacionados con clases del módulo ps_mcp_tools.

Solución:

Este error ocurre cuando la caché de PrestaShop no está sincronizada con la estructura del módulo. Para resolver esto:

Restablecer el Módulo ps_mcp_tools

1. Ve a tu back office de PrestaShop
2. Navega a Módulos > Gestor de módulos
3. Busca "ps_mcp_tools"
4. Haz clic en el menú desplegable junto al módulo
5. Selecciona "Restablecer"
6. Confirma la acción de restablecimiento

Esto reinicializará el módulo y limpiará la caché interna de PrestaShop asociada con él.

💡Consejo: Después de restablecer el módulo, los problemas de carga de clases deberían estar resueltos. Si el problema persiste, intenta limpiar la caché de PrestaShop desde Parámetros avanzados > Rendimiento.

¿Necesitas ayuda?

Si encuentras problemas que no están cubiertos en esta guía de resolución de problemas, puedes contactar con nuestro servicio de soporte en la siguiente URL:

https://care-center.prestashop.com/es/contactenos?form=support&subject=ps_mcp_server

Nuestro equipo de soporte estará encantado de ayudarte con cualquier problema que puedas estar experimentando.