Comércio Agêntico na Jumpseller
Como os agentes de IA descobrem, navegam e compram em uma loja Jumpseller: WebMCP na página, o endpoint MCP para Loja, o Universal Commerce Protoco...
A sua loja virtual pode agora ser gerida por IA. Com a integração MCP da Jumpseller, assistentes de IA se conectam diretamente à sua loja e tratam do trabalho por você. Adicione produtos, processe pedidos, organize o catálogo, consulte clientes, obtenha informações sobre o negócio, e muito mais. Fale, e a IA age.
“Adiciona um produto chamado Vestido de Verão a 49,99 EUR com tamanhos S, M, L, faz upload desta imagem e coloca na categoria Mulher”
Uma frase. A IA cria o produto, configura as variantes, faz upload da imagem e atribui a categoria.
Isso vai além de um atalho. Abre as portas ao comércio agêntico: agentes de IA que trabalham na sua loja sem parar. Podem monitorar o inventário, sugerir alterações de preços com base na demanda, reorganizar o catálogo para campanhas sazonais, ou processar lotes de pedidos enquanto você se foca em fazer crescer o seu negócio.
Seja um comerciante procurando economizar horas de trabalho administrativo, ou um developer construindo a próxima geração de automação para e-commerce, o servidor MCP da Jumpseller lhe dá as ferramentas para isso acontecer.
A Jumpseller funciona com todas as principais plataformas de IA:
Execute as operações diárias. Adicionar produtos, atualizar preços, verificar estados de pedidos, processar envios. Tarefas que levam minutos no painel de administração levam segundos com IA.
Gerencie em massa com linguagem natural. Em vez de editar produtos um a um, diga “reduz o preço de todos os produtos de verão em 20%” e o agente atualiza todos.
Obtenha informações e recomendações. Pergunte “quais produtos estão sem estoque há mais de uma semana?” ou “mostra os 5 melhores clientes por número de pedidos” e obtenha respostas na hora.
Automatize fluxos de trabalho repetitivos. Crie agentes que processam pedidos todas as manhãs, enviam alertas de inventário quando o estoque está baixo, ou preparam o catálogo para um evento de vendas, tudo sem intervenção manual.
Melhore o seu catálogo com IA. Deixe a IA revisar as descrições dos seus produtos, sugerir categorias em falta, identificar produtos sem imagens, ou sinalizar preços inconsistentes entre variantes.
O Model Context Protocol (MCP) é um padrão aberto criado pela Anthropic que permite a agentes de IA usar ferramentas em serviços externos. Pense nele como uma tomada universal que conecta qualquer assistente de IA à sua loja Jumpseller.
Quando conecta a sua loja via MCP, o agente de IA pode ver todas as ferramentas disponíveis (listar produtos, criar pedidos, pesquisar clientes, etc.) e usá-las de forma inteligente para realizar o que você pede.
A Jumpseller se une a plataformas como Shopify, Stripe e PayPal na oferta de suporte MCP, colocando a sua loja na vanguarda do comércio com IA.
Além do uso interativo, o MCP da Jumpseller permite e-commerce agêntico: agentes de IA que gerenciam a sua loja de forma autônoma. Os developers podem criar agentes que:
Usando as ferramentas MCP, qualquer developer pode criar agentes personalizados com Claude Agent SDK, LangChain, ou qualquer framework que suporte MCP. O agente se conecta a https://mcp.jumpseller.com e tem acesso a todas as 27 ferramentas de gestão da loja.
Escolha abaixo a ferramenta de IA que você usa. No Claude, no ChatGPT, no Claude Code e no Codex você só precisa do endereço do servidor: você entra com a sua conta Jumpseller, escolhe a loja e aprova o acesso. Não há chaves para copiar.
URL do servidor: https://mcp.jumpseller.com
Os conectores que você adiciona no claude.ai também ficam disponíveis nos apps do Claude para desktop e celular.
Abra o conector Jumpseller Store no diretório do Claude e clique em Connect to Claude.

Uma página da Jumpseller é aberta: faça login, escolha a sua loja e clique em Authorize.
O Claude mostra as ferramentas da Jumpseller. As ferramentas que só leem dados da loja são executadas na hora; o Claude pede a sua confirmação antes de usar uma ferramenta que altera alguma coisa.

Agora é só perguntar ao Claude sobre a sua loja em qualquer conversa:

Nos planos Team e Enterprise, pode ser preciso que um proprietário da organização no Claude adicione o conector primeiro.
Para conectar mais de uma loja ao mesmo tempo, adicione a Jumpseller como conector personalizado, uma vez por loja (veja Gerenciar Várias Lojas).
Abra Customize → Connectors, clique em Add e escolha Add custom connector.

Informe um Name, como Jumpseller, e a URL https://mcp.jumpseller.com. Clique em Continue.

Mantenha Sign in now. Em OAuth client, escolha Use Claude’s published identity: a Jumpseller reconhece o Claude sozinha, então não há client ID para informar. Clique em Add.

Clique em Connect. Uma página da Jumpseller é aberta: faça login, escolha a sua loja e clique em Authorize.
Abra Plugins na barra lateral, clique em Add e escolha Add custom MCP server. Se essa opção não aparecer, ative o Developer mode em Settings → Security and login.

Informe um Name e a URL https://mcp.jumpseller.com, e mantenha OAuth como autenticação. O ChatGPT encontra sozinho as configurações de login da Jumpseller, então deixe Advanced OAuth settings como estão. Marque I understand and want to continue e clique em Create as a plugin.

Clique em Continue to …. Uma página da Jumpseller é aberta: faça login, escolha a sua loja e clique em Authorize.

Em uma conversa, clique em +, escolha o plugin e faça a sua pergunta.


Você também pode usar o GPT da Jumpseller, que faz login da mesma forma.
Adicione o servidor e depois faça login de dentro do Claude Code:
claude mcp add --transport http jumpseller https://mcp.jumpseller.com
Execute /mcp, selecione jumpseller e escolha Authenticate. O navegador abre o login da Jumpseller; escolha a sua loja e clique em Authorize.
O plugin do Kit de IA adiciona este servidor para você, junto com skills para a API da Jumpseller, os temas Liquid e a CLI.
Adicione o servidor ao ~/.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.
O Gemini CLI se conecta com um token API. Instale a extensão da Jumpseller, que já declara o servidor, e siga os passos do Gemini CLI no AI Toolkit.
O Grok se conecta com um token API.
Grok CLI: adicione o servidor uma vez. As aspas simples mantêm os nomes das variáveis na configuração do Grok, e o Grok lê JUMPSELLER_LOGIN_KEY e JUMPSELLER_AUTH_TOKEN do seu ambiente sempre que inicia:
grok mcp add --transport http jumpseller https://mcp.jumpseller.com \
--header 'X-LOGIN-KEY: ${JUMPSELLER_LOGIN_KEY}' \
--header 'X-AUTH-TOKEN: ${JUMPSELLER_AUTH_TOKEN}'
Execute /mcps no Grok para confirmar que o jumpseller está conectado.
API da xAI: adicione a Jumpseller como ferramenta MCP remota nas tools de uma requisição para https://api.x.ai/v1/responses:
{
"type": "mcp",
"server_url": "https://mcp.jumpseller.com",
"server_label": "jumpseller",
"headers": {
"X-LOGIN-KEY": "YOUR_LOGIN_KEY",
"X-AUTH-TOKEN": "YOUR_AUTH_TOKEN"
}
}
Os apps web e mobile do Grok ainda não conseguem se conectar: o login da Jumpseller funciona por enquanto só com o Claude e o ChatGPT.
App Muse (conector personalizado): em uma conversa no Muse, peça ao Muse para criar um conector personalizado para a Jumpseller usando a API REST da Jumpseller, e informe a sua Login Key e o seu Auth Token quando o Muse pedir no prompt seguro de credenciais. O Muse cria esse conector sobre a API REST, então ele não usa as ferramentas MCP listadas abaixo, e a Meta não revisa conectores personalizados. Os conectores personalizados só estão disponíveis onde o Muse é oferecido.
Muse Code: adicione a Jumpseller ao bloco mcp_servers do arquivo de configurações do Muse Code. O Muse Code lê JUMPSELLER_LOGIN_KEY e JUMPSELLER_AUTH_TOKEN do seu ambiente:
{
"mcp_servers": {
"jumpseller": {
"transport": "streamable_http",
"url": "https://mcp.jumpseller.com",
"headers": {
"X-LOGIN-KEY": "${JUMPSELLER_LOGIN_KEY}",
"X-AUTH-TOKEN": "${JUMPSELLER_AUTH_TOKEN}"
}
}
}
}
Execute /mcp no Muse Code para confirmar que o jumpseller está conectado.
Essas ferramentas se conectam com um token API. A mesma configuração funciona em todas; só muda o arquivo:
.cursor/mcp.json na raiz do projeto~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json no Windows)settings.json, dentro de "mcp": { "servers": { … } }
{
"mcpServers": {
"jumpseller": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://mcp.jumpseller.com/",
"--header", "X-LOGIN-KEY:A_SUA_LOGIN_KEY",
"--header", "X-AUTH-TOKEN:O_SEU_AUTH_TOKEN"
]
}
}
}
Qualquer cliente MCP que suporte o transporte Streamable HTTP pode se conectar da mesma forma. Ele descobre as ferramentas através do tools/list.
É assim que o Claude, o ChatGPT, o Claude Code e o Codex se conectam: você entra com a sua conta Jumpseller e a ferramenta de IA recebe um token próprio. O login no servidor MCP é para assistentes de IA; aplicações e integrações de terceiros usam a API REST com OAuth 2.
A conexão age como a pessoa que entrou, então só pode usar o que estas duas coisas permitem:
read_products, write_products para gestão de produtosread_orders, write_orders para gestão de pedidosread_customers para acesso a clientesread_categories, write_categories para gestão de categoriasread_pages, write_pages para gestão de páginasread_store para informação da lojaAlterar as permissões de uma conta vale imediatamente para as suas conexões, e remover a conta da loja as desconecta. Para desconectar uma ferramenta de IA você mesmo, acesse Conta → Preferências, clique no seu nome de usuário e use Revoke em Connected Apps.
Só as contas que pertencem à loja podem conectá-la. Se o Claude ou o ChatGPT pedir para você entrar na Jumpseller de novo, entre mais uma vez: é assim que as conexões antigas passam para a sua própria conta.
Para ferramentas que não conseguem fazer login, como scripts, jobs de CI, Cursor ou Devin Desktop.
X-LOGIN-KEYX-AUTH-TOKENOs tokens API têm acesso total a todas as operações da loja com base nas permissões da sua conta. Mantenha-os em segredo: qualquer pessoa que os tenha pode gerenciar a sua loja.
Cada conexão pertence a uma única loja. Um token API é emitido por uma única loja, e um login é concedido à loja que você escolheu no momento em que o aprovou. A loja não pode ser trocada de dentro de uma conversa.
Por isso, se você administra mais de uma loja Jumpseller, precisa de uma conexão por loja. Como configurar depende da ferramenta.
Além do endereço compartilhado, cada loja tem uma URL de servidor própria:
https://mcp.jumpseller.com/s/CODIGO-LOJA
CODIGO-LOJA é o endereço Jumpseller da sua loja, a parte antes de .jumpseller.com. Você pode vê-lo na barra de endereços do seu painel de administração, e ele continua o mesmo mesmo que use um domínio próprio.
Disso decorrem duas coisas. As ferramentas de IA identificam uma conexão pela URL, então dar a cada loja uma URL diferente permite manter várias lojas conectadas ao mesmo tempo em vez de ficar alternando entre elas. E uma conexão criada assim fica presa à loja indicada na URL: se algum dia for autorizada com a conta de outra loja, ela para e avisa você, em vez de fazer alterações silenciosamente na loja errada.
Adicione um conector (Claude) ou plugin (ChatGPT) por loja, cada um apontando para a URL própria daquela loja. Siga os passos do conector personalizado do Claude ou do ChatGPT, mas use https://mcp.jumpseller.com/s/CODIGO-LOJA como URL e dê a cada um um nome que você reconheça, como “Jumpseller — Cafeteria”.
Saia da sua conta antes de autorizar o segundo. Acesse accounts.jumpseller.com/accounts/sign_out depois de adicioná-lo e antes de aprová-lo. A autorização usa a sessão Jumpseller que você já tem aberta, então, sem esse passo, ninguém pergunta qual loja você quer e a segunda loja é conectada à conta com a qual você já estava logado. Quando isso acontece, a conexão para de funcionar e avisa que as credenciais são de outra loja: remova-a, saia da conta e adicione-a de novo.
Se você apontar os dois para o endereço compartilhado https://mcp.jumpseller.com em vez da URL por loja, o claude.ai recusa o segundo com a mensagem “A server with this URL already exists”: ele identifica um conector pela URL, então os dois precisam de endereços diferentes.
O GPT da Jumpseller se conecta a uma loja por vez e o endereço dele não pode ser alterado. Para trocar de loja, saia da conta no link acima, abra o GPT de novo e faça login com a loja que você quer.
Adicione um servidor por loja, cada um com o seu próprio nome e URL, e faça login em cada um uma vez:
claude mcp add --transport http jumpseller-cafeteria https://mcp.jumpseller.com/s/cafeteria
claude mcp add --transport http jumpseller-livraria https://mcp.jumpseller.com/s/livraria
As duas lojas ficam disponíveis ao mesmo tempo, e você indica ao agente a qual se refere: “Na cafeteria, marque o pedido 1042 como pago.”
Gere um token API no painel de cada loja e declare um servidor por loja:
{
"mcpServers": {
"jumpseller-cafeteria": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://mcp.jumpseller.com/",
"--header", "X-LOGIN-KEY:LOGIN_KEY_CAFETERIA",
"--header", "X-AUTH-TOKEN:AUTH_TOKEN_CAFETERIA"
]
},
"jumpseller-livraria": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://mcp.jumpseller.com/",
"--header", "X-LOGIN-KEY:LOGIN_KEY_LIVRARIA",
"--header", "X-AUTH-TOKEN:AUTH_TOKEN_LIVRARIA"
]
}
}
}
O servidor MCP disponibiliza 27 ferramentas organizadas por área:
Crie, atualize, pesquise e exclua produtos. Inclui suporte completo para variantes (tamanhos, cores), imagens e categorias.
| Ferramenta | O que faz | Acesso |
|---|---|---|
list_products | Listar produtos com paginação | leitura |
get_product | Obter detalhes do produto com imagens, variantes e categorias | leitura |
search_products | Pesquisar por nome, descrição ou SKU | leitura |
create_product | Criar produto com variantes, imagens e categorias | escrita |
update_product | Atualizar qualquer campo, adicionar ou modificar variantes | escrita |
delete_product | Excluir um produto | escrita |
Consulte pedidos, pesquise por cliente ou produto, atualize o estado e adicione informação de rastreio.
| Ferramenta | O que faz | Acesso |
|---|---|---|
list_orders | Listar pedidos com paginação e filtro de estado | leitura |
get_order | Obter detalhes completos do pedido com produtos e cliente | leitura |
search_orders | Pesquisar por ID, nome do cliente, e-mail ou produto | leitura |
update_order | Alterar estado ou adicionar informação de rastreio | escrita |
Pesquise clientes por nome ou e-mail, consulte contatos e endereços.
| Ferramenta | O que faz | Acesso |
|---|---|---|
list_customers | Listar clientes com paginação | leitura |
get_customer | Obter detalhes do cliente com endereços | leitura |
search_customers | Pesquisar por nome ou e-mail | leitura |
Gerencie as categorias de produtos e organize o catálogo.
| Ferramenta | O que faz | Acesso |
|---|---|---|
list_categories | Listar todas as categorias em árvore | leitura |
create_category | Criar uma nova categoria | escrita |
delete_category | Excluir uma categoria | escrita |
Crie e gerencie páginas da loja como Sobre Nós, Contato e Políticas.
| Ferramenta | O que faz | Acesso |
|---|---|---|
list_pages | Listar páginas da loja | leitura |
create_page | Criar uma nova página | escrita |
update_page | Atualizar uma página existente | escrita |
delete_page | Excluir uma página | escrita |
list_page_categories | Listar as categorias às quais as páginas podem pertencer | leitura |
list_page_templates | Listar os templates disponíveis para páginas | leitura |
| Ferramenta | O que faz | Acesso |
|---|---|---|
get_store_info | Obter nome, URL, país, moeda e e-mail da loja | leitura |
| Ferramenta | O que faz | Acesso |
|---|---|---|
prepare_upload | Obter um link de upload direto para imagens grandes demais para enviar na mensagem | escrita |
Imagens pequenas podem ser enviadas diretamente ao agente. As maiores (acima de cerca de 7 MB) precisam do prepare_upload, que devolve um link temporário para enviar o arquivo diretamente ao armazenamento. O agente cuida disso para você.
Para o que as ferramentas acima não conseguem fazer, o agente pode pesquisar como fazer no painel de administração em vez de adivinhar.
| Ferramenta | O que faz | Acesso |
|---|---|---|
search_support_docs | Pesquisar nos artigos de suporte da Jumpseller | leitura |
list_admin_routes | Listar as páginas do painel de administração | leitura |
recommend_admin_route | Indicar a página do painel para uma tarefa que as ferramentas não conseguem executar | leitura |
“Cria 5 produtos para uma cafetaria: Espresso a 3 EUR, Latte a 4,50 EUR, Cappuccino a 4,50 EUR, Americano a 3,50 EUR e Mocha a 5 EUR. Todos com tamanhos Pequeno e Grande. O tamanho Grande custa mais 1 EUR.”
O agente cria os 5 produtos com 2 variantes de tamanho cada, ajustando os preços automaticamente.
“Mostra todos os pedidos pendentes desta semana. Marca os de Portugal como pagos e adiciona o rastreio PT123456 dos CTT.”
O agente pesquisa pedidos, filtra por país e atualiza cada um com o estado e informação de rastreio.
“Cria uma categoria ‘Promoções Black Friday’ e move todos os produtos com preço acima de 50 EUR para lá”
O agente cria a categoria, pesquisa os produtos que correspondem e os reatribui.
“Quantos produtos tenho? Quantos estão sem estoque?”
O agente lista os produtos, conta-os e identifica quais têm estoque zero.
O servidor MCP permite 100 pedidos por minuto por conta. Isso é mais do que suficiente para sessões interativas com IA. Se exceder este limite, você receberá uma resposta 429 Too Many Requests.
Comece seu teste grátis de 7 dias. Sem necessidade de cartão de crédito.