meu ecommercedevelopers
Guias de integração

Integrar com Base44

Use REST na aplicação e MCP nas ferramentas do agente.

Cotação na aplicação publicada

Uma aplicação pode chamar a API REST sempre que seu cliente informar o CEP. Oriente o construtor com o contrato e a chave pública da loja:

Adicione um campo de CEP e um botão de cálculo de frete. Use POST https://api.meuecommerce.com.br/v1/rates com Authorization Bearer usando a chave pública da loja. Envie destinationCep e items, com name, quantity, unitPriceBRL e weightKg por unidade. Mostre label, price e deliveryDays. Trate carregamento, falha e rates vazio. Recalcule ao alterar o carrinho ou destino.

Baixe o OpenAPI para usar como referência do construtor. Os valores devem vir do carrinho real.

Rastreio pelo backend

Guarde MEUECOMMERCE_SECRET_KEY como secret da plataforma e faça a consulta por uma função de backend. A chave mk_… nunca deve aparecer no navegador ou no prompt compartilhado do projeto.

Exemplo de rastreamento.

Ferramentas para o agente

Quando o cliente do agente oferecer suporte a MCP remoto, conecte o servidor e autorize a loja conforme o guia MCP. Isso permite ao agente operar as ferramentas disponibilizadas pela credencial.

Conectar o agente ao MCP não instala automaticamente a integração REST na aplicação publicada. Configure e valide o fluxo que o comprador vai utilizar.

Antes de publicar sua aplicação

Teste um CEP válido, um CEP inválido, ausência de cotação e falha de autenticação. Confirme que a chave secreta não está no código do navegador e que o total do pedido é validado pelo backend.

Nesta página