Servidor MCP para Comerciantes

O servidor MCP da Jumpseller permite gerir a sua loja usando assistentes de IA. Em vez de navegar por menus e preencher formulários, basta dizer ao agente de IA o que precisa em linguagem natural e ele trata de tudo.

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

O agente trata de tudo: cria o produto, configura as variantes, faz upload da imagem e atribui a categoria, tudo a partir de uma única frase.

Porquê Usar IA para Gerir a Sua Loja?

Poupe tempo em tarefas repetitivas. Adicionar produtos, atualizar preços, verificar estados de encomendas: 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 deixe o agente tratar disso.

Obtenha respostas instantâneas sobre o seu negócio. Pergunte “quantas encomendas pendentes tenho?” ou “encontra o cliente que fez uma encomenda na semana passada” sem navegar por vários ecrãs.

Funciona com as ferramentas que já usa. Conecte ao Claude, Cursor, Windsurf, GitHub Copilot e qualquer ferramenta de IA compatível com o Model Context Protocol (MCP).

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.

Ligação ao Servidor MCP

URL do servidor: https://mcp.jumpseller.com

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. Aceda ao painel de Administração → Configurações → API
2. Copie a Login Key e o Auth Token
3. 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 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).

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.

O Que Pode Fazer

O servidor MCP disponibiliza 20 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 (3 ferramentas)

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

Loja (1 ferramenta)

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.