Novidade: assistentes de IA

Seu frete, direto no assistente de IA

Cote fretes, acompanhe envios e resolva o dia a dia da sua loja conversando com o ChatGPT, o Claude ou a ferramenta de IA que você já usa. Em português, sem instalar nada e sem escrever código.

  • ✓ Sem código
  • ✓ Você decide o que ele pode fazer
  • ✓ Desconecta quando quiser

Em testes. Consultas, dados da conta e emissão de etiquetas já funcionam. Se algo sair diferente do esperado, fale com o suporte.

Exemplo de conversa
Quanto sai uma caixa de 2 kg para o CEP 30130-110?
Consultando a Conectenvios…

Encontrei estas opções com o preço da sua conta:

  • Econômico · 6 dias úteis R$ 24,90
  • Padrão · 4 dias úteis R$ 31,50
  • Expresso · 2 dias úteis R$ 48,70

Quer que eu veja o prazo para outro CEP?

Valores ilustrativos

Passo a passo

Como funciona

Três passos, uma vez só. Depois é só conversar.

  1. 1

    Conecte

    Nas configurações do seu assistente, adicione um conector e cole o endereço da Conectenvios.

  2. 2

    Autorize

    Entre com a sua conta de sempre e marque o que o assistente pode fazer. Dá para mudar depois.

  3. 3

    Converse

    Peça em português, do seu jeito. O assistente consulta a Conectenvios sozinho e responde com os dados da hora.

Endereço da Conectenvios para colar no assistente

https://app-stg.conectenvios.com.br/mcp
Ferramentas

O que dá para fazer hoje

Você pede, o assistente escolhe a ferramenta certa e responde. Cada grupo abaixo depende de uma permissão que você concede ao conectar.

Consultas

Disponível

CEP, cotação com o preço da sua conta, prazo e rastreio. Não mostra dados pessoais e não gasta nada.

Experimente pedir

  • Qual o endereço do CEP 01001-000?
  • Esse cliente mandou o CEP 30130-110. Confere com Belo Horizonte?
  • Quanto sai uma caixa de 2 kg, 30 × 20 × 15 cm, para o CEP 30130-110?
  • Onde está o envio AA123456789BR? Já saiu para entrega?

Depois de conectar, pergunte em linguagem natural. O assistente decide sozinho quando chamar cada ferramenta.

Para quem é técnico

Permissão read:public: CEP, cotação, prazo, transportadoras, pontos de coleta e rastreio por código. Nenhum dado pessoal.

  • lookup_cep: recebe um CEP brasileiro, com ou sem hífen, e devolve logradouro, bairro, cidade e estado. A consulta vai à base dos Correios, a mesma que o painel usa.
  • quote_shipping: cota o frete de um pacote, do CEP de origem do seu perfil até o CEP de destino, com o preço que a sua conta paga e o prazo em dias de cada transportadora disponível. Não cria envio nem debita saldo.
  • track_shipment: rastreia um envio pelo código: o status atual e os eventos mais recentes, com a descrição da transportadora. Para envio da sua conta, consulta a transportadora se a última atualização tiver 60 minutos ou mais; para os demais, mostra o que já está registrado.

Sua conta

Disponível

Os seus envios, com status e destinatário, e o saldo da carteira. Só com a sua permissão.

Experimente pedir

  • Quais envios meus ainda não foram postados?
  • Quanto tenho de saldo na carteira?
Para quem é técnico

Permissão read:account: Envios, carrinhos e saldo da própria conta. Contém dados de destinatários.

Emitir etiquetas

Disponível

Monta o envio, mostra o resumo com preço, prazo e destinatário e só emite depois do seu OK. Paga com o saldo da carteira.

Experimente pedir

  • Monta um envio de 2 kg para a Maria, CEP 30130-110, e me mostra as opções.
  • Pode emitir a mais barata. Me manda o link da etiqueta.
Para quem é técnico

Permissão write: Criar e imprimir envio. Gasta saldo da carteira.

Tem uma ideia de ferramenta, ou algo não funcionou? Fale com o suporte

Conectar

Escolha o seu assistente

O endereço é o mesmo para todos. O que muda é onde colar.

Com a sua conta
https://app-stg.conectenvios.com.br/mcp
  1. 1 No ChatGPT, abra Configurações e procure Conectores (em algumas versões, Apps e conectores).
  2. 2 Não aparece a opção de criar conector? Ative antes o Modo desenvolvedor: Configurações, Apps e conectores, Configurações avançadas.
  3. 3 Adicione um conector personalizado, dê o nome Conectenvios, cole o endereço acima e mantenha a autenticação OAuth, sem preencher um cliente próprio.
  4. 4 Clique para conectar. Abre a tela de login da Conectenvios: entre com a sua conta.
  5. 5 Marque o que o assistente pode fazer e confirme. De volta ao ChatGPT, habilite o conector na conversa, na lista de ferramentas.

O assistente renova o acesso sozinho enquanto for usado. Contas administrativas não conectam assistentes: use uma conta de cliente.

Não achou a opção de conector personalizado? Ela depende do plano do assistente e, em contas de empresa, da liberação do administrador. O nome dos menus também muda de uma versão para outra. Campos de OAuth Client ID ou segredo, quando aparecerem, ficam em branco.

Com a sua conta
https://app-stg.conectenvios.com.br/mcp
  1. 1 No Claude, pelo site ou pelo aplicativo, abra Configurações e depois Conectores.
  2. 2 Clique em Adicionar conector personalizado, dê o nome Conectenvios e cole o endereço acima.
  3. 3 Se o Claude perguntar como se identificar no servidor, escolha Registrar automaticamente. Não use um cliente OAuth próprio: token gerado no painel não é cliente, e a conexão falha.
  4. 4 Clique para conectar. Abre a tela de login da Conectenvios: entre com a sua conta.
  5. 5 Marque o que o assistente pode fazer e confirme. Você volta para o Claude já conectado.

O assistente renova o acesso sozinho enquanto for usado. Contas administrativas não conectam assistentes: use uma conta de cliente.

Não achou a opção de conector personalizado? Ela depende do plano do assistente e, em contas de empresa, da liberação do administrador. O nome dos menus também muda de uma versão para outra. Campos de OAuth Client ID ou segredo, quando aparecerem, ficam em branco.

Com token

Um comando no terminal, trocando SEU_TOKEN pelo seu token:

claude mcp add --transport http conectenvios https://app-stg.conectenvios.com.br/mcp --header "Authorization: Bearer SEU_TOKEN"

Para deixar disponível em qualquer pasta, acrescente --scope user. Confira com claude mcp list.

Com token

Crie ou edite o arquivo .cursor/mcp.json na raiz do projeto:

{
  "mcpServers": {
    "conectenvios": {
      "url": "https://app-stg.conectenvios.com.br/mcp",
      "headers": {
        "Authorization": "Bearer SEU_TOKEN"
      }
    }
  }
}

Depois abra Settings, seção MCP, e confirme que a Conectenvios aparece conectada.

Com token

Crie o arquivo .vscode/mcp.json:

{
  "servers": {
    "conectenvios": {
      "type": "http",
      "url": "https://app-stg.conectenvios.com.br/mcp",
      "headers": {
        "Authorization": "Bearer SEU_TOKEN"
      }
    }
  }
}

Use o modo Agent no chat do Copilot. O modo Ask não chama ferramentas.

Com token
https://app-stg.conectenvios.com.br/mcp

No seu fluxo, adicione o nó MCP Client Tool ao agente de IA e preencha assim:

  • • Endpoint: o endereço acima
  • • Transporte: HTTP Streamable
  • • Autenticação: por cabeçalho, com o nome Authorization e o valor Bearer SEU_TOKEN

Onde pego o token?

No painel, em Assistentes de IA conectados, clique em Gerar token. Dê um nome, marque o que o assistente pode fazer e escolha a validade: recomendamos 90 dias. O token aparece uma única vez: copie na hora e guarde como uma senha.

  • ✓ Um token por assistente: se precisar cortar um, os outros seguem funcionando.
  • ✓ O nome serve só para você reconhecer o token na lista. O endereço e o token funcionam em qualquer ferramenta.
  • ✓ Perdeu o token? Gere outro e desconecte o antigo.
Gerar meu token

Como saber se funcionou

Pergunte ao assistente: “Qual o endereço do CEP 01001-000?” A resposta certa é Praça da Sé, Sé, São Paulo, SP. Se ele responder de memória em vez de consultar, peça para usar a Conectenvios.

Tempo limite de ferramenta

Se a sua ferramenta tiver essa opção, configure o tempo limite de ferramenta em 60 s ou mais. Algumas consultas levam vários segundos, e com um limite menor ela desiste antes da resposta. A emissão de etiqueta pode levar até 50 s e, se a ferramenta desistir antes, ela continua do nosso lado. Por isso, antes de repetir uma emissão, peça ao assistente para consultar o envio.

Segurança

Você no controle

Pensado para quem conversa com um assistente: cada acesso é seu, com limite e com saída.

Você escolhe as permissões

Consultas vêm sempre. Ver os seus envios e emitir etiquetas só se você marcar, conexão por conexão.

Nada é emitido sem o seu OK

O assistente monta o envio e mostra o resumo com preço, prazo e destinatário. A etiqueta só sai depois que você confirma na conversa.

Limite diário por conexão

Cada assistente conectado emite até R$ 200,00 por dia. Você muda esse valor (até R$ 1.000,00) ou bloqueia em Assistentes de IA conectados. Somando tudo, a conta emite até R$ 1.000,00 por dia.

Saldo só pelo portal

O assistente usa o saldo que já está na carteira: recarga, só pelo portal. Se a emissão falhar, o valor volta para a carteira, e a etiqueta e a declaração de conteúdo são emitidas juntas.

Desconecte quando quiser

Em Assistentes de IA conectados você vê quem tem acesso e corta na hora. Trocar a senha desconecta todos os assistentes de uma vez.

Acessos separados

Estar logado no painel não abre o acesso do assistente, e o token da API da sua loja não funciona aqui. Um não serve de chave para o outro.

Dados e retenção

Cada chamada ao MCP gera uma linha no nosso registro de acesso: qual assistente, qual conta, qual ferramenta, quando e com que resultado, além do endereço IP e do programa que fez a chamada. Esse registro é guardado por 180 dias e não leva os dados dos seus envios: nome, documento, telefone, e-mail e endereço de destinatários não entram nele. Dos argumentos, só ficam os que não identificam pessoas, como CEP e código de rastreio.

O que o assistente muda na sua conta, como criar ou emitir um envio, também fica no histórico de auditoria da plataforma, o mesmo das ações feitas pelo painel. Esse histórico não tem prazo de expurgo.

Não guardamos o conteúdo das respostas enviadas ao assistente.

O que as ferramentas devolvem passa a constar no histórico da conversa do assistente. Com acesso aos dados da conta, isso inclui nome, documento, telefone e endereço dos destinatários dos seus envios. Esse histórico fica com o provedor do assistente e segue a política de privacidade e de retenção dele, não a nossa. Desconectar o assistente corta o acesso na hora, mas não apaga o que já está no histórico dele.

Dúvidas frequentes

Perguntas e respostas

Não achou o que procurava? A nossa equipe ajuda.

1 O que é MCP?

MCP (Model Context Protocol) é um padrão aberto para ligar assistentes de IA a outros sistemas. Pense numa tomada universal: a Conectenvios oferece a tomada, e qualquer assistente compatível se conecta nela, sem código de integração.

2 Preciso saber programar?

Não. No ChatGPT e no Claude basta colar o endereço e entrar com a sua conta. Ferramentas de desenvolvedor, como Claude Code, Cursor, VS Code e n8n, usam um token que você mesmo gera no painel.

3 Qual a diferença para a API da Conectenvios?

A API é para integração de sistema: a sua loja ou o seu ERP mandando pedidos sozinhos. O MCP é para uma pessoa conversando com um assistente. Os dois convivem e um não interfere no outro.

4 O que é “entrar com a sua conta” (OAuth)?

É o mesmo login que você já usa em outros serviços: o assistente abre a tela da Conectenvios, você entra e escolhe o que liberar. Ninguém copia senha nem token, e você desconecta quando quiser.

5 O assistente pode gastar o meu saldo sem eu saber?

Não. Emitir exige a permissão de emissão, marcada por você; cada etiqueta só sai depois que você confirma o resumo na conversa; e cada conexão tem um limite diário. O saldo só é recarregado pelo portal.

6 E se a emissão der erro?

O valor volta para a carteira, e a etiqueta e a declaração de conteúdo não ficam pela metade: saem juntas ou não saem. Antes de tentar de novo, peça ao assistente para consultar o envio: às vezes a emissão terminou do nosso lado depois que o assistente desistiu de esperar.

7 O token expira?

Você escolhe ao gerar: 30, 90 ou 365 dias, ou sem vencimento. Recomendamos 90 dias. Trocar a senha da conta desconecta todos os assistentes, com token ou com login.

8 Contas administrativas podem conectar?

Não. Contas da equipe Conectenvios não conectam assistentes nem geram token. Use uma conta de cliente.

9 Deu erro. E agora?
O que aparece Causa O que fazer
401 O token está faltando, escrito errado, venceu ou foi desconectado (trocar a senha desconecta). Confira o cabeçalho, com a palavra Bearer e um espaço antes do token. Se venceu, gere outro.
403, “não foi emitido para uso por IA” É um token da API da loja. Gere um token de assistente em Assistentes de IA conectados.
403, “não tem o escopo” A conexão não tem a permissão que essa ação pede. Gere um token novo, ou conecte de novo, marcando a permissão.
429 Muitas chamadas em pouco tempo. Espere um minuto e tente de novo.
405 A requisição foi por GET. O cliente está mal configurado. Use o transporte HTTP do exemplo.
“Tool not found” O cliente guardou uma lista antiga de ferramentas. Reinicie o cliente para ele reler o servidor.
“Não foi possível consultar o CEP agora” Falha ao falar com os Correios. Tente de novo. Se persistir, avise o suporte.

Ao abrir chamado, informe o assistente usado, o horário e a mensagem exata. Nunca envie o token.

Pronto para conectar?

Entre na sua conta, conecte o assistente e faça a primeira pergunta em poucos minutos.