Comércio Agêntico na Jumpseller
Como os agentes de IA descobrem, navegam e compram numa loja Jumpseller: WebMCP na página, o endpoint MCP para Loja, o Universal Commerce Protocol ...
A sua loja online pode agora ser gerida por IA. Com a integração MCP da Jumpseller, assistentes de IA ligam-se diretamente à sua loja e tratam do trabalho por si. Adicione produtos, processe encomendas, organize o catalogo, 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.
Isto vai para além de um atalho. Abre as portas ao comercio agêntico: agentes de IA que trabalham na sua loja sem parar. Podem monitorizar o inventário, sugerir alterações de preços com base na procura, reorganizar o catalogo para campanhas sazonais, ou processar lotes de encomendas enquanto se foca em fazer crescer o seu negócio.
Seja um comerciante a procura de poupar horas de trabalho administrativo, ou um developer a construir a próxima geração de automação para e-commerce, o servidor MCP da Jumpseller dá-lhe as ferramentas para o fazer 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 encomendas, processar envios. Tarefas que demoram 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 stock há mais de uma semana?” ou “mostra os 5 melhores clientes por número de encomendas” e obtenha respostas na hora.
Automatize fluxos de trabalho repetitivos. Crie agentes que processam encomendas todas as manhãs, enviam alertas de inventário quando o stock está baixo, ou preparam o catalogo para um evento de vendas, tudo sem intervenção manual.
Melhore o seu catalogo com IA. Deixe a IA rever 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 utilizar ferramentas em serviços externos. Pense nele como uma ficha universal que liga 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 encomendas, pesquisar clientes, etc.) e usá-las de forma inteligente para realizar o que pede.
A Jumpseller junta-se a plataformas como Shopify, Stripe e PayPal na oferta de suporte MCP, colocando a sua loja na vanguarda do comércio com IA.
Para além do uso interativo, o MCP da Jumpseller permite e-commerce agêntico: agentes de IA que gerem 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 conecta-se 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 usa. No Claude, no ChatGPT, no Claude Code e no Codex só precisa do endereço do servidor: inicia sessão 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 adicionar no claude.ai ficam também disponíveis nas apps de secretária e móvel do Claude.
Abra o conector Jumpseller Store no diretório do Claude e clique em Connect to Claude.

Abre-se uma página da Jumpseller: inicie sessão, escolha a sua loja e clique em Authorize.
O Claude mostra as ferramentas da Jumpseller. As ferramentas que só leem a sua loja são executadas de imediato; o Claude pergunta-lhe antes de usar uma ferramenta que altera alguma coisa.

Agora pergunte ao Claude sobre a sua loja em qualquer conversa:

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

Introduza um Name, por exemplo Jumpseller, e o 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 por si só, por isso não há nenhum client ID para introduzir. Clique em Add.

Clique em Connect. Abre-se uma página da Jumpseller: inicie sessão, escolha a sua loja e clique em Authorize.
Abra Plugins na barra lateral, clique em Add e escolha Add custom MCP server. Se não vir esta opção, ative o Developer mode em Settings → Security and login.

Introduza um Name e o URL https://mcp.jumpseller.com, e mantenha OAuth como autenticação. O ChatGPT encontra sozinho as definições de início de sessão da Jumpseller, por isso deixe as Advanced OAuth settings como estão. Marque I understand and want to continue e clique em Create as a plugin.

Clique em Continue to …. Abre-se uma página da Jumpseller: inicie sessão, escolha a sua loja e clique em Authorize.

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


Também pode usar o GPT da Jumpseller, que inicia sessão da mesma forma.
Adicione o servidor e depois inicie sessão a partir do Claude Code:
claude mcp add --transport http jumpseller https://mcp.jumpseller.com
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.
O plugin do Kit de IA adiciona este servidor por si, juntamente com skills para a API da Jumpseller, os temas Liquid e a CLI.
Adicione o servidor a ~/.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.
O Gemini CLI liga-se 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 liga-se 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 arranca:
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á ligado.
API da xAI: adicione a Jumpseller como ferramenta MCP remota nas tools de um pedido a 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"
}
}
As apps web e móvel do Grok ainda não se conseguem ligar: o início de sessão da Jumpseller funciona por agora apenas com o Claude e o ChatGPT.
App Muse (conector personalizado): numa conversa no Muse, peça ao Muse para criar um conector personalizado para a Jumpseller usando a API REST da Jumpseller, e introduza a sua Login Key e o seu Auth Token quando o Muse os pedir no seu pedido seguro de credenciais. O Muse constrói este conector sobre a API REST, por isso não usa as ferramentas MCP listadas abaixo, e a Meta não revê conectores personalizados. Os conectores personalizados só estão disponíveis onde o Muse é oferecido.
Muse Code: adicione a Jumpseller ao bloco mcp_servers do ficheiro de definiçõ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á ligado.
Estas ferramentas ligam-se com um token API. A mesma configuração funciona em todas; só muda o ficheiro:
.cursor/mcp.json na raiz do projeto~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json no Windows)settings.json, em "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 ligar-se da mesma forma. Descobre as ferramentas através de tools/list.
É assim que o Claude, o ChatGPT, o Claude Code e o Codex se ligam: inicia sessão com a sua conta Jumpseller e a ferramenta de IA recebe um token próprio. O início de sessão no servidor MCP destina-se a assistentes de IA; aplicações e integrações de terceiros usam a API REST com OAuth 2.
A ligação atua como a pessoa que iniciou sessão, por isso 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 encomendasread_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 aplica-se de imediato às suas ligações, e remover a conta da loja desliga-as. Para desligar uma ferramenta de IA por si, aceda a Conta → Preferências, clique no seu nome de utilizador e use Revoke em Connected Apps.
Só as contas que pertencem à loja a podem ligar. Se o Claude ou o ChatGPT lhe pedir para iniciar sessão na Jumpseller outra vez, inicie sessão mais uma vez: é assim que as ligações antigas passam para a sua própria conta.
Para ferramentas que não conseguem iniciar sessão, como scripts, tarefas de CI, o Cursor ou o 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 privados: quem os tiver pode gerir a sua loja.
Cada ligação pertence a uma só loja. Um token API é emitido por uma única loja, e um início de sessão é concedido à loja que escolheu quando o aprovou. A loja não pode ser trocada a partir de dentro de uma conversa.
Por isso, se gere mais do que uma loja Jumpseller, precisa de uma ligação por loja. Como a configura depende da ferramenta.
Além do endereço partilhado, cada loja tem um URL de servidor próprio:
https://mcp.jumpseller.com/s/CODIGO-LOJA
CODIGO-LOJA é o endereço Jumpseller da sua loja, a parte antes de .jumpseller.com. Pode vê-lo na barra de endereços do seu painel de administração, e mantém-se igual mesmo que use um domínio próprio.
Daqui decorrem duas coisas. As ferramentas de IA identificam uma ligação pelo seu URL, por isso dar a cada loja um URL diferente permite manter várias lojas ligadas ao mesmo tempo em vez de alternar entre elas. E uma ligação criada assim fica presa à loja indicada no URL: se alguma vez for autorizada com a conta de outra loja, para e avisa-o, em vez de fazer alterações silenciosamente na loja errada.
Adicione um conector (Claude) ou plugin (ChatGPT) por loja, cada um a apontar para o URL próprio dessa 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 reconheça, como “Jumpseller — Cafetaria”.
Termine a sessão antes de autorizar o segundo. Vá a accounts.jumpseller.com/accounts/sign_out depois de o adicionar e antes de o aprovar. A autorização usa a sessão Jumpseller que já tem aberta, por isso, sem este passo, nunca lhe é perguntado que loja pretende e a segunda loja fica ligada à conta com que já tinha sessão iniciada. Quando isso acontece, a ligação deixa de funcionar e avisa que as credenciais são de outra loja: remova-a, termine a sessão e adicione-a de novo.
Se apontar ambos para o endereço partilhado https://mcp.jumpseller.com em vez do URL por loja, o claude.ai recusa o segundo com a mensagem “A server with this URL already exists”: identifica um conector pelo seu URL, por isso os dois precisam de endereços diferentes.
O GPT da Jumpseller liga-se a uma loja de cada vez e o seu endereço não pode ser alterado. Para mudar de loja, termine a sessão no link acima, abra o GPT de novo e inicie sessão com a loja que pretende.
Adicione um servidor por loja, cada um com o seu nome e URL, e inicie sessão em cada um uma vez:
claude mcp add --transport http jumpseller-cafetaria https://mcp.jumpseller.com/s/cafetaria
claude mcp add --transport http jumpseller-livraria https://mcp.jumpseller.com/s/livraria
Ambas as lojas ficam disponíveis ao mesmo tempo, e indica ao agente a qual se refere: “Na cafetaria, marca a encomenda 1042 como paga.”
Gere um token API no painel de cada loja e declare um servidor por loja:
{
"mcpServers": {
"jumpseller-cafetaria": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://mcp.jumpseller.com/",
"--header", "X-LOGIN-KEY:LOGIN_KEY_CAFETARIA",
"--header", "X-AUTH-TOKEN:AUTH_TOKEN_CAFETARIA"
]
},
"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 elimine 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 | Eliminar um produto | escrita |
Consulte encomendas, pesquise por cliente ou produto, atualize o estado e adicione informação de rastreio.
| Ferramenta | O que faz | Acesso |
|---|---|---|
list_orders | Listar encomendas com paginação e filtro de estado | leitura |
get_order | Obter detalhes completos da encomenda com produtos e cliente | leitura |
search_orders | Pesquisar por ID, nome do cliente, email ou produto | leitura |
update_order | Alterar estado ou adicionar informação de rastreio | escrita |
Pesquise clientes por nome ou email, consulte contactos e moradas.
| Ferramenta | O que faz | Acesso |
|---|---|---|
list_customers | Listar clientes com paginação | leitura |
get_customer | Obter detalhes do cliente com moradas | leitura |
search_customers | Pesquisar por nome ou email | 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 | Eliminar uma categoria | escrita |
Crie e gerencie páginas da loja como Sobre Nós, Contacto 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 | Eliminar uma página | escrita |
list_page_categories | Listar as categorias a que 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 email da loja | leitura |
| Ferramenta | O que faz | Acesso |
|---|---|---|
prepare_upload | Obter uma ligação de upload direto para imagens demasiado grandes para enviar na mensagem | escrita |
As imagens pequenas podem ser enviadas diretamente ao agente. As maiores (acima de cerca de 7 MB) precisam do prepare_upload, que devolve uma ligação temporária para enviar o ficheiro diretamente para o armazenamento. O agente trata disto por si.
Para o que as ferramentas acima não conseguem fazer, o agente pode procurar como fazê-lo 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 todas as encomendas pendentes desta semana. Marca as de Portugal como pagas e adiciona o rastreio PT123456 dos CTT.”
O agente pesquisa encomendas, filtra por país e atualiza cada uma 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 reatribui-os.
“Quantos produtos tenho? Quantos estão sem stock?”
O agente lista os produtos, conta-os e identifica quais têm stock zero.
O servidor MCP permite 100 pedidos por minuto por conta. Isto é mais do que suficiente para sessões interativas com IA. Se exceder este limite, receberá uma resposta 429 Too Many Requests.
Comece o seu período experimental gratuito de 7 dias. Sem necessidade de cartão de crédito.