Como conectar sua loja Domob ao Claude, ChatGPT, Codex e Cursor (MCP)

O que é o MCP da Domob?

MCP (Model Context Protocol) é o padrão aberto que os agentes de IA usam para conversar com outros sistemas (especificação). O MCP da Domob, em https://mcp.domob.pro/mcp, dá ao seu agente ferramentas sobre a sua loja:

A IA é a da sua conta no Claude ou na OpenAI. Os textos que o seu agente escreve não geram custo na Domob.

Como conectar no claude.ai ou no ChatGPT?

No claude.ai (Customize › Connectors, adicionar um conector por URL) ou no ChatGPT (conectores, no modo de desenvolvedor), informe o endereço https://mcp.domob.pro/mcp. O aplicativo abre o Entrar com a Domob:

1. Entre no painel da Domob, se ainda não estiver logado, com a loja certa selecionada no topo.
2. Confira o aplicativo, o endereço para onde ele volta e o que ele poderá fazer. Desmarque o que não quiser. A geração de imagens com custo nunca vem marcada.
3. Clique em Conectar. Só o dono ou um administrador da loja conecta.

O acesso vale por até 90 dias e pode ser desconectado a qualquer momento em Integrações e Add-ons → Chaves de API e IA → Aplicativos conectados. Se você deixar de ser dono ou administrador da loja, a conexão cai sozinha.

Se aparecer o aviso "aplicativo não verificado", confira o endereço de volta: só conecte se você o reconhece.

Como criar a chave de API? (Claude Code, Codex e Cursor)

1. No painel da Domob, abra Integrações e Add-ons → Chaves de API e IA. Só o dono ou um administrador da loja cria chaves.
2. Dê um nome que diga onde ela vai ser usada, por exemplo "Claude Code do escritório".
3. Marque só o que o agente precisa:
   • Consultar vendas e funil para as consultas;
   • Ler produtos do catálogo e Sugerir textos de produtos com a sua IA para o enriquecimento;
   • Enviar imagens de produtos feitas pela sua IA, se o seu agente gera imagens (o Codex gera);
   • Gerar imagens pela Domob, com custo, se você quer que a Domob gere as imagens (o Claude Code não gera imagens).
4. Copie a chave (dmk_…). Ela aparece uma única vez.

Guarde a chave como uma senha: em variável de ambiente, nunca em arquivo que vai para um repositório. Se ela vazar, revogue no mesmo lugar onde a criou.

Como conectar o Claude Code?

Com a chave numa variável de ambiente (DOMOB_API_KEY), rode no terminal (documentação do Claude Code):

claude mcp add --transport http domob https://mcp.domob.pro/mcp --header "Authorization: Bearer ${DOMOB_API_KEY}"

Depois, peça em linguagem natural, por exemplo: "use o MCP da Domob, pegue as tarefas de enriquecimento e escreva as descrições que estão faltando".

Como conectar o Codex?

No arquivo ~/.codex/config.toml (documentação do Codex):

[mcp_servers.domob]
url = "https://mcp.domob.pro/mcp"
bearer_token_env_var = "DOMOB_API_KEY"

Como conectar o Cursor?

No mcp.json do Cursor (documentação do Cursor):

{
  "mcpServers": {
    "domob": {
      "url": "https://mcp.domob.pro/mcp",
      "headers": { "Authorization": "Bearer ${env:DOMOB_API_KEY}" }
    }
  }
}

O que acontece com os textos que o agente escreve?

Nada muda na loja sozinho. Cada entrega vira uma sugestão pendente, marcada com o agente que a escreveu (por exemplo, "via Claude Code"). Você revisa no painel, na tela do Agente de Catálogo, edita se quiser e aprova. Só então o produto muda.

A Domob confere cada entrega antes de guardar: textos sem link, sem código e dentro do tamanho de cada campo. O agente recebe as instruções da Domob (não inventar característica técnica, não citar preço nem promoção, tom da loja) junto com os dados do produto.

Como a sua IA anexa imagens aos produtos?

Se o seu agente gera imagens (o Codex gera), ele pode criar uma ambientação, um fundo ou um detalhe e anexar ao produto:

1. pedir_envio_de_imagem com o produto, o tipo (JPEG, PNG ou WebP) e o tamanho exato do arquivo. A Domob devolve um endereço de envio que vale para esse arquivo só, por 10 minutos.
2. O agente envia o arquivo direto para esse endereço. A imagem não passa pela conversa.
3. anexar_imagem: a Domob confere o arquivo (tipo, tamanho e dimensões, até 10 MB e 4096 px) e o anexa ao produto como imagem de IA pendente.

Você aceita ou recusa no painel, nas imagens de IA do produto. A imagem nunca vira a foto principal sozinha.

E se a minha IA não gera imagens?

O Claude Code não gera imagens. Nesse caso, a Domob gera, com o mesmo estúdio do painel, e cobra como no painel:

1. orcar_imagens_da_domob diz quanto custam as imagens, se cabem no seu limite de gasto e quanto crédito sobra. Não cobra nada.
2. O agente mostra o valor a você. Com o seu ok, chama gerar_imagens_da_domob com o valor confirmado.
3. Se o valor mudou nesse meio-tempo, nada é gerado e o valor novo volta para você confirmar.

As imagens entram pendentes, para você aceitar no painel.

Quanto custa?

O uso pelo MCP com a sua IA não é cobrado. A única exceção é a imagem gerada pela Domob, que custa o mesmo que no painel e só sai com o valor confirmado por você. Ele aparece em Configurações → Uso e custos como "Enriquecimento feito pela sua IA (MCP)" e "Imagem feita pela sua IA (MCP)", a R$ 0,00, para você acompanhar o que o agente fez. O espaço das imagens conta no uso justo do plano, como qualquer foto.

Como a Domob protege a sua loja?

• A loja é a da chave. Nenhuma ferramenta aceita o identificador de outra loja; um produto de outra loja responde como se não existisse.
• Cada chave só faz o que você marcou. Sem a permissão do catálogo, o agente nem lê os produtos.
• Nada apaga, muda preço ou estoque, cobra ou mexe em pagamento.
• A imagem é conferida pelo conteúdo do arquivo, não pelo nome, e a Domob nunca busca imagem em endereço externo.
• Os textos da loja chegam ao agente como dados, não como instruções, para que um texto malicioso num produto não comande o seu agente.
• Há limite de uso por chave, e cada uso fica registrado com a chave que o fez.