Construye en Jumpseller con IA

Cuando le pides a un asistente de programación con IA que construya algo en Jumpseller, muchas veces adivina: límites de peticiones equivocados, endpoints inventados, nombres de herramientas falsos. El Kit de IA de Jumpseller soluciona esto. Instálalo una vez y tu asistente obtiene conocimiento preciso y específico de la plataforma sobre la API REST de Jumpseller, el sistema de plantillas Liquid, el servidor MCP y la CLI de Jumpseller, además de una conexión en tiempo real con tu tienda.

El kit es de código abierto y está disponible en github.com/Jumpseller/ai.

“Crea una función de FOMO / prueba social: usa el MCP para obtener los 10 pedidos más recientes, genera un snippet de Liquid que muestre una notificación rotativa ‘Alguien acaba de comprar {product}’ en cada página de producto (cambiando cada 30 segundos) y despliégalo al tema activo con la CLI.”

Una sola instrucción en lenguaje natural orquesta todo el kit: el MCP lee los datos de pedidos en tiempo real, la skill de Liquid genera el componente de la tienda y la CLI lo despliega. Ese es el punto: las piezas se combinan.

¿Por qué un kit?

En lugar de programar integraciones a mano, puedes usar el toolkit para conectar tu tienda con los sistemas que ya utilizas mediante un flujo de desarrollo asistido por IA: facturación, gestión de inventario y bodegas, programas de fidelización y recompensas, CRMs, ERPs, software de contabilidad, proveedores de envío y logística, plataformas de email marketing y paneles de analítica o BI. Solo describe lo que necesitas en lenguaje natural y deja que Claude Code, OpenAI Codex o Gemini CLI construyan la integración por ti, con contexto preciso de Jumpseller en cada paso.

Herramientas de IA compatibles

• Claude Code — CLI de programación de Anthropic
• Gemini CLI — CLI de programación de Google
• OpenAI Codex — CLI de programación de OpenAI

Qué incluye

• Skill de la API REST — autenticación, todos los recursos, paginación, límites de peticiones, webhooks y ejemplos verificados de petición/respuesta.
• Skill de temas Liquid — objetos globales, filtros, estructura de archivos del tema y el sistema de configuración de componentes.
• Skill del servidor MCP — las 27 herramientas de gestión de la tienda y patrones comunes de varios pasos. Consulta Administra tu Tienda Online con IA para el servidor MCP en sí.
• Skill de la CLI — gestión de credenciales y desarrollo local de temas (exportar, importar, watch, desplegar) con la Jumpseller CLI.
• Servidor MCP preconfigurado — conectado a https://mcp.jumpseller.com para que el asistente pueda actuar sobre una tienda real. Inicias sesión con tu cuenta Jumpseller; no hay claves que copiar.

Instalación

Las instrucciones completas por cliente están en el README del repositorio. En resumen:

Claude Code

Claude Code permite instalar plugins directamente desde repos de GitHub — sin necesidad de estar en ningún marketplace oficial. Dos comandos y listo.

Requisito previo: estos comandos requieren la CLI de Claude Code (ejecuta claude en tu terminal o usa la app de escritorio). No funcionan en la interfaz web de claude.ai.

Paso 1 — registrar el repo de GitHub como fuente (una vez por máquina):

/plugin marketplace add Jumpseller/ai

Paso 2 — instalar el plugin desde esa fuente:

/plugin install jumpseller-plugin@ai

@ai es el alias del marketplace registrado en el paso 1 (el nombre del repo), no una versión. Tras ambos pasos, abre una nueva sesión de Claude Code y las skills se cargan automáticamente.

Paso 3 — conectar tu tienda: ejecuta /mcp, selecciona jumpseller y elige Authenticate. Tu navegador abre el inicio de sesión de Jumpseller: elige tu tienda y haz clic en Authorize. No hay claves que copiar. Instrucciones completas en el README del repositorio.

Gemini CLI

Gemini CLI todavía no puede iniciar sesión con tu cuenta Jumpseller, así que se conecta con un token API.

1. Exporta tu Login Key y tu Auth Token antes de iniciar Gemini:

   export JUMPSELLER_LOGIN_KEY=your_login_key
   export JUMPSELLER_AUTH_TOKEN=your_auth_token
   

2. Instala la extensión:

   gemini extensions install https://github.com/Jumpseller/ai
   

3. Inicia gemini y ejecuta /mcp: deberías ver jumpseller y herramientas como list_orders. Si no aparece ninguna herramienta, las variables no estaban definidas cuando Gemini arrancó.

Problema conocido de Gemini CLI: las herramientas de listado y búsqueda (list_orders, list_products, search_*, …) fallan por ahora con expected record, received array. Es un bug de Gemini CLI (gemini-cli#15375), no de Jumpseller: las herramientas de un solo elemento, como get_order, y todos los cambios funcionan.

OpenAI Codex

Codex lee los servidores MCP desde ~/.codex/config.toml:

[mcp_servers.jumpseller]
url = "https://mcp.jumpseller.com"

Luego ejecuta codex mcp login jumpseller y aprueba el acceso en la ventana del navegador que se abre.

Credenciales

El servidor MCP no necesita credenciales: Claude Code y Codex inician sesión con tu cuenta Jumpseller, y la conexión solo puede hacer lo que tu cuenta puede hacer. Puedes desconectarla desde Cuenta → Preferencias → tu nombre de usuario → Connected Apps. Gemini CLI es la excepción: usa el token API de abajo (revisa Gemini CLI).

La API REST y la CLI usan una Login Key y un Auth Token por tienda, desde tu Admin de Jumpseller en Editar Cuenta → API y MCP. Configúralos como las variables de entorno JUMPSELLER_LOGIN_KEY y JUMPSELLER_AUTH_TOKEN antes de iniciar tu cliente de IA, y nunca los incluyas en un commit. El mismo par también funciona como headers MCP para scripts y CI que no pueden iniciar sesión (ver Token API). Para apps de terceros, usa OAuth 2.0.

Hacia dónde seguir

• Administra tu Tienda Online con IA — el servidor MCP en detalle
• Soporte para la API de Jumpseller — la API REST
• Crea una Tienda Online Personalizada — temas Liquid
• Webhooks de la Tienda — notificaciones de eventos en tiempo real