Em testes. Hoje existe uma única consulta disponível, a de CEP. Ela foi escolhida por ser a mais inofensiva da plataforma: não tem dado pessoal, não escreve nada e não gasta saldo. As próximas vêm depois que esta provar o caminho.

O que é

O MCP Conectenvios permite que um assistente de IA consulte a plataforma sozinho, sem abrir o painel e sem escrever código de integração. Você conecta o assistente uma vez e depois pergunta em português.

MCP é o Model Context Protocol, um padrão aberto para ligar assistentes de IA a sistemas externos. Ele não pertence a nenhum fornecedor de nuvem, e foi por isso que escolhemos esse caminho: o mesmo endereço atende clientes diferentes.

Quem precisa de integração de sistema, com pedido entrando por ERP ou por loja, continua na API. O MCP serve a outra coisa: uma pessoa conversando com um assistente.

O que dá para fazer hoje

A única ferramenta publicada chama-se lookup_cep. Ela 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.

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

• Qual o endereço do CEP 01001-000?
• Esse cliente mandou o CEP 30130-110. Confere com Belo Horizonte?

Como pedir acesso

O acesso exige um token próprio. Não existe autoatendimento hoje: fale com o suporte.

Diga qual assistente você vai usar. Isso não muda o token nem o endereço, que são os mesmos para qualquer cliente: o mesmo token funciona no Claude Code, no Cursor e no VS Code ao mesmo tempo. O nome serve só para o token nascer reconhecível na lista, que é o que permite revogar o certo depois.

Pelo mesmo motivo, vale pedir um token por assistente. É recomendação, não exigência: se precisar cortar um, os outros continuam funcionando.

O token aparece uma única vez no momento da emissão. Guarde na hora. Se perder, peça outro — e o anterior pode ser revogado.

Cada token carrega um escopo, escolhido na emissão:

Para o teste atual, peça read:public. Ele cobre a consulta de CEP e não dá acesso a nada da conta.

Como conectar

Em todos os casos, troque SEU_TOKEN pelo token que o suporte enviou. O endereço do servidor é sempre o mesmo:

https://app.conectenvios.com.br/mcp

Claude Code

Um comando no terminal:

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

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

Cursor

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

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

Depois abra Settings, seção MCP, e confirme que o servidor aparece conectado.

VS Code com GitHub Copilot

Crie .vscode/mcp.json:

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

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

Como saber se funcionou

Pergunte ao assistente 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 explicitamente para usar a ferramenta do Conectenvios.

O que ainda não funciona

ChatGPT e o conector do Claude.ai não conseguem conectar hoje. Não é falha de configuração e não adianta tentar.

Esses dois aceitam apenas servidores que fazem login por OAuth, o mesmo fluxo de “entrar com a sua conta”. O nosso pede token colado à mão, que é suficiente para ferramentas de desenvolvedor e não é aceito lá.

Esta versão fica no token. O login por OAuth, que é o que abriria esses dois clientes e dispensaria o pedido ao suporte, ficou para uma etapa seguinte e não tem data.

Atenção ao nome, porque confunde. Claude Code e Claude.ai são produtos diferentes aqui. O Claude Code é a ferramenta de terminal e conecta com token, sem OAuth — testado e confirmado. O Claude.ai é o site e o aplicativo, e é o conector dele que exige OAuth. Mesma história no ChatGPT: o produto existe, o que falta é o jeito de autenticar.

Segurança

O token do MCP fica guardado na configuração de um programa de IA, que é lido e escrito por um modelo. Por isso ele foi desenhado mais restrito que o token da API.

Trate como senha. Não cole em chat, em issue, em print de tela nem em repositório.

• Estar logado no painel não abre o MCP. Mesmo com sessão válida no mesmo domínio, a requisição é recusada. Só token vale.
• Token da API não abre o MCP. Os tokens que integrações de loja já usam são rejeitados aqui, e o token do MCP também não vale na API. As duas superfícies não compartilham credencial.
• Não existe token que abre tudo. O escopo é escolhido na emissão e cobrado a cada chamada.

O token não expira por padrão. Foi uma decisão consciente: token que vence sem aviso vira chamado de suporte com erro genérico. Em compensação, avise o suporte quando parar de usar, para revogar. Toda emissão fica registrada em auditoria.

Problemas comuns

Ao abrir chamado, informe o cliente de IA, o horário e a mensagem exata. Nunca envie o token.

O que vem a seguir

As próximas ferramentas reusam o que a plataforma já tem, e todas entram em read:public: cotação de frete, prazo de entrega, lista de transportadoras, pontos de coleta e rastreio por código.

Depois delas vem o que toca a conta, e aí a barra sobe. Listar envios exige decidir o que fazer com nome, endereço e telefone de destinatário antes de entregar isso a um modelo. Criar envio gasta dinheiro e depende de uma confirmação fora do chat, porque um assistente encadeia chamadas sozinho. Enquanto esse desenho não existir, o MCP permanece somente leitura.

Sugestão de ferramenta, ou algo que não funcionou: fale com o suporte.