Pular para o conteúdo principal
Centro de Apoio

MCP para Loja

Cada loja Jumpseller disponibiliza agora um endpoint MCP público que os agentes de IA podem usar 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 gerenciar 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.

Por que isso é 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 essa 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 endpoint 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 endpoint MCP automaticamente através de dois arquivos 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:

Ferramenta O que faz
get_store_info Obter nome, URL, país, moeda, descrição e logotipo da loja
list_products Explorar produtos com paginação. Filtrar por permalink de categoria
get_product Obter detalhes completos do produto por permalink: preço, imagens, variantes, links de compra
search_products Pesquisa de texto completo no nome, descrição e SKU do produto
list_categories Obter a árvore completa de categorias com nomes e permalinks
get_category Obter detalhes da categoria por permalink: descrição, imagens, campos SEO

Que Dados São Retornados?

Produtos incluem: nome, descrição (texto simples), preço, preço de comparação, marca, SKU, disponibilidade de estoque, 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 logotipo.

Apenas produtos disponíveis são retornados. Produtos desativados ou ocultos por falta de estoque 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 endpoint 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 Uso

O MCP para Loja tem dois limites para garantir um uso justo:

  • 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, você receberá uma resposta de erro. Aguarde um minuto e tente novamente.

Conectar um Agente de IA

Qualquer cliente compatível com MCP pode se conectar 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

  MCP Loja MCP Admin
URL a-sua-loja.com/api/mcp mcp.jumpseller.com
Autenticação Nenhuma (público) Token API ou OAuth 2.0
Acesso Apenas leitura Leitura e escrita
Dados Apenas catálogo público Gestão completa da loja
Uso Compras com IA, chatbots, descoberta de produtos Administração, automatização

Em Breve

Estamos trabalhando 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é ao pedido concluído.

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 pedidos
  • Custos ou margens de produtos
  • Configurações internas ou tokens de API
  • Endereços de e-mail

Artigos Relacionados

Nesta página

Comece a sua jornada com a gente!

Comece seu teste grátis de 7 dias. Sem necessidade de cartão de crédito.

Criar Loja