Saltar para o conteúdo principal
Centro de Suporte

Gerencie a sua Loja Online com IA

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.

Plataformas Compatíveis

A Jumpseller funciona com todas as principais plataformas de IA:

O Que a IA Pode Fazer Pela Sua Loja?

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 que é o MCP?

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.

E-commerce Agêntico

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:

  • Monitorizam o inventário e fazem reposição automática quando o stock está baixo
  • Processam encomendas e atualizam informação de rastreio sem intervenção manual
  • Geram descrições de produtos e organizam categorias com base no catálogo
  • Respondem a questões de clientes consultando estados de encomendas e dados de conta
  • Executam tarefas agendadas como ajustes de preços, alterações sazonais ou campanhas promocionais

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.

Ligue a Sua 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

Claude

Os conectores que adicionar no claude.ai ficam também disponíveis nas apps de secretária e móvel do Claude.

  1. Abra o conector Jumpseller Store no diretório do Claude e clique em Connect to Claude.

    O conector Jumpseller Store no diretório do Claude
  2. Abre-se uma página da Jumpseller: inicie sessão, escolha a sua loja e clique em Authorize.

  3. 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.

    O conector Jumpseller ligado e as permissões das suas ferramentas

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

O Claude a listar as categorias da loja com o conector Jumpseller

Nos planos Team e Enterprise, pode ser necessário que um owner da organização no Claude adicione primeiro o conector.

Adicionar como conector personalizado

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).

  1. Abra Customize → Connectors, clique em Add e escolha Add custom connector.

    O menu Add nas definições de conectores do Claude
  2. Introduza um Name, por exemplo Jumpseller, e o URL https://mcp.jumpseller.com. Clique em Continue.

    Nome e URL do servidor na janela Add custom connector do Claude
  3. 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.

    Sign in now e Use Claude's published identity selecionados
  4. Clique em Connect. Abre-se uma página da Jumpseller: inicie sessão, escolha a sua loja e clique em Authorize.

ChatGPT

  1. 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.

    O menu Add na página Plugins do ChatGPT
  2. 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.

    Nome, URL do servidor e OAuth na janela Add custom MCP server do ChatGPT
  3. Clique em Continue to …. Abre-se uma página da Jumpseller: inicie sessão, escolha a sua loja e clique em Authorize.

    O ChatGPT a pedir para ligar o plugin
  4. Numa conversa, clique em +, escolha o plugin e faça a sua pergunta.

    O plugin Jumpseller no menu + de uma conversa do ChatGPT O ChatGPT a listar as categorias da loja com o plugin Jumpseller

Também pode usar o GPT da Jumpseller, que inicia sessão da mesma forma.

Claude Code

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.

OpenAI Codex

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.

Gemini CLI

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.

Grok

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.

Meta Muse

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.

Cursor, Devin Desktop, GitHub Copilot e outras ferramentas

Estas ferramentas ligam-se com um token API. A mesma configuração funciona em todas; só muda o ficheiro:

  • Cursor: .cursor/mcp.json na raiz do projeto
  • Devin Desktop (antigo Windsurf): ~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json no Windows)
  • GitHub Copilot (VS Code): o seu 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.

Autenticação

Iniciar sessão com a Jumpseller (OAuth)

É 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:

  • Os âmbitos pedidos pela ferramenta de IA:
    • read_products, write_products para gestão de produtos
    • read_orders, write_orders para gestão de encomendas
    • read_customers para acesso a clientes
    • read_categories, write_categories para gestão de categorias
    • read_pages, write_pages para gestão de páginas
    • read_store para informação da loja
  • As permissões da conta dessa pessoa na loja, definidas em Contas. Uma conta que só pode ver encomendas recebe uma ligação que só pode ler encomendas.

Alterar 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.

Token API

Para ferramentas que não conseguem iniciar sessão, como scripts, tarefas de CI, o Cursor ou o Devin Desktop.

  1. No painel de Administração Jumpseller, aceda a Conta → Preferências e clique no seu nome de utilizador
  2. Desça até à secção API e MCP
  3. Copie a Login Key e o Auth Token
  4. Envie-os como headers HTTP em cada pedido:
    • X-LOGIN-KEY
    • X-AUTH-TOKEN

Os 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.

Gerir Várias Lojas

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.

Dê a cada loja o seu próprio URL

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.

No Claude e no ChatGPT

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.

Claude Code e Codex

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.”

Cursor, Devin Desktop e outras ferramentas com tokens API

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 Que Pode Fazer

O servidor MCP disponibiliza 27 ferramentas organizadas por área:

Produtos (6 ferramentas)

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

Encomendas (4 ferramentas)

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

Clientes (3 ferramentas)

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

Categorias (3 ferramentas)

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

Páginas (6 ferramentas)

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

Loja (1 ferramenta)

Ferramenta O que faz Acesso
get_store_info Obter nome, URL, país, moeda e email da loja leitura

Imagens (1 ferramenta)

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.

Ajuda e Navegação (3 ferramentas)

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

Exemplos Reais

Adicionar produtos mais rápido

“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.

Processar encomendas eficientemente

“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.

Informações rápidas do negócio

“Quantos produtos tenho? Quantos estão sem stock?”

O agente lista os produtos, conta-os e identifica quais têm stock zero.

Limites

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 a vender connosco!

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