Jumpseller

Gerencie sua loja de e-commerce Jumpseller com IA. Crie produtos com variações, processe pedidos, pesquise clientes e organize seu catálogo.

Documentação

Documentação da API Jumpseller

Especificação oficial OpenAPI 3.0.3 para a API da plataforma de ecommerce Jumpseller.

Visão Geral da API

A API Jumpseller permite criar e gerenciar lojas online programaticamente. Ela abrange:

  • Lojas - Criar, configurar e gerenciar lojas online
  • Produtos - CRUD completo com variantes, imagens, categorias e campos personalizados
  • Pedidos - Criar, atualizar, buscar e atender pedidos
  • Clientes - Gerenciar contas e grupos de clientes
  • Envio - Configurar métodos e taxas de envio
  • Pagamentos - Configurar gateways de pagamento
  • Temas - Aplicar e personalizar temas da loja
  • Webhooks - Assinar eventos da loja
  • Páginas e Categorias - Gerenciar conteúdo e navegação da loja

Início Rápido

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

Autenticação: Autenticação básica com seu login e token de autenticação (encontrado no seu Painel Administrativo > Conta).

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

Recursos

Servidor MCP (Agentes de IA)

A Jumpseller fornece um servidor dedicado Model Context Protocol (MCP) que expõe 20 ferramentas de gerenciamento de loja para agentes de IA como Claude, Cursor, Windsurf e GitHub Copilot.

URL do Servidor: https://mcp.jumpseller.com

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

Documentação: jumpseller.com/support/mcp-server

Configuração 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"
      ]
    }
  }
}

Adicione isso ao claude_desktop_config.json (Claude), .cursor/mcp.json (Cursor) ou ~/.codeium/windsurf/mcp_config.json (Windsurf). Obtenha suas credenciais em Jumpseller Admin > Configurações > API.

Ferramentas Disponíveis

ÁreaFerramentasAcesso
Produtoslist_products, get_product, search_products, create_product, update_product, delete_productleitura/escrita
Pedidoslist_orders, get_order, search_orders, update_orderleitura/escrita
Clienteslist_customers, get_customer, search_customersleitura
Categoriaslist_categories, create_category, delete_categoryleitura/escrita
Páginaslist_pages, create_page, delete_pageleitura/escrita
Lojaget_store_infoleitura

As ferramentas de produtos suportam variantes (tamanhos, cores), imagens e categorias. As ferramentas são descobertas automaticamente via tools/list.

Autenticação

  • Token de API: X-LOGIN-KEY + X-AUTH-TOKEN cabeçalhos (para proprietários de loja)
  • OAuth 2.0: Authorization: Bearer <token> com permissões escopadas (para aplicativos de terceiros). Veja Guia OAuth 2.

MCP baseado em OpenAPI (alternativa)

Você também pode se conectar via especificação OpenAPI para cobertura completa da API (109 endpoints):

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

Limites de Taxa

  • 800 requisições por minuto
  • 20 requisições por segundo
  • Cabeçalhos de limite de taxa incluídos em cada resposta

Marca e Legal

Licença

Esta documentação é fornecida pela Jumpseller para uso por desenvolvedores e agentes de IA que criam integrações com a plataforma.