Nesta página
Universal Commerce Protocol (UCP) é um protocolo aberto e versionado para comércio por agentes. A implementação atual Shopify expõe servidores MCP compatíveis com UCP para busca de catálogo, carrinhos, checkout e fluxos de pedidos. UCP está disponível para desenvolvedores hoje, mas um protocolo aberto não significa que todo agente ou lojista permite todos os recursos.
A visão geral: o que mudou?
UCP foi anunciado por Shopify e Google em 11 de janeiro de 2026. O protocolo continua evoluindo; a documentação atual de agentes Shopify usa exemplos de perfil 2026-08-25. Em 13 de outubro de 2026, Shopify também anunciou Shop MCP, que permite a agentes compatíveis pesquisar Shopify Catalog, montar carrinhos e criar checkout por uma única conexão MCP.
Para desenvolvedores Shopify, a questão prática é qual fluxo atual de agentes precisa ser atendido: descoberta de produtos, montagem de carrinho, encaminhamento ao checkout ou acompanhamento de pedidos. Confira as ferramentas e permissões compatíveis na documentação antes de prometer um recurso aos lojistas.
O que exatamente é UCP?
UCP é um protocolo aberto que descreve como aplicações de agentes e sistemas de comércio podem trocar informações e realizar ações definidas de comércio. Ele é versionado e baseado em recursos: uma integração declara o que permite, e um agente deve usar apenas esses recursos.
Shopify implementa UCP por endpoints e ferramentas MCP. Conforme endpoint e permissões, desenvolvedores podem trabalhar com descoberta de catálogo, carrinhos, checkout ou informações de pedidos. São fluxos distintos, e permitir um deles não implica permitir todos os outros recursos UCP.
Papéis em um fluxo de comércio por agentes
- Agente ou aplicação: ajuda um comprador a encontrar produtos, montar um carrinho ou continuar no checkout.
- Sistema do lojista: fornece informações de produtos e checkout e processa o pedido pela interface Shopify compatível.
- Provedor de credenciais: fornece credenciais ou tokens de pagamento pelo método negociado para o fluxo.
- Serviço de pagamento: trata o pagamento pelo checkout ou método disponível nesse fluxo.
- Comprador: revisa e autoriza a compra. Siga os requisitos de confirmação e permissão do fluxo.
O problema: por que o comércio precisava de um protocolo
A realidade do comércio hoje é de uma fragmentação enorme.
Considere o que acontece quando um cliente quer comprar por um assistente de IA:
- A IA precisa encontrar informações de produtos em catálogos de lojistas
- Precisa entender disponibilidade, preços e opções de envio em tempo real
- Deve tratar programas de fidelidade, códigos de desconto e preferências de assinaturas
- Precisa coletar informações de pagamento com segurança
- Precisa concluir o checkout com todos os requisitos específicos do lojista
- Por fim, deve permitir acompanhamento de pedidos, devoluções e atendimento
Integrações personalizadas acrescentam manutenção. UCP oferece esquemas compartilhados e negociação de recursos que podem reduzir esse trabalho, mas duas implementações ainda precisam de versões, recursos, autenticação e processadores de pagamento compatíveis. A compatibilidade do protocolo, por si só, não garante que um agente conclua uma compra.
Recursos UCP a entender primeiro
Checkout, vinculação de identidade e estado de pedidos são pontos de partida úteis na especificação UCP. Shopify também documenta recursos de catálogo e carrinho. Cada interface implementa seu conjunto compatível; confira o perfil negociado antes de chamar uma ferramenta.
1. Checkout
Checkout cria e atualiza uma sessão de compra, incluindo itens, dados do comprador, totais e processador de pagamento. O lojista continua sendo o responsável legal pela venda. O fluxo padrão encaminha o comprador a uma interface confiável para confirmar o pagamento; a conclusão autônoma depende das extensões de autorização compatíveis e da integração específica.
2. Vinculação de identidade
A vinculação usa OAuth 2.0 para permitir que um comprador autorize um agente a agir em seu nome. Pode permitir recursos específicos da conta, como endereços salvos ou histórico de pedidos. A busca pública de catálogo pode funcionar sem vincular uma identidade, então autorização é uma decisão separada de recurso e permissão.
3. Pedido
O recurso Order compartilha estado e eventos do ciclo de vida do pedido, como processamento, devoluções e reembolsos. Não é uma API geral de edição. Order MCP e as APIs atuais de edição solicitada pelo comprador Shopify têm seus próprios escopos e limites documentados, descritos abaixo.
A arquitetura técnica: construída para evoluir
UCP usa perfis para declarar uma versão de protocolo e recursos compatíveis. Empresas e agentes negociam os recursos comuns para uma sessão; o agente deve usar apenas esse conjunto negociado. Exemplos Shopify usam perfis versionados por data, então desenvolvedores devem copiar o perfil e o esquema atuais da documentação publicada, em vez de uma amostra antiga.
Extensões acrescentam detalhes opcionais a um recurso básico, como processamento ou descontos. Uma empresa pode expor o fluxo básico de checkout sem todas as extensões, e um agente precisa verificar quais extensões a outra parte permite antes de depender delas. Veja a visão geral UCP e o guia de perfis de agentes Shopify.
Construído para interoperabilidade
UCP foi projetado para funcionar com vinculações de protocolo como REST, MCP e A2A. Isso descreve o padrão UCP mais amplo, não uma promessa de que uma implementação Shopify expõe todos os recursos em todos os meios de transporte.
A documentação atual para desenvolvedores Shopify descreve servidores MCP compatíveis com UCP e suas ferramentas. Para uma integração, verifique endpoint exato, método de autenticação, versão do perfil e confirmação exigida do comprador. Não deduza que um recurso listado na especificação UCP já está disponível em uma interface MCP Shopify específica.
Interfaces UCP e MCP atuais Shopify
A documentação de agentes Shopify descreve várias interfaces distintas:
Descoberta de catálogo
Ferramentas Catalog MCP permitem que um agente pesquise Shopify Catalog e busque detalhes de produtos. Global Catalog MCP usa https://catalog.shopify.com/api/ucp/mcp; Shop MCP está disponível em https://mcp.shop.com e expõe busca de catálogo e ferramentas de produtos. Visibilidade e resultados dependem dos dados atuais e da interface usada.
Montagem de carrinho e checkout
Cart MCP pode montar e atualizar um carrinho. Checkout MCP pode criar e gerenciar uma sessão e encaminhar o comprador à loja virtual para concluir etapas que exigem sua participação. Shopify documenta Checkout MCP como a abordagem recomendada no servidor; Checkout WebMCP é para um agente que já opera no navegador do comprador. Alguns tipos de checkout e interações definidas por apps não são tratados pelas ferramentas do navegador.
Shop MCP é uma conexão separada que pode pesquisar Shopify Catalog, montar carrinhos e criar checkout Shop Pay. Isso não significa que todo lojista fica automaticamente disponível em todo app de IA.
Informações de pedidos
Order MCP lê o estado atual de pedidos feitos pelo agente, incluindo processamento e ajustes pós-compra. Sua ferramenta get_order serve para visualizações solicitadas pelo comprador e conciliação. Webhooks UCP de pedidos fornecem retratos contínuos após alterações confirmadas; um gerente de parceiros Shopify deve registrar o endpoint de entrega. Esse canal de leitura/atualização não executa edições arbitrárias.
Separadamente, as APIs Shopify de edição solicitada pelo comprador de 1º de outubro de 2026 permitem solicitar a remoção de itens de linha não processados; um lojista ou app pode revisar, resolver ou recusar. Esse fluxo restrito não equivale a alterar endereço ou trocar produto.
O que isso significa para lojistas Shopify
Ferramentas de agentes Shopify podem disponibilizar fluxos de produtos e checkout a agentes compatíveis. A experiência depende da interface usada, dos recursos ativados na loja e da autorização do comprador. Mantenha detalhes, disponibilidade e políticas corretos e confirme quais canais estão ativados na loja.
Trate isso como uma interface de integração, não uma garantia de presença universal na IA ou acesso a todos os lojistas. A visão geral dos Agentic Storefronts explica disponibilidade dos canais e o checkout padrão por indicação do ChatGPT.
O que isso significa para desenvolvedores de apps Shopify
UCP e as ferramentas MCP Shopify dão a desenvolvedores interfaces definidas para desenvolver. Antes de começar, identifique a tarefa do comprador, o endpoint Shopify, perfil e escopos necessários e onde o comprador deve revisar ou confirmar uma ação.
Desenvolva com recursos compatíveis
Use documentação e tutoriais atuais de agentes Shopify para descoberta de endpoints, autenticação, ferramentas de carrinho/checkout e acompanhamento de pedidos. Não presuma que um app de terceiros pode expor suas próprias funções a um agente apenas porque UCP permite extensões; verifique se a interface do app e o recurso de protocolo foram implementados.
Mantenha a edição de pedidos separada
Order MCP cobre informações e fluxos do ciclo de vida de pedidos. Não faz edições arbitrárias de endereço ou produto. As APIs de edição solicitada pelo comprador anunciadas em 1º de outubro de 2026 se limitam à remoção de itens de linha não processados, com revisão do lojista ou app. Para outras edições pós-compra pelos clientes, verifique os recursos e permissões atuais do app separado.
O que isso significa para agências
Agências podem ajudar lojistas a preparar dados de produtos e checkout para as interfaces de agentes escolhidas. Comece pela documentação atual Shopify e pelo plano, configuração de apps, dados de produtos e jornada real do lojista. Trate disponibilidade, alcance e conversão como questões a medir para cada lojista, não garantias do protocolo.
UCP junto de outros protocolos de comércio por agentes
UCP e Agentic Commerce Protocol (ACP) são iniciativas separadas. Definem interfaces e fluxos diferentes, então desenvolvedores não devem presumir que uma integração UCP funciona automaticamente com ACP ou vice-versa. Revise especificações atuais e desenvolva apenas para as interfaces de agentes que o produto pretende atender.
A ponte ilustrada representa trabalho de integração a avaliar, e não um recurso de interoperabilidade Shopify já lançado.
Primeiros passos: guia prático de implementação
Use a documentação atual de comércio por agentes Shopify como ponto de partida. Ela inclui interfaces MCP atuais, exemplos de perfis UCP, autenticação e tutoriais. Shopify recomenda o início rápido do AI Toolkit para uma configuração guiada; desenvolvedores também podem seguir tutoriais individuais.
Etapa 1: Identifique a tarefa do comprador
Decida se a aplicação precisa buscar produtos, montar carrinho, criar ou atualizar checkout ou ler informações do ciclo de vida de pedidos. Essas tarefas usam ferramentas e escopos diferentes.
Etapa 2: Siga o guia atual Shopify
Use o perfil de agente e os exemplos atuais de API da documentação Shopify. Não copie endpoint, versão de perfil, repositório de exemplo ou URL de ambiente de testes antigo sem conferir se continua documentado.
Etapa 3: Teste a jornada completa do comprador
Use uma loja de desenvolvimento e teste autenticação, mensagens e status retornados, encaminhamento ao checkout e confirmação exigida. Teste o tipo exato de pedido ou checkout pretendido; Shopify documenta casos que as ferramentas de checkout no navegador não tratam.
Etapa 4: Limite a integração a recursos verificados
Declare e solicite apenas escopos necessários ao fluxo. Deixe claras etapas incompatíveis ou de confirmação pelo comprador e verifique o comportamento atual antes de implantar em produção.
O que vem a seguir
A documentação publicada Shopify atualmente cobre descoberta de catálogo, carrinhos, checkout e informações de pedidos por fluxos MCP separados. Shop MCP adiciona uma conexão para agentes compatíveis pesquisarem Shopify Catalog, montarem carrinhos e criarem checkout Shop Pay. Recursos futuros e datas de implementação devem ser tratados como não anunciados até aparecerem na especificação oficial ou no changelog Shopify.
Antes de assumir um roteiro, confira a documentação atual para perfil, endpoint, escopos e tipos de pedido ou checkout que sua integração usará. Ferramentas disponíveis, requisitos de confirmação e tipos compatíveis diferem por interface e podem mudar com atualizações de APIs Shopify.
Conclusão
UCP dá aos desenvolvedores um protocolo compartilhado e em evolução para criar fluxos de comércio por agentes. As ferramentas atuais Shopify cobrem descoberta de produtos, carrinhos/checkout e informações do ciclo de vida de pedidos, com endpoints, escopos e limites separados para cada um.
Para lojistas, confira interfaces ativadas e a jornada que permitem. Para desenvolvedores e agências, siga a documentação atual, teste em uma loja de desenvolvimento e evite sugerir que uma integração pode editar pedidos ou listar produtos em todas as interfaces de IA, a menos que o destino permita isso.
Perguntas frequentes
UCP torna todo app Shopify acessível por um agente?
Um app precisa de uma interface implementada compatível com o agente e a interface Shopify de destino. Declarar uma extensão ou usar um padrão aberto, por si só, não expõe suas funções.
Order MCP pode alterar um endereço ou trocar um produto?
Order MCP busca o estado de pedidos feitos pelo agente. Alterações de endereço e produto exigem um fluxo separado de edição. A remoção de itens não processados solicitada pelo comprador é uma solicitação distinta de API revisada por lojista ou app.
Como receber atualizações UCP de pedidos na Shopify?
Organize o registro dos webhooks pelo gerente de parceiros Shopify, trate os retratos recebidos e use get_order quando um comprador pedir informações atuais ou uma entrega precisar de conciliação.
O checkout padrão Shopify no ChatGPT é um checkout direto UCP?
O Agentic Storefront padrão Shopify no ChatGPT redireciona o comprador ao checkout da loja virtual do lojista. Outros canais ativados e integrações separadas de agentes podem usar fluxos diferentes; verifique aquele que implementa.
O que verificar antes de implantar uma integração UCP?
Confira endpoint, versão negociada do protocolo, recursos, escopos, autenticação e etapas de confirmação. Teste produtos indisponíveis, encaminhamento ao checkout e atualizações de pedidos com o agente escolhido antes do lançamento.
Recursos
- Anúncio do Shop MCP
- APIs de edição de pedidos solicitada pelo comprador
- Recurso de checkout UCP
- Recurso de vinculação de identidade UCP
- Recurso de pedido UCP
- Repositório da especificação UCP
Este artigo faz parte da série “Além do checkout”. O app de edição de pedidos pelos clientes da Revize oferece edições elegíveis por autoatendimento antes do processamento durante uma janela definida pelo lojista. Trocar por outro produto, adicionar produtos, aplicar descontos e reembolsar em crédito na loja exigem Pro; a edição pela equipe está em desenvolvimento. Esse portal é separado de uma integração de agentes UCP.
Leitura relacionada
Estatísticas de edição de pedidos Shopify · Como vender no ChatGPT com Agentic Storefronts Shopify · Guia de endpoints Shopify MCP e UCP · Guia do Shopify AI Toolkit · Como permitir que clientes editem pedidos Shopify