Conector Melhor Envio para Claude
Cote fretes, compre e gere etiquetas, imprima, rastreie, cancele e crie devoluções conversando com o Claude.
Com o conector Melhor Envio, você opera sua conta pelo Claude: cota fretes, compra e gera etiquetas, imprime, rastreia, cancela e cria devoluções, tudo em conversa.
O que é
O conector liga o Claude à sua conta Melhor Envio. Você pede em linguagem natural e o Claude executa as mesmas operações que você faz no painel ou pela API do Melhor Envio. Ele só faz o que a sua conta já pode fazer.
Pré-requisitos
- Conta ativa no Melhor Envio.
- Um plano do Claude que permita usar conectores, ou o Claude Code.
- Para comprar etiquetas: saldo na carteira, conta pós-paga ou um app de banco para pagar PIX.
Como conectar
Claude.ai e Claude Desktop
- Abra Configurações → Conectores.
- Procure Melhor Envio no diretório e clique em Conectar. Se preferir, adicione um conector personalizado com a URL
https://melhorenvio.com.br/mcp. - Entre com seu e-mail e senha do Melhor Envio.
- Na tela de autorização, confira as permissões e clique em Autorizar.
Claude Code
claude mcp add --transport http melhorenvio https://melhorenvio.com.br/mcpDepois, no Claude Code, digite /mcp, escolha melhorenvio e Authenticate. O navegador abre para o login e a autorização.
O que você autoriza
A tela de autorização lista o que o conector pode fazer: ler seus dados e saldo, cotar fretes, gerenciar o carrinho, comprar, gerar, imprimir, rastrear e cancelar etiquetas, e consultar suas lojas. O conector usa o padrão OAuth: o Claude nunca vê sua senha.
O que dá para fazer
| Grupo | Ação | Pede confirmação |
|---|---|---|
| Conta | Ver saldo da carteira e débitos | Não |
| Conta | Ver seu endereço e dados de remetente | Não |
| Conta | Listar suas lojas e os endereços de cada uma | Não |
| Frete | Cotar frete entre dois CEPs, com preço e prazo por transportadora | Não |
| Frete | Listar transportadoras, serviços e agências de postagem | Não |
| Carrinho | Adicionar um frete ao carrinho | Sim |
| Carrinho | Criar a devolução (logística reversa) de um envio entregue | Sim |
| Carrinho | Ver o carrinho ou um item dele | Não |
| Carrinho | Remover um item do carrinho | Sim |
| Etiquetas | Comprar as etiquetas do carrinho | Sim |
| Etiquetas | Gerar etiquetas já pagas junto à transportadora | Sim |
| Etiquetas | Gerar link de impressão ou de pré-visualização | Não |
| Etiquetas | Verificar se uma etiqueta pode ser cancelada | Não |
| Etiquetas | Cancelar uma etiqueta | Sim |
| Pedidos | Listar, pesquisar e detalhar suas etiquetas | Não |
| Pedidos | Rastrear envios | Não |
O Claude também pode pedir sua permissão antes de usar qualquer ação que grave algo na conta, conforme suas configurações do Claude.
Ações que cobram ou não têm volta
Nada acontece sem a sua confirmaçãoNada é comprado, gerado, cancelado ou removido sem a sua aprovação na conversa. Nessas ações, o Claude primeiro mostra um resumo do que vai acontecer e só executa depois que você confirmar.
Compra
- O resumo mostra as etiquetas, o total, os débitos pendentes da conta e o saldo disponível. Débitos pendentes são cobrados junto com a compra.
- Carteira (padrão): o valor sai do saldo. Em contas pós-pagas, vai para a fatura.
- PIX: o Claude devolve um código copia e cola para você pagar no app do banco. As etiquetas só ficam pagas quando o PIX é compensado.
- O conector não aceita cartão e não transfere dinheiro entre contas. Ele só paga fretes do Melhor Envio.
Geração e cancelamento
- Gerar a etiqueta a registra na transportadora. Depois disso, ela só pode ser cancelada dentro do prazo da transportadora.
- O cancelamento não pode ser desfeito. O valor volta para a carteira conforme as regras de cancelamento. Peça ao Claude para verificar antes se a etiqueta ainda pode ser cancelada.
Links de impressão públicos
Por padrão, o link de impressão ou pré-visualização é privado: só abre com login na sua conta. Se você pedir, o Claude gera um link público, que abre sem login.
Use links públicos com cuidadoA etiqueta mostra nome, endereço e telefone do destinatário, e quem tiver o link consegue vê-la.
Exemplos de pedidos
| Você pede | O que o Claude faz |
|---|---|
| "Quanto custa enviar uma caixa de 20×15×10 cm e 1 kg do CEP 01310-100 para 20040-020?" | Cota o frete e lista preço e prazo por transportadora |
| "Coloca no carrinho a opção mais barata, para Maria Souza, Rua Primeiro de Março 100" | Monta a etiqueta, pergunta o que faltar e pede sua confirmação |
| "Compra o que está no carrinho com PIX" | Mostra o total e, depois da sua confirmação, devolve o código PIX |
| "Gera e me manda o link para imprimir" | Gera as etiquetas pagas, após confirmação, e devolve o link |
| "Onde estão meus envios da última semana?" | Lista as etiquetas do período e o rastreio de cada uma |
| "A cliente quer devolver o pedido 123. Cria a devolução por PAC" | Encontra o envio e prepara a logística reversa para você confirmar |
Privacidade e dados
- O conector só conversa com a API do próprio Melhor Envio. Ele não acessa outros serviços nem o histórico das suas conversas.
- O Melhor Envio recebe apenas os dados de cada ação pedida (CEPs, medidas, remetente, destinatário), como acontece no painel. O conteúdo da conversa não é enviado nem guardado.
- Ações que gravam algo na conta ficam num registro de auditoria, com os dados enviados e o aplicativo que fez a chamada. Esse registro é tratado conforme a LGPD e guardado por 15 dias.
- Os dados são compartilhados com transportadoras e meios de pagamento só quando necessário para cotar, gerar, cancelar ou pagar, como no uso normal da plataforma.
- Política completa: Politica de Privacidade
Como revogar o acesso
- No painel do Melhor Envio, abra Integrações.
- No card do Claude, abra as configurações e clique em Excluir integração.
O acesso é cortado na hora: a próxima ação do Claude falha e ele pede para conectar de novo. Você também pode desconectar pelas configurações de conectores do Claude.
Limitações conhecidas
- Logística reversa só por Correios PAC ou SEDEX, para envios já entregues, com um volume, que não sejam eles mesmos uma devolução.
- Mais de um volume por etiqueta só nas transportadoras que agrupam volumes.
- Pagamento só por carteira, fatura pós-paga ou PIX. PIX não está disponível para contas pós-pagas.
- Respostas muito grandes vêm cortadas. Peça com filtros, como período ou status, ou por página.
Suporte
Dúvidas ou problemas com o conector: [email protected]. Informe o que você pediu ao Claude e, se houver, o ID da etiqueta.
Updated 2 days ago