Pular para o conteúdo principal
Centro de Apoio

Construa na Jumpseller com IA

Quando você pede a um assistente de programação com IA para criar algo na Jumpseller, ele muitas vezes adivinha: limites de requisições errados, endpoints inventados, nomes de ferramentas falsos. O Kit de IA da Jumpseller resolve isso. Instale 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 conexão em tempo real com a sua loja.

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

“Crie um recurso de FOMO / prova social: use o MCP para obter os 10 pedidos mais recentes, gere um snippet Liquid que mostre uma notificação rotativa ‘Alguém acabou de comprar {product}’ em todas as páginas de produto (alternando a cada 30 segundos) e publique-o no tema ativo com a CLI.”

Uma única instrução em linguagem natural orquestra todo o kit: o MCP lê os dados dos pedidos em tempo real, a skill de Liquid gera o componente da loja e a CLI o publica. Esse é o ponto: as peças se combinam.

Por que um kit?

Em vez de programar integrações na mão, você pode usar o toolkit para conectar sua loja aos sistemas que já utiliza através de um fluxo de desenvolvimento assistido por IA: faturamento, gestão de estoque e armazéns, programas de fidelidade e recompensas, CRMs, ERPs, software de contabilidade, provedores de frete e logística, plataformas de email marketing e painéis de analytics ou BI. Basta descrever o que você precisa em linguagem natural e deixar que o Claude Code, o OpenAI Codex ou o Gemini CLI construam a integração para você, 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 requisições, webhooks e exemplos verificados de requisição/resposta.
  • Skill de temas Liquid — objetos globais, filtros, estrutura de arquivos do tema e o sistema de configurações de componentes.
  • Skill do servidor MCP — as 27 ferramentas de gerenciamento da loja e padrões comuns de várias etapas. Veja Gerencie a sua Loja Virtual com IA para o servidor MCP em si.
  • Skill da CLI — gerenciamento de credenciais e desenvolvimento local de temas (exportar, importar, watch, publicar) com a Jumpseller CLI.
  • Servidor MCP pré-configurado — conectado a https://mcp.jumpseller.com para que o assistente possa atuar em uma loja real. Você entra 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 precisar estar em nenhum marketplace oficial. Dois comandos e pronto.

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

Passo 1 — registrar 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 registrado no passo 1 (o nome do repositório), não uma versão. Após os dois passos, abra uma nova sessão do Claude Code e as skills carregam automaticamente.

Passo 3 — conectar a sua loja: execute /mcp, selecione jumpseller e escolha Authenticate. O navegador abre o login 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 entrar com a sua conta Jumpseller, então ele se conecta 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: você deve ver jumpseller e ferramentas como list_orders. Se nenhuma ferramenta aparecer, as variáveis não estavam definidas quando o Gemini iniciou.

Problema conhecido do Gemini CLI: as ferramentas de listagem e busca (list_orders, list_products, search_*, …) falham no momento com expected record, received array. É um bug do Gemini CLI (gemini-cli#15375), não da Jumpseller: as ferramentas de um único 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 navegador que se abrir.

Credenciais

O servidor MCP não precisa de credenciais: o Claude Code e o Codex entram com a sua conta Jumpseller, e a conexão só pode fazer o que a sua conta pode. Você pode desconectá-la em Conta → Preferências → seu nome de usuário → Connected Apps. O Gemini CLI é a exceção: ele usa o token API abaixo (veja 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 em commits. O mesmo par também funciona como headers MCP para scripts e CI que não conseguem fazer login (veja Token API). Para apps de terceiros, use OAuth 2.0.

Próximos passos

Artigos Relacionados

Nesta página

Comece a sua jornada com a gente!

Comece seu teste grátis de 7 dias. Sem necessidade de cartão de crédito.

Criar Loja