VivaPop

Para agentes de IA e desenvolvedores

Peça pipoca pelo seu assistente de IA.

A VivaPop tem um servidor MCP público e um contrato OpenAPI. O seu assistente de IA busca o catálogo oficial, calcula frete com o seu CEP e diz o preço com os números do servidor — isso não pede chave, nem cadastro, nem taxa de integração. Ele também pode abrir o seu pedido e te entregar a página de pagamento; para isso precisa de um token dado pelo lojista. Nos dois casos, quem paga é você.

https://www.vivapop.com.br/loja/api/mcp

Nenhuma tool afirma pagamento. Isso é deliberado. O agente pode abrir o pedido e te entregar a página de pagamento hospedada da Stripe — e é você quem escolhe Pix, cartão ou boleto e digita os seus dados lá: nem a loja, nem o agente veem o seu cartão. Até esse pagamento confirmar, o pedido está em aguardando pagamento, e nenhuma resposta desta API deve ser lida como "compra concluída". A própria ferramenta repete esse aviso — não o resuma para fora.

Cole isto no seu agente

Funciona em qualquer cliente que fale MCP. Se o seu não fala, o contrato OpenAPI abaixo resolve: é REST comum. 

Adicione o servidor MCP remoto https://www.vivapop.com.br/loja/api/mcp

Depois diga, com as suas palavras:

Quero comprar pipoca da VivaPop. Use o servidor MCP da loja: liste as
categorias, me mostre as opções com o preço do servidor, calcule o frete para o
meu CEP e me diga o total. Depois abra o pedido e me entregue o link de
pagamento — não invente valor, não resuma o aviso, e não diga que está pago
antes de consultar o estado do pedido.

Configuração por plataforma

A URL é a mesma nas quatro. Ler não tem chave nenhuma. O token que abre pedido é dado pelo lojista, um por agente, com escopo e validade — e você só deve colocá-lo no conector do seu próprio assistente.

  1. Em Settings → Connectors, escolha Add custom connector.
  2. Cole https://www.vivapop.com.br/loja/api/mcp.
  3. Pronto: as oito tools aparecem. Ler catálogo e calcular frete não pedem nada.
  4. Para o agente abrir pedido, peça ao lojista um token com o escopo criacao:pedido e cole-o no campo de cabeçalho do connector (Authorization: Bearer …). Sem ele, a ferramenta de compra é recusada e continua funcionando o caminho do link.

Quero comprar pelo meu assistente. Como funciona?

Quatro passos. Você não precisa instalar nada, e não precisa de token para nada disso — o token é do agente que o lojista autoriza.

  1. 1. Adicione a loja ao assistente

    No ChatGPT, Claude, Gemini ou Grok, adicione um servidor MCP remoto com a URL https://www.vivapop.com.br/loja/api/mcp. É uma vez só. Se o seu assistente não fala MCP, o contrato /openapi.json é REST comum.

  2. 2. Peça a compra com as suas palavras

    Escreva o que você quer, por exemplo: "pipoca de caramelo, 2 pacotes, meu CEP é 01310-100". O assistente consulta o catálogo e o frete no servidor da loja — o preço que ele te diz é o preço que a VivaPop cobra, não um chute dele. Se ele calcular valor por conta própria, desconfie e peça para conferir com a ferramenta.

    Mudou o CEP, mudou o frete. O valor da entrega é do endereço, e a resposta da loja diz para qual CEP ela calculou. Se você trocar o endereço no meio da conversa ("melhor mandar para o trabalho"), peça a conta de novo antes de fechar — e se o número que ele pagar for diferente do que foi mostrado, a própria loja recusa o pedido e devolve as opções do CEP novo.

  3. 3. Receba o link e pague você mesmo

    Vêm duas coisas: um número de pedido (VP-2026-000001) e uma página de pagamento hospedada pela Stripe. Abra o link, escolha Pix, cartão ou boleto e digite os seus dados. Nem a loja nem o assistente veem o seu cartão — quem recebe o número é a Stripe. Guarde o código do pedido.

  4. 4. Confira o estado quando quiser

    Depois de pagar, a loja mostra uma faixa na vitrine para confirmar o pedido com o seu CEP. Você também pode rastrear sem o assistente, em Rastrear pedido no menu, ou pedir a ele que consulte o estado. O CEP é pedido de propósito: o número do pedido é sequencial e sozinho não prova que é seu.

Três coisas que não acontecem. O assistente não paga nada por você. Ele não vê o seu cartão. E nenhum pedido é dado como pago sem a loja perguntar à Stripe — se ele disser "compra concluída" sem ter consultado o estado do pedido, não é verdade. Enquanto o pagamento não confirma, a situação é aguardando pagamento, e a caixa não é postada.

Preferir fazer você mesmo também está ótimo: o link que o agente entrega abre a loja normal, com a sacola já montada, e o checkout é o de sempre.

O que o agente consegue fazer

Esta lista é buscada ao vivo no servidor, não está escrita na página. Se mudar lá, muda aqui — uma lista fixa desatualiza e passa a prometer tool que não existe.

Carregando as tools do servidor…

    Demonstração viva

    Não é captura de tela nem resposta gravada: os botões abaixo chamam o servidor MCP de verdade, agora, e mostram o que ele devolveu.

    O link que o agente entrega

    A tool criar_link_de_pedido devolve um deep link que abre a loja com a sacola já montada. A pessoa confere, calcula o frete com o CEP dela e paga. Exemplo real, clicável:

    Abrir esta sacola no site

    O formato é /loja/?sacola=SKU:QTD,SKU:QTD, com dois-pontos e vírgula codificados. SKU que não existe é ignorado em silêncio — o link não quebra por um item errado.

    Para quem desenvolve

    • POST /loja/api/mcp

      Servidor MCP (JSON-RPC 2.0). Aceita tools/list e tools/call; leitura sem chave, compra com token.

    • /openapi.json

      OpenAPI 3.1 das rotas REST da loja — é o que se importa como Action no ChatGPT ou Extension no Gemini.

    • /AGENTS.md

      Contrato para agentes: o que podem fazer sozinhos, o que não podem afirmar, e a situação real dos gateways de pagamento.

    • /llms.txt

      Índice curto para modelos, na convenção llms.txt.