# Marketing Stores — Guia para agentes (LLM-Ready)

> A loja online de um pequeno negócio: catálogo com coleções em árvore, carrinho, checkout com Pix e
> cartão, pedidos e entrega, com a mesma visão para o dono e para os agentes dele. O dinheiro cai na
> conta do Mercado Pago do dono, direto. "O agente cuida do estoque. O que o
> comprador paga espera você."

<!-- Escrito em 28/10/2026 a partir de manager/brand/product-truth-stores.md e do código em
     marketing/stores/worker (src/routes, src/mcp/policy.js e tools.js, src/orders.js). -->

Worker (API, MCP, porta pública): https://stores.worker.mymarketing.click
Painel: https://stores.dashboard.mymarketing.click
Loja de cada conta: https://stores.mymarketing.click/<endereço-da-loja>
Servidor MCP: https://stores.worker.mymarketing.click/mcp
O mapa da linha: https://mymarketing.click/llms.txt

## 0. Estado e credenciais

- **No ar desde 28/10/2026.** `GET https://stores.worker.mymarketing.click/status` responde
  `{"service":"marketing-stores",…}` com o banco, as fotos e as promessas (entregas na fila, pedidos
  esperando pagamento além do prazo). Confira antes de prometer que algo funciona agora.
- **Login:** o Auth da linha (aplicação Marketing), código por e-mail. Mesmo login, autorização por produto.
- **Chaves:** `shk_` (a conta: lê e escreve) e `smr_` (só lê), criadas no painel, mostradas uma vez.
- **Marca:** uma por loja. Qualquer material (logo, foto, manual em PDF, link do site, texto) vira uma
  proposta de cores, letras e cantos; a pessoa aplica e a loja inteira veste. Só uma pessoa, no painel.
- **Pagamento:** o dono cola o Access Token da conta Mercado Pago dele; a loja cobra direto nela.
  Sem isso a loja não abre.

## 1. API (contrato da casa)

Recurso na raiz, coleção como `{items, page}`, erro como `{error: {code, message}}`. Registro só pelo UUID.

    GET    /api/store                  a loja
    POST   /api/store/brand/read       {sources:[link | {file:{name,data}} | {text}]}: a marca PROPOSTA, não salva
    PUT    /api/store/brand            {colors:{accent,text,background}, fonts:{heading,body}, corners}
    GET    /api/products               ?status=draft|published|soldout|low &q=
    POST   /api/products               {name, priceCents, variants:[{name, color, sku, stock}], collectionIds}
    PATCH  /api/products/:id           status "published" põe na loja
    POST   /api/variants/:id/stock     {"stock": 6} ou {"delta": -1}
    GET    /api/collections            a árvore, na ordem do menu (depth, path, productCount)
    GET    /api/orders                 ?status=ship|awaiting|shipped|delivered|closed &q=
    GET    /api/orders/:id             pergunta ao Mercado Pago enquanto espera pagamento
    POST   /api/orders                 venda fechada no WhatsApp: devolve paymentUrl
    POST   /api/orders/:id/ship        {"trackingCode": "QB123456789BR"}
    GET    /api/overview               os números do mês e o que pede ação

## 2. MCP

- Livres: `stores_list_products`, `stores_get_product`, `stores_list_orders`, `stores_get_order`, `stores_update_stock`.
- Confirma (vira pedido que uma pessoa aprova no painel): `stores_update_product`, `stores_update_collection`,
  `stores_create_coupon`, `stores_create_order`, `stores_mark_shipped`. Mande `why`: a pessoa lê.
- Não são ferramentas: reembolsar, cancelar pedido pago, mexer no pagamento.

## 3. Eventos de saída

Webhooks assinados em `x-ccm` (Standard Webhooks): `order.created`, `order.paid`, `order.shipped`,
`order.delivered`, `order.canceled`, `order.refunded`, `product.out_of_stock`, `action.pending`.
O corpo é `{type, timestamp, data: {person, channel, properties}}`; `order.paid` leva o comprador.

## 9. O que o Stores NÃO faz (leia antes de prometer)

- Cotação e etiqueta automáticas dos Correios: o frete é a tabela da loja por região do CEP; o rastreio é digitado.
- E-mail ao comprador: ele acompanha pelo link do pedido.
- Domínio próprio da loja, nota fiscal, boleto, reembolso parcial, marketplace, mais de uma loja por conta.
- Pagamento por outro provedor que não o Mercado Pago.
- Preço do Stores: nada é cobrado hoje; não cite preço nem condição comercial.