Whatalo MCP

Conecta tu tienda Whatalo a asistentes de IA mediante el servidor MCP de Whatalo. Tú decides qué datos compartes y puedes revocar el acceso cuando quieras.

Puedes conectar tu tienda Whatalo a herramientas de IA compatibles para que consulten tu catálogo, tus pedidos y tus clientes, y realicen acciones en tu nombre, como actualizar un producto o cambiar el estado de un pedido.

La conexión se hace a través del servidor MCP de Whatalo (Model Context Protocol), un estándar abierto para conectar asistentes de IA a plataformas. La herramienta de IA solo accede a los datos que tú autorizas durante la conexión.

Antes de conectar una herramienta, revisa qué estás autorizando, qué datos se comparten y de qué eres responsable.

Cómo funciona la conexión

Agregas la dirección del servidor MCP de Whatalo en tu herramienta de IA.
Autorizas el acceso a tu tienda y eliges qué permisos otorgas.
La herramienta de IA puede leer y modificar los datos de tu tienda dentro de los permisos que concediste.

El alcance del acceso depende de los permisos que apruebes. Puedes revocar el acceso en cualquier momento desde la configuración de tu tienda.

Qué puede hacer la IA en tu tienda

Una vez conectada, la herramienta de IA puede usar las siguientes capacidades. Las acciones que modifican datos están marcadas como tales; el resto solo consulta información.

Tu catálogo

Capacidad	Qué hace	Tipo
Listar productos	Consulta productos con filtros por estado, categoría, destacados, rango de precio y stock	Lectura
Ver un producto	Muestra el detalle completo de un producto	Lectura
Contar productos	Devuelve el total de productos	Lectura
Crear producto	Agrega un producto nuevo	Modifica
Actualizar producto	Cambia los datos de un producto existente	Modifica
Desactivar producto	Oculta un producto de la tienda	Modifica
Eliminar producto	Borra un producto de forma permanente	Modifica
Ver inventario	Consulta el stock de un producto y sus variantes	Lectura
Ajustar inventario	Suma o resta stock con un motivo registrado	Modifica

Tus categorías

Capacidad	Qué hace	Tipo
Listar categorías	Consulta las categorías de la tienda	Lectura
Ver una categoría	Muestra el detalle de una categoría	Lectura
Crear categoría	Agrega una categoría nueva	Modifica
Actualizar categoría	Cambia los datos de una categoría	Modifica
Eliminar categoría	Borra una categoría de forma permanente	Modifica

Tus ventas

Capacidad	Qué hace	Tipo
Listar pedidos	Consulta pedidos con filtros por estado, pago, cliente, fecha, total y ubicación	Lectura
Ver un pedido	Muestra el detalle completo de un pedido	Lectura
Contar pedidos	Devuelve el total de pedidos	Lectura
Ver items de un pedido	Lista las líneas de un pedido	Lectura
Actualizar estado del pedido	Cambia el estado, el estado de pago o las notas internas	Modifica

Tus clientes

Capacidad	Qué hace	Tipo
Buscar clientes	Consulta clientes con filtros por gasto y número de pedidos	Lectura
Ver un cliente	Muestra el detalle de un cliente	Lectura
Contar clientes	Devuelve el total de clientes	Lectura

Configuración de tu tienda

Capacidad	Qué hace	Tipo
Ver información de la tienda	Consulta los datos generales de tu tienda	Lectura

Qué autorizas

Al conectar una herramienta de IA eliges qué áreas de tu tienda puede acceder. Estos son los permisos disponibles:

Permiso	Qué incluye
Tu catálogo	Productos, inventario y categorías: ver y editar
Tus ventas	Pedidos: ver y actualizar su estado
Tus clientes	Clientes: solo lectura
Configuración de tu tienda	Información general de la tienda: solo lectura

Para el detalle técnico de los permisos (los scopes de OAuth), consulta la referencia de scopes.

Conectar tu tienda

La dirección del servidor MCP de Whatalo es:

https://mcp.whatalo.com/commerce

Hay dos formas de autenticar la conexión, según la herramienta de IA que uses.

Opción 1 — Autorización con tu cuenta (recomendada)

Para herramientas que admiten conexión remota, agregas la dirección del servidor y la herramienta te lleva a iniciar sesión en Whatalo. Allí eliges la tienda y apruebas los permisos. No necesitas copiar ninguna clave.

Opción 2 — Clave de API

Para herramientas que requieren una credencial manual, genera una clave de API desde Configuración → Desarrolladores → API Keys y configúrala en tu herramienta como encabezado:

X-API-Key: wk_live_xxxxxxxx

Cada clave de API pertenece a una tienda específica. Si administras varias tiendas, genera una clave por cada una.

Configuración de ejemplo para una herramienta compatible con MCP:

{
  "mcpServers": {
    "whatalo-commerce": {
      "type": "http",
      "url": "https://mcp.whatalo.com/commerce"
    }
  }
}

Datos y privacidad

Cuando conectas una herramienta de IA, esa herramienta es un tercero que procesa los datos de tu tienda según los permisos que le concediste. Tú eres responsable de las acciones que la herramienta realiza en tu tienda, incluidos los cambios en productos, precios y pedidos.

Concede únicamente los permisos que la herramienta necesita.
Revisa con regularidad qué herramientas tienen acceso a tu tienda.
Revoca el acceso de cualquier herramienta que ya no uses.

Revocar el acceso

Puedes revocar el acceso de cualquier herramienta conectada en cualquier momento:

Entra a Configuración → Seguridad → Apps conectadas.
Busca la herramienta que quieres desconectar.
Pulsa Revocar.

Al revocar, se invalidan de inmediato todas las credenciales de esa herramienta para tu tienda. Para volver a usarla, deberás autorizarla de nuevo.

Límites

Las solicitudes pasan por la API de Whatalo, que aplica un límite de 1.000 solicitudes por minuto con claves de producción (wk_live_).
Al superar el límite, las solicitudes responden con un error temporal hasta que la ventana se reinicia.
En esta versión, el acceso a clientes es solo de lectura: la IA puede consultar clientes, pero no crearlos ni modificarlos.

Soporte

¿Problemas para conectar una herramienta? Escríbenos a [email protected] o revisa la documentación de OAuth para detalles técnicos de autenticación.

On this page