Comércio Agêntico

Todas as lojas Jumpseller podem ser utilizadas por agentes de IA, sem nada para instalar. Esta página é o mapa: para que serve cada superfície, qual escolher, e o que já está ligado.

Se está construindo um assistente de IA que trabalha sobre a Jumpseller — escrevendo temas, chamando a API — o que procura é o AI Toolkit. Esta página é sobre agentes que compram numa loja.

Que superfície preciso?

Quero…	Usar
Deixar o navegador com IA de um cliente agir na página onde está	WebMCP
Ler o catálogo de uma loja a partir do meu próprio agente ou app	MCP para Loja
Integrar através da norma aberta de comércio agêntico	Universal Commerce Protocol, abaixo
Gerir uma loja: produtos, pedidos, clientes	MCP de Administração

As três primeiras são públicas e não precisam de credenciais. A quarta autentica-se como você.

1. Descoberta

Antes de poder comprar na sua loja, é preciso descobrir o que a loja oferece.

• /llms.txt e /agents.md — uma descrição em texto simples da loja e dos endpoints que um agente pode usar. Gerada a partir das ferramentas efetivamente registadas, por isso nunca descreve uma que já não existe.
• /.well-known/mcp.json — metadados de descoberta MCP.
• /.well-known/ucp — o perfil Universal Commerce Protocol da loja: que capacidades suporta, em que versões, e os endpoints que as servem.

Os quatro são públicos e servidos por todas as lojas.

2. Navegar e pesquisar

MCP para Loja — POST https://sua-loja.com/api/mcp

Um servidor MCP público e apenas de leitura em cada loja. Seis ferramentas para informação da loja, produtos, pesquisa e categorias. Sem autenticação. Use-o quando o seu agente não corre dentro do navegador do cliente: um chatbot, um assistente de compras, um comparador.

Catálogo e Carrinho UCP — POST https://sua-loja.com/api/ucp/mcp

O mesmo catálogo através do Universal Commerce Protocol: search_catalog, lookup_catalog e get_product para a capacidade Catalog, e create_cart, get_cart, update_cart e cancel_cart para a de Cart — todas nos tipos do próprio UCP. Use-o se já fala UCP e quer uma integração que funcione em várias plataformas.

Ambos leem o mesmo catálogo. São endpoints separados porque as ferramentas significam coisas diferentes — o get_product do UCP recebe um id e um envelope meta obrigatório, enquanto o do MCP para Loja recebe um permalink.

3. Comprar na própria página

WebMCP — sem endpoint; a loja regista as ferramentas no navegador.

Quando um cliente abre a loja num navegador com IA, a página entrega ao assistente onze ferramentas: pesquisar o catálogo, navegar categorias, mostrar uma variante, preencher o carrinho, aplicar um cupom, abrir o checkout. Correm na sessão do próprio cliente, por isso o assistente trabalha no carrinho que a pessoa está a ver.

É esta que muda a conversão, porque é a que corre enquanto alguém está mesmo a comprar.

4. Finalizar a compra

Quem finaliza é o cliente. Nenhuma ferramenta em qualquer destas superfícies pode criar um pedido ou introduzir dados de pagamento, e dentro do checkout não é disponibilizada nenhuma. A um agente que construiu um carrinho UCP é devolvido um continue_url para a pessoa finalizar; um agente na página abre o checkout e afasta-se. De qualquer forma, o trabalho de um agente acaba ao entregar a página de checkout à pessoa.

5. Gerir a loja

MCP de Administração — https://mcp.jumpseller.com

Leitura e escrita de produtos, pedidos, clientes, categorias e páginas, autenticado com um token de API ou OAuth 2.0. Este é o agente do comerciante, não o de um cliente.

O que está ligado por omissão

Superfície	Ligado por omissão	Autenticação
llms.txt, .well-known/mcp.json, .well-known/ucp	Sim	Nenhuma
WebMCP	Sim, em todas as lojas e temas	Nenhuma — a sessão do cliente
MCP para Loja	Sim	Nenhuma
Catálogo e Carrinho UCP	Sim	Nenhuma
MCP de Administração	Precisa de credenciais	Token de API ou OAuth 2.0

O que ainda não construímos

Dito de forma direta, porque é mais útil do que um roadmap:

• Checkout do UCP, em que o próprio agente conclui a compra. É uma decisão separada sobre quem recebe o dinheiro, e ainda não foi tomada. O Cart já está feito: um agente pode encher um carrinho e devolver ao cliente um link para finalizar.
• Seguimento de pedidos para agentes de clientes. O MCP de Administração cobre pedidos para comerciantes; ainda não há equivalente para o assistente de um cliente.
• Uma ferramenta de políticas e FAQ, para um assistente responder “qual é a política de devoluções” sem ler a página.

Para onde ir a seguir

• WebMCP — as ferramentas na página e como testá-las
• MCP para Loja — o endpoint público e as suas seis ferramentas
• MCP de Administração — gerir uma loja a partir de um agente
• AI Toolkit — construir sobre a Jumpseller com um assistente de IA