Jumpseller

Gestiona tu tienda de comercio electrónico Jumpseller con IA. Crea productos con variantes, procesa pedidos, busca clientes y organiza tu catálogo.

Documentación

Documentación de la API de Jumpseller

Especificación oficial OpenAPI 3.0.3 para la API de la plataforma de comercio electrónico Jumpseller.

Descripción General de la API

La API de Jumpseller te permite crear y gestionar tiendas en línea de forma programática. Cubre:

  • Tiendas - Crear, configurar y gestionar tiendas en línea
  • Productos - CRUD completo con variantes, imágenes, categorías y campos personalizados
  • Pedidos - Crear, actualizar, buscar y gestionar pedidos
  • Clientes - Gestionar cuentas y grupos de clientes
  • Envíos - Configurar métodos y tarifas de envío
  • Pagos - Configurar pasarelas de pago
  • Temas - Aplicar y personalizar temas de tienda
  • Webhooks - Suscribirse a eventos de la tienda
  • Páginas y Categorías - Gestionar contenido y navegación de la tienda

Inicio Rápido

URL Base: https://api.jumpseller.com/v1

Autenticación: Autenticación básica con tu usuario y token de autenticación (disponible en tu Panel de Administración > Cuenta).

curl -u YOUR_LOGIN:YOUR_AUTHTOKEN https://api.jumpseller.com/v1/products.json

Recursos

Servidor MCP (Agentes de IA)

Jumpseller proporciona un servidor dedicado de Protocolo de Contexto de Modelo (MCP) que expone 20 herramientas de gestión de tiendas a agentes de IA como Claude, Cursor, Windsurf y GitHub Copilot.

URL del servidor: https://mcp.jumpseller.com

Transporte: HTTP Streamable (JSON-RPC sobre POST, sin estado)

Documentación: jumpseller.com/support/mcp-server

Configuración Rápida

{
  "mcpServers": {
    "jumpseller": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.jumpseller.com/",
        "--header", "X-LOGIN-KEY:YOUR_LOGIN_KEY",
        "--header", "X-AUTH-TOKEN:YOUR_AUTH_TOKEN"
      ]
    }
  }
}

Añade esto a claude_desktop_config.json (Claude), .cursor/mcp.json (Cursor) o ~/.codeium/windsurf/mcp_config.json (Windsurf). Obtén tus credenciales desde Jumpseller Admin > Configuración > API.

Herramientas Disponibles

ÁreaHerramientasAcceso
Productoslist_products, get_product, search_products, create_product, update_product, delete_productlectura/escritura
Pedidoslist_orders, get_order, search_orders, update_orderlectura/escritura
Clienteslist_customers, get_customer, search_customerslectura
Categoríaslist_categories, create_category, delete_categorylectura/escritura
Páginaslist_pages, create_page, delete_pagelectura/escritura
Tiendaget_store_infolectura

Las herramientas de productos admiten variantes (tallas, colores), imágenes y categorías. Las herramientas se descubren automáticamente mediante tools/list.

Autenticación

  • Token de API: X-LOGIN-KEY + encabezados X-AUTH-TOKEN (para propietarios de tiendas)
  • OAuth 2.0: Authorization: Bearer <token> con permisos limitados (para aplicaciones de terceros). Consulta la Guía de OAuth 2.

MCP basado en OpenAPI (alternativa)

También puedes conectarte mediante la especificación OpenAPI para una cobertura completa de la API (109 endpoints):

npx openmcp install https://api.jumpseller.com/swagger.json --client cursor

Límites de Velocidad

  • 800 solicitudes por minuto
  • 20 solicitudes por segundo
  • Los encabezados de límite de velocidad se incluyen en cada respuesta

Marca y Legal

Licencia

Esta documentación es proporcionada por Jumpseller para uso de desarrolladores y agentes de IA que crean integraciones con la plataforma.