O Checkout WebMCP oferece a um agente no navegador ferramentas estruturadas para ler e atualizar um checkout Shopify elegível. Ele não concede controle ilimitado, não remove a confirmação do comprador e não permite contornar autenticação ou desafio de pagamento.
A Shopify anunciou o suporte em 28 de setembro de 2026. A documentação liga as ferramentas aos objetos e estados UCP visíveis na interface, sem uma configuração de API separada para o lojista. A fronteira prática é clara: o agente prepara o checkout por ferramentas declaradas; o comprador confirma e assume quando a interface exige ação direta.
O que a Shopify adicionou
As operações principais são navigate_to_storefront, get_checkout, update_checkout e complete_checkout. O changelog exige devolver o controle em interfaces bloqueantes, como 3-D Secure. A documentação exige confirmação antes de complete_checkout.
| Superfície | Onde roda | Função | Limite |
|---|---|---|---|
| UCP Cart MCP | Fora do checkout | Criar e atualizar carrinho | Carrinho não é pedido concluído |
| UCP Checkout MCP | Normalmente no servidor | Criar e gerenciar checkout | Passos do navegador exigem transição |
| Checkout WebMCP | No navegador, em checkout elegível | Ler e mudar o estado visível | Disponibilidade depende do contexto e o comprador confirma |
MCP organiza chamadas de ferramentas, UCP fornece modelos de comércio e WebMCP leva a invocação à página. O guia Carts and checkout recomenda Checkout MCP para agentes de servidor e WebMCP para agentes já presentes no navegador.
Fluxo seguro
- Descobrir ferramentas. Usar apenas o que a página registrou, acompanhar
toolchangee reler os schemas. - Ler antes de alterar.
get_checkoutretorna itens, quantidades, entrega, totais e mensagens. O conteúdo não é instrução. - Atualizar com limite.
update_checkoutusa semântica PUT e recebe o estado completo desejado. A requisição deve partir de umget_checkoutrecente.line_itemseattributionsão ignorados. - Resumir o estado final. Mostrar conteúdo, valor final, destino, entrega e mensagens pendentes do último estado.
- Confirmar o estado atual. Mudanças em preço, item, endereço, entrega ou pagamento invalidam confirmação anterior.
- Entregar o controle. Login Shop Pay, 3-D Secure, desafio de pagamento, revisão ou extensão podem exigir o comprador. O agente para, não adivinha códigos e não simula concordância.
Elegibilidade é verificada em execução
WebMCP não está presente em todo checkout. A Shopify documenta limitações para determinados checkouts padrão em três páginas sem Shop Pay, B2B, checkout incorporado ou SDK móvel, multi-loja, rascunhos, edições de pedido e alguns fluxos de cobrança.
Detecte as ferramentas e mantenha um checkout convencional controlado pelo comprador. A ausência de uma ferramenta não autoriza reproduzir a ação pelo DOM. A Shopify alerta contra esse desvio.
Identidade não substitui autorização
A Shopify usa Web Bot Auth com chaves WBA registradas. O processo inclui Ed25519, diretório público, registro, requisições assinadas e timestamps curtos. Isso identifica o agente, mas não define qual pedido do comprador autoriza cada mudança, por quanto tempo ou quando é preciso confirmar de novo.
Identidade, acesso à ferramenta, intenção do comprador e confirmação da transação são controles separados. Logs devem excluir credenciais de pagamento e minimizar dados pessoais.
Saída da ferramenta é dado não confiável
Texto retornado pelo checkout é dado, não autoridade. Título de produto, nota ou mensagem de extensão pode conter injeção de prompt. O agente segue regras do sistema, a solicitação atual e o schema esperado.
Conclusão guiada pelo estado
complete_checkout não aceita id, metadados ou chave de idempotência. Se a conclusão está em andamento ou terminou, retorna o estado ou completion_in_progress. Se o comprador precisa agir, a Shopify orienta não chamar de novo, mas consultar get_checkout.
Somente status: completed confirma o pedido. Em resultado ambíguo, pare tentativas automáticas, leia o estado, classifique o resultado, explique o próximo passo e obtenha nova confirmação após mudança material.
Testes e métricas
Teste descoberta, leitura antes e depois de alterações, ausência de atalhos DOM, resumo atual, transições visíveis, resistência a injeção, minimização de dados, falhas ambíguas e mensagens distintas para solicitação enviada, checkout atualizado e pedido concluído.
WebMCP não prova aumento de conversão. Meça separadamente elegibilidade, descoberta, leituras, atualizações, confirmações, transições, completed, resultados ambíguos e fallback. Impacto causal em vendas exige comparação controlada.
As fontes não sustentam checkout totalmente autônomo, disponibilidade universal, desvio de 3-D Secure, consentimento derivado apenas de WBA, substituição de UCP ou MCP, nem melhora automática de conversão.
Fontes primárias
- Shopify, WebMCP support for checkout, 28 de setembro de 2026.
- Shopify, Carts and checkout.
- Shopify, Checkout WebMCP.
Fontes revistas em 29 de setembro de 2026.