maakoo
Iniciar sesiónRegistrarse

Conecta tu IA a tu tienda

Claude, ChatGPT, Cursor y otras apps de IA pueden ver y editar tu catálogo de maakoo por ti: agregar productos, corregir precios, escribir descripciones, subir fotos. Tú decides qué pueden hacer.

Claude.ai y ChatGPT

Sin llaves. La app te pide permiso en una pantalla de maakoo.

  1. En tu panel abre «IA y API» y revisa que el acceso para IA esté activado.
  2. En Claude: Configuración → Conectores → Agregar conector personalizado. En ChatGPT: Configuración → Conectores → Crear (modo desarrollador). Pega https://maakoo.com/api/mcp.
  3. Conecta, inicia sesión en maakoo si te lo pide, revisa la app y la dirección a la que volverás, y acepta los permisos que quieras.

Claude Code, Cursor y scripts

Crea una llave de API en «IA y API» (se muestra una sola vez) y úsala como token Bearer.

claude mcp add --transport http maakoo https://maakoo.com/api/mcp --header "Authorization: Bearer mk_live_…"

Qué puede hacer la IA

  • Ver tus productos y los textos de tu tienda.
  • Agregar y editar productos y fotos, solo en las columnas que tu catálogo ya tiene.
  • Borrar productos o restaurar una copia guardada — solo con los permisos que tú des, y siempre después de mostrarte una vista previa.
  • Editar tus secciones «Nosotros» y «Contacto».

Seguridad

  • Los cambios grandes, los borrados y las restauraciones muestran una vista previa y esperan tu confirmación.
  • Antes de cada cambio grande guardamos una copia de tu catálogo; deshazlo desde «IA y API».
  • Apaga el acceso para IA, revoca una llave o desconecta una app cuando quieras: deja de funcionar al instante.
  • Te avisamos por correo cuando se crea una llave o se conecta una app nueva.
  • Límites por tienda: 100 productos por cambio; las consultas y cambios por minuto están limitados para que ninguna app sature tu tienda.

Para desarrolladores

  • MCP (Streamable HTTP, sin estado): https://maakoo.com/api/mcp — OAuth 2.1 (descubrimiento en /.well-known/oauth-protected-resource/api/mcp) o una llave de API.
  • REST: https://maakoo.com/api/v1 — solo llaves de API. OpenAPI: https://maakoo.com/api/v1/openapi.json (sirve como GPT Action de ChatGPT).
  • Los productos tienen un id estable y una versión: mándala como if_match / If-Match para no sobrescribir el cambio de otra persona.
  • Los errores son JSON con un código; espera Retry-After en 429 y vuelve a leer en version_mismatch.