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:

• Claude (Desktop, Code e claude.ai)
• ChatGPT (via o GPT Jumpseller)
• Cursor
• Windsurf
• GitHub Copilot (VS Code)
• Qualquer ferramenta compatível com o Model Context Protocol (MCP)

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.

Ligação ao Servidor MCP

URL do servidor: https://mcp.jumpseller.com, ou https://mcp.jumpseller.com/s/CODIGO-LOJA para se dirigir a uma loja específica (ver a secção Gerir Várias Lojas mais abaixo).

Transporte: Streamable HTTP (JSON-RPC via POST). O servidor é stateless, cada pedido é independente.

Protocolo: Model Context Protocol (MCP). As ferramentas são auto-descobertas via tools/list.

Qualquer cliente compatível com MCP pode ligar-se enviando pedidos JSON-RPC POST para o URL acima com os headers de autenticação apropriados.

Autenticação

O servidor MCP suporta dois métodos de autenticação conforme o caso de uso.

Token API (recomendado para donos de loja)

Ideal para gerir a sua própria loja diretamente a partir de um agente de IA.

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: a_sua_login_key
   • X-AUTH-TOKEN: o_seu_auth_token

Os tokens API têm acesso total a todas as operações da loja com base nas permissões da sua conta.

OAuth 2.0 (para aplicações de terceiros)

Ideal para apps e integrações que atuam em nome de comerciantes. Consulte o Guia OAuth 2 para mais detalhes.

1. Registe uma aplicação OAuth na Jumpseller
2. Os comerciantes autorizam a app através do fluxo OAuth
3. Envie o token como header HTTP: Authorization: Bearer <token>

Os tokens OAuth têm permissões limitadas:

• 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

Cada token só pode aceder às permissões que tanto a aplicação OAuth como o comerciante aprovaram.

Guias de Configuração

Abaixo estão exemplos de configuração para ferramentas de IA populares. Substitua as credenciais pelas suas (ver Autenticação acima).

Claude.ai (Conector Personalizado)

Pode conectar a sua loja Jumpseller diretamente no claude.ai usando um conector personalizado:

1. Aceda ao claude.ai e abra as Configurações
2. Clique em Connectors e depois em Add custom connector
3. Preencha os campos:
   • Name: Jumpseller
   • URL: https://mcp.jumpseller.com
   • Abra Advanced settings e introduza o OAuth Client ID: riJmQvQMJhqQnSwXlqapm3zDNgyiLwwxPgQdFr_462U
   • Deixe OAuth Client Secret vazio
4. Clique em Add
5. O Claude vai redirecioná-lo para iniciar sessão com a sua conta Jumpseller

Uma vez conectado, pode pedir ao Claude para gerir a sua loja diretamente a partir do claude.ai.

ChatGPT

A Jumpseller também está disponível como GPT no ChatGPT. Visite o Jumpseller GPT e inicie sessão com a sua conta Jumpseller. Pode então gerir a sua loja diretamente a partir do ChatGPT usando linguagem natural.

Claude Desktop / Claude Code

Adicione ao ficheiro claude_desktop_config.json ou .mcp.json:

{
  "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"
      ]
    }
  }
}

Cursor

Adicione ao ficheiro .cursor/mcp.json na raiz do projeto (mesmo JSON acima).

Windsurf

Adicione ao ficheiro ~/.codeium/windsurf/mcp_config.json (mesmo JSON acima).

GitHub Copilot (VS Code)

Adicione ao settings.json do VS Code:

{
  "mcp": {
    "servers": {
      "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"
        ]
      }
    }
  }
}

Outros clientes MCP

Qualquer cliente MCP que suporte transporte Streamable HTTP pode ligar-se. Aponte-o para https://mcp.jumpseller.com/ e configure os headers de autenticação para o método escolhido (Token API ou OAuth 2.0). O cliente irá auto-descobrir todas as ferramentas disponíveis através do método tools/list.

Gerir Várias Lojas

Cada ligação pertence a uma só loja, e são as credenciais que determinam qual. Um token API é emitido por uma única loja, e uma autorização OAuth é concedida à loja com que tinha sessão iniciada no momento em que a 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.

Claude Desktop, Claude Code, Cursor e Windsurf

Estas leem um ficheiro de configuração, por isso pode declarar um servidor por loja e usar ambas na mesma conversa. Gere um token API no painel de cada loja (Conta → Preferências → o seu nome de utilizador → API e MCP) e dê a cada entrada um nome que reconheça:

{
  "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"
      ]
    }
  }
}

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

No claude.ai

Adicione um conector personalizado por loja, cada um a apontar para o URL próprio dessa loja. Siga os passos de configuração do Claude.ai indicados acima, mas no campo URL use https://mcp.jumpseller.com/s/CODIGO-LOJA em vez do endereço partilhado, e dê a cada conector 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 adicionar o conector e antes de o aprovar. A autorização usa a sessão Jumpseller que já tem aberta, por isso, sem este passo, o Claude nunca pergunta que loja pretende e liga a segunda loja à conta com que já tinha sessão iniciada. Quando isso acontece, o conector deixa de funcionar e avisa que as credenciais são de outra loja: remova-o, termine a sessão e adicione-o de novo.

Depois, na página de início de sessão, introduza o endereço da loja que pretende no campo Store Address.

Se apontar ambos os conectores 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.

No ChatGPT

O GPT da Jumpseller liga-se a uma loja de cada vez e o seu endereço não pode ser alterado, por isso mudar de loja implica terminar a sessão e ligar de novo:

1. Termine a sessão da sua conta Jumpseller em accounts.jumpseller.com/accounts/sign_out.
2. Abra o GPT da Jumpseller e inicie sessão de novo com o endereço da loja que pretende.

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.

Encomendas (4 ferramentas)

Consulte encomendas, pesquise por cliente ou produto, atualize o estado e adicione informação de rastreio.

Clientes (3 ferramentas)

Pesquise clientes por nome ou email, consulte contactos e moradas.

Categorias (3 ferramentas)

Gerencie as categorias de produtos e organize o catálogo.

Páginas (6 ferramentas)

Crie e gerencie páginas da loja como Sobre Nós, Contacto e Políticas.

Loja (1 ferramenta)

Imagens (1 ferramenta)

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.

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.

Organizar o catálogo

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