Saltar para o conteúdo principal
Centro de Suporte

Construa na Jumpseller com IA

Quando pede a um assistente de programação com IA para criar algo na Jumpseller, ele muitas vezes adivinha: limites de pedidos errados, endpoints inventados, nomes de ferramentas falsos. O Kit de IA da Jumpseller resolve isto. Instale-o uma vez e o seu assistente ganha conhecimento preciso e específico da plataforma sobre a API REST da Jumpseller, o sistema de templates Liquid, o servidor MCP e a CLI da Jumpseller, além de uma ligação em tempo real à sua loja.

O kit é open source e está disponível em github.com/Jumpseller/ai.

“Cria uma funcionalidade de FOMO / prova social: usa o MCP para obter as 10 encomendas mais recentes, gera um snippet Liquid que mostra uma notificação rotativa ‘Alguém acabou de comprar {product}’ em todas as páginas de produto (a cada 30 segundos) e publica-o no tema ativo com a CLI.”

Um único pedido em linguagem natural orquestra todo o kit: o MCP lê os dados das encomendas em tempo real, a skill de Liquid gera o componente da loja e a CLI publica-o. É esse o ponto: as peças combinam-se.

Porquê um kit?

Em vez de programar integrações à mão, pode usar o toolkit para ligar a sua loja aos sistemas que já utiliza através de um fluxo de desenvolvimento assistido por IA: faturação, gestão de inventário e armazéns, programas de fidelização e recompensas, CRMs, ERPs, software de contabilidade, fornecedores de envio e logística, plataformas de email marketing e painéis de analítica ou BI. Basta descrever o que precisa em linguagem natural e deixar que o Claude Code, o OpenAI Codex ou o Gemini CLI construam a integração por si, com contexto preciso da Jumpseller em cada passo.

Ferramentas de IA compatíveis

O que inclui

  • Skill da API REST — autenticação, todos os recursos, paginação, limites de pedidos, webhooks e exemplos verificados de pedido/resposta.
  • Skill de temas Liquid — objetos globais, filtros, estrutura de ficheiros do tema e o sistema de configurações de componentes.
  • Skill do servidor MCP — as 27 ferramentas de gestão da loja e padrões comuns de múltiplos passos. Consulte Gerencie a sua Loja Online com IA para o servidor MCP em si.
  • Skill da CLI — gestão de credenciais e desenvolvimento local de temas (exportar, importar, watch, publicar) com a Jumpseller CLI.
  • Servidor MCP pré-configurado — ligado a https://mcp.jumpseller.com para que o assistente possa atuar numa loja real. Inicia sessão com a sua conta Jumpseller; não há chaves para copiar.

Instalação

As instruções completas por cliente estão no README do repositório. Em resumo:

Claude Code

O Claude Code permite instalar plugins diretamente de repositórios GitHub — sem necessidade de estar num marketplace oficial. Dois comandos e está feito.

Pré-requisito: estes comandos requerem a CLI do Claude Code (execute claude no seu terminal ou use a app de secretária). Não funcionam na interface web do claude.ai.

Passo 1 — registar o repositório GitHub como fonte (uma vez por máquina):

/plugin marketplace add Jumpseller/ai

Passo 2 — instalar o plugin a partir dessa fonte:

/plugin install jumpseller-plugin@ai

@ai é o alias do marketplace registado no passo 1 (o nome do repositório), não uma versão. Após ambos os passos, abra uma nova sessão do Claude Code e as skills carregam automaticamente.

Passo 3 — ligar a sua loja: execute /mcp, selecione jumpseller e escolha Authenticate. O browser abre o início de sessão da Jumpseller: escolha a sua loja e clique em Authorize. Não há chaves para copiar. Instruções completas no README do repositório.

Gemini CLI

O Gemini CLI ainda não consegue iniciar sessão com a sua conta Jumpseller, por isso liga-se com um token API.

  1. Exporte a sua Login Key e o seu Auth Token antes de iniciar o Gemini:

    export JUMPSELLER_LOGIN_KEY=your_login_key
export JUMPSELLER_AUTH_TOKEN=your_auth_token

  2. Instale a extensão:

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

  3. Inicie o gemini e execute /mcp: deve ver jumpseller e ferramentas como list_orders. Se não aparecer nenhuma ferramenta, as variáveis não estavam definidas quando o Gemini arrancou.

Problema conhecido do Gemini CLI: as ferramentas de listagem e pesquisa (list_orders, list_products, search_*, …) falham neste momento com expected record, received array. É um bug do Gemini CLI (gemini-cli#15375), não da Jumpseller: as ferramentas de um só item, como get_order, e todas as alterações funcionam.

OpenAI Codex

O Codex lê os servidores MCP a partir de ~/.codex/config.toml:

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

Depois execute codex mcp login jumpseller e aprove o acesso na janela do browser que se abre.

Credenciais

O servidor MCP não precisa de credenciais: o Claude Code e o Codex iniciam sessão com a sua conta Jumpseller, e a ligação só pode fazer o que a sua conta pode. Pode desligá-la em Conta → Preferências → o seu nome de utilizador → Connected Apps. O Gemini CLI é a exceção: usa o token API abaixo (consulte Gemini CLI).

A API REST e a CLI usam uma Login Key e um Auth Token por loja, no seu Admin da Jumpseller em Editar Conta → API e MCP. Defina-os como as variáveis de ambiente JUMPSELLER_LOGIN_KEY e JUMPSELLER_AUTH_TOKEN antes de iniciar o seu cliente de IA, e nunca os inclua num commit. O mesmo par também funciona como headers MCP para scripts e CI que não conseguem iniciar sessão (ver Token API). Para apps de terceiros, use OAuth 2.0.

Para onde seguir

Artigos Relacionados

Nesta página

Comece a vender connosco!

Comece o seu período experimental gratuito de 7 dias. Sem necessidade de cartão de crédito.

Criar Loja