Croqueta MCP PS

Conecta Claude y Codex con tu tienda PrestaShop por MCP

Le pides a Claude o a Codex que revise tus pedidos o cambie cien precios, y la respuesta es que no puede entrar en tu tienda: acabas copiando y pegando datos del back office a mano.

Model Context Protocol es el estándar con el que los asistentes de IA se conectan a sistemas externos. Este módulo publica un endpoint MCP dentro de la propia tienda, de modo que el asistente consulta y opera sobre datos reales en lugar de trabajar a ciegas. No hay servicio intermedio: las llamadas van directas a tu PrestaShop, con token, permisos y registro de cada acción.

Para quién es: Tiendas y agencias que ya trabajan con Claude Code, Claude Desktop o Codex y quieren delegarles tareas de operación —revisar el catálogo, investigar un pedido, preparar un cambio de precios— sin darles acceso libre al servidor.

Qué hace

Capacidades del módulo

51 herramientas sobre la tienda

Catálogo, pedidos, clientes, configuración, módulos, base de datos, ficheros y consola de Symfony. Un CRUD genérico alcanza unas 70 entidades de PrestaShop más cualquier clase que extienda ObjectModel, así que la cobertura no se limita a la lista de herramientas.

Tres capas de control de acceso

Interruptores del servidor por capacidad (escritura, SQL, módulos, ficheros, sistema), permisos por token y confirmación explícita en todo lo irreversible. La escritura SQL, los ficheros y las acciones de sistema vienen apagados de serie.

Tokens revocables y auditoría completa

Cada token lleva sus ámbitos, caducidad y lista de IP opcional, y solo se guarda su hash. Cada llamada queda registrada con argumentos, resultado, duración e IP de origen, enmascarando lo que parezca una credencial.

Conexión con Claude Code, Claude Desktop y Codex

Claude Code se conecta por HTTP directamente. Para los clientes que solo hablan stdio, el módulo incluye un puente en Node sin dependencias, y el panel muestra la configuración de los tres con la URL de tu tienda ya puesta.

Puesta en marcha

Cómo se instala

  1. 01Sube el ZIP desde Módulos → Gestor de módulos → Subir un módulo e instálalo.
  2. 02Abre la configuración y enciende solo las capacidades que vaya a necesitar el asistente.
  3. 03Crea un token con los permisos justos y cópialo: se muestra una única vez.
  4. 04Pega en tu cliente MCP la configuración que genera el panel y comprueba la conexión con ps_shop_info.

Requisitos

Qué necesitas

  • PrestaShop 8.0 a 9.x
  • PHP 8.1 o superior, con las extensiones curl y json
  • Un cliente MCP: Claude Code, Claude Desktop, Codex u otro compatible
  • Node.js solo si usas el puente stdio
  • proc_open habilitado solo para ejecutar comandos de consola

Lo que este módulo no hace

  • No incluye el asistente de IA: necesitas tu propia suscripción o acceso a Claude, Codex u otro cliente MCP.
  • Sin licencia funciona la lectura y la escritura habitual; SQL de escritura, ficheros, acciones sobre módulos, caché, mantenimiento, depuración, consola y cambios de precio en lote requieren la licencia.
  • Da al asistente el poder que le concedas: un token con todos los permisos puede cambiar cualquier dato de la tienda, por eso los ámbitos y la confirmación existen.
  • Las lecturas se limitan a un número máximo de filas configurable y las peticiones de más de 4 MB se rechazan.

Dudas frecuentes

Preguntas sobre Croqueta MCP PS

¿Mis datos pasan por los servidores de Croqueta Digital?

No. El endpoint vive en tu tienda y el cliente MCP habla directamente con ella. Lo único que sale hacia nuestro servidor es la comprobación periódica de la licencia.

¿Qué pasa si el asistente intenta borrar algo por error?

Toda acción irreversible exige que la llamada lleve una confirmación explícita, y la idea es que el asistente te la pida antes. Además puedes crear tokens de solo lectura y dejar apagadas las capacidades peligrosas desde el panel.

¿Puedo tener varios tokens para distintas personas o herramientas?

Sí. Cada token tiene nombre, permisos, caducidad e IP permitidas propios, y se puede revocar sin afectar a los demás. La auditoría indica qué token hizo cada llamada.

¿Funciona sin licencia?

Sí, en el nivel gratuito: lectura de la tienda y escritura habitual de productos, pedidos, clientes, configuración, vales y stock. La licencia desbloquea las herramientas de infraestructura.

¿Encaja con tu tienda?

Cuéntanos tu caso y te decimos si Croqueta MCP PS resuelve tu problema. Si no lo resuelve, te lo decimos también.

Hablar con el equipo