MCP para Loja

Cada loja Jumpseller disponibiliza agora um ponto MCP público que os agentes de IA podem utilizar para explorar o seu catálogo, pesquisar produtos e gerar links de compra diretos — tudo sem autenticação.

Este é o complemento para a loja do Servidor MCP Admin. Enquanto o MCP Admin requer autenticação e permite gerir a sua loja, o MCP para Loja é de acesso público e oferece acesso apenas de leitura à mesma informação que um visitante vê no seu site.

Porque é que Isto é Importante?

Os agentes de IA são cada vez mais a forma como as pessoas descobrem e compram produtos. Com o MCP para Loja, a sua loja está preparada para esta mudança:

• Assistentes de compras com IA podem pesquisar os seus produtos, comparar preços e enviar aos clientes um link de compra direto
• Chatbots no seu site ou em plataformas externas podem responder a perguntas sobre produtos com dados em tempo real
• Recomendações de produtos com IA podem obter o seu catálogo real em vez de depender de feeds desatualizados
• Motores de busca e agregadores de IA podem descobrir o seu ponto MCP através de llms.txt e .well-known/mcp.json

Ponto de Acesso

O MCP para Loja está disponível em cada loja em:

POST https://a-sua-loja.com/api/mcp

Substitua a-sua-loja.com pelo domínio real da sua loja (domínio personalizado ou asualoja.jumpseller.com).

Transporte: Streamable HTTP (JSON-RPC 2.0 sobre POST). Sem estado — cada pedido é independente.

Autenticação: Não é necessária. É um ponto de acesso público.

Descoberta

Os agentes de IA e rastreadores podem descobrir o ponto MCP automaticamente através de dois ficheiros padrão:

• /api/mcp/llms.txt — Descrição legível do servidor MCP e das suas ferramentas
• /api/mcp/.well-known/mcp.json — Metadados de descoberta MCP legíveis por máquina

Ferramentas Disponíveis

O MCP para Loja disponibiliza 6 ferramentas apenas de leitura:

Que Dados São Devolvidos?

Produtos incluem: nome, descrição (texto simples), preço, preço de comparação, marca, SKU, disponibilidade de stock, imagens, variantes com preços por variante e links de compra, categorias, permalink e URLs diretos para adicionar ao carrinho e comprar agora.

Categorias incluem: nome, descrição, permalink, URL, imagens, título da página e meta descrição.

Informação da loja inclui: nome, descrição, país, moeda, URL e logótipo.

Apenas produtos disponíveis são devolvidos. Produtos desativados ou ocultos por falta de stock nunca são expostos. Dados sensíveis do comerciante (custos, margens, configurações internas) nunca são incluídos.

Exemplo: Pesquisar Produtos

Envie um pedido JSON-RPC para o ponto MCP da sua loja:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "search_products",
    "arguments": {
      "query": "vestido verão",
      "limit": 5
    }
  },
  "id": 1
}

A resposta inclui produtos correspondentes com nomes, preços, imagens e links de compra diretos.

Exemplo: Obter um Produto

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_product",
    "arguments": {
      "permalink": "vestido-verao-azul"
    }
  },
  "id": 1
}

Limites de Utilização

O MCP para Loja tem dois limites para garantir uma utilização justa:

• 50 pedidos por minuto por endereço IP (em todas as ferramentas)
• 10 pesquisas por minuto por loja (apenas para search_products)

Se exceder estes limites, receberá uma resposta de erro. Aguarde um minuto e tente novamente.

Ligar um Agente de IA

Qualquer cliente compatível com MCP pode ligar-se ao MCP da sua loja. Aqui está um exemplo de configuração:

{
  "mcpServers": {
    "a-minha-loja": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://a-sua-loja.com/api/mcp"
      ]
    }
  }
}

Não são necessários cabeçalhos de autenticação — basta apontar o cliente para o endpoint /api/mcp da sua loja.

MCP Loja vs MCP Admin

Em Breve

Estamos a trabalhar na expansão do MCP para Loja com ferramentas de checkout e pagamento, para que os agentes de IA possam guiar os clientes ao longo de todo o fluxo de compra — desde a descoberta do produto até à encomenda concluída.

Privacidade e Segurança

O MCP para Loja apenas expõe dados que já são visíveis publicamente no site da sua loja:

• Nomes, descrições, preços e imagens de produtos
• Nomes e descrições de categorias
• Nome, país e moeda da loja

Não expõe:

• Dados de clientes
• Informação de encomendas
• Custos ou margens de produtos
• Configurações internas ou tokens de API
• Endereços de email