Zaslat.cz

Conecte assistentes de IA à plataforma de envios Zaslat.cz por meio do Model Context Protocol. Crie remessas, consulte tarifas, rastreie pacotes e pesquise pontos de coleta — tudo por meio de linguagem natural.

Por que MCP — a terceira interface para logística

A Zaslat há muito tempo oferece duas formas de envio: o aplicativo web para humanos e a API REST para sistemas. O MCP é a terceira — criado para assistentes de IA que agem em nome de um usuário real, com sua conta, seus endereços e seus contratos com transportadoras.

Enquanto a API REST exige uma integração limpa e um desenvolvedor por trás, o MCP se destaca nas tarefas complicadas do meio:

• Uma planilha Excel com endereços em três formatos diferentes — basta enviá-la e pedir ao assistente para enviar todos.
• Um pedido de cliente que chegou como texto simples em um e-mail — cole-o e obtenha uma remessa.
• Perguntas rápidas como “qual é a forma mais barata de enviar 2 kg para Berlim amanhã?” respondidas em segundos.
• Coletas pontuais, cancelamentos em massa, reimpressões de etiquetas — sem clicar pelo painel ou escrever um script.

O servidor MCP da Zaslat conecta qualquer assistente compatível com MCP — Claude, ChatGPT, n8n, agentes personalizados — a uma conta Zaslat real. A IA entende o contexto, segue as preferências do usuário (remetente padrão, transportadora preferida, configuração de COD) e executa ações reais: comparação de tarifas, criação de remessas, rastreamento, impressão de etiquetas, cancelamento.

É ideal para usuários tecnicamente curiosos e equipes de operações que desejam automatizar envios sem ter um projeto de integração. Se você consegue descrever o que precisa em linguagem simples, o assistente pode fazer.

Início rápido (Claude.ai / Claude Desktop)

1. Configurações → Conectores → Adicionar conector personalizado
2. URL: https://mcp.zaslat.cz/mcp
3. Escolha OAuth — você será redirecionado para a página de login da Zaslat
4. Aprove o acesso — o conector está pronto

Autenticação

O servidor aceita dois tipos de credenciais. Ambos são validados no backend da Zaslat em initialize e revalidados a cada 30 minutos durante toda a sessão MCP.

OAuth 2.1 (recomendado)

O servidor anuncia seus metadados de autorização em:

GET https://mcp.zaslat.cz/.well-known/oauth-protected-resource

Clientes MCP que suportam OAuth (Claude.ai, Claude Desktop) descobrem o servidor de autorização automaticamente e executam o fluxo padrão de código de autorização com PKCE contra api.zaslat.cz.

Scopes: rates, shipments:read, shipments:write

Chave de API

Para clientes headless (n8n, scripts, agentes personalizados), passe uma chave de API da Zaslat no cabeçalho X-ApiKey:

POST /mcp HTTP/1.1
Host: mcp.zaslat.cz
X-ApiKey: <your-api-key>
Content-Type: application/json

Você pode gerar uma chave de API após fazer login em app.zaslat.cz em Configurações → Integrações → Integração de API.

Ferramentas

O servidor MCP da Zaslat expõe 9 ferramentas que cobrem todo o fluxo de envio — desde comparação de tarifas e busca de pontos de coleta até criação de remessas, impressão de etiquetas, rastreamento e cancelamento.

Tarifas e informações

Ferramenta	Descrição	Modifica dados
get_rates	Compara tarifas de transportadoras para uma rota e lista de pacotes.	Não
get_profile	Carrega perfil do usuário, endereço de remetente padrão e configurações da conta.	Não
search_parcel_points	Encontra pontos de coleta/entrega mais próximos por endereço, CEP ou transportadora.	Não

Gerenciamento de remessas

Ferramenta	Descrição	Modifica dados
create_shipment	Cria uma nova remessa (Home2Home, Shop2Home, Home2Shop, Shop2Shop).	Sim
cancel_shipment	Cancela uma remessa que ainda não foi coletada pela transportadora.	Sim

Listagem e rastreamento

Ferramenta	Descrição	Modifica dados
list_shipments	Lista remessas com filtros e paginação.	Não
get_shipment_detail	Detalhes completos da remessa, incluindo o número de rastreamento da transportadora.	Não
track_shipment	Status de rastreamento com histórico de eventos.	Não

Etiquetas

Ferramenta	Descrição	Modifica dados
print_label	Gera uma etiqueta de envio (link PDF ou base64).	Não

Fluxo de trabalho típico

1. get_profile           → Load default sender address
2. get_rates             → Compare carrier rates
3. search_parcel_points  → Find pickup point (Home2Shop / Shop2Shop)
4. create_shipment       → Create shipment with the selected carrier
5. print_label           → Download label for printing
6. track_shipment        → Track shipment status

Exemplos de prompts

Comparando tarifas

Quais são as tarifas de envio para um pacote de 30×20×15 cm, 3 kg, de Praga para Brno?

Compare os preços das transportadoras para uma remessa de 5 kg para Bratislava.

Quanto custa enviar 2 pacotes de Ostrava para Berlim?

Criando uma remessa

Envie um pacote via DPD para Jan Novák, Příčná 5, Brno 602 00, 2 kg.

Crie uma remessa Zásilkovna para o ponto de coleta 12345, destinatária Eva Malá, telefone 777123456.

Peça PPL com pagamento na entrega de 500 CZK para a conta 1234567890/0100.

Rastreamento e listagem

Onde está minha remessa IZ123456?

Mostre minhas últimas 10 remessas.

Encontre todas as remessas DPD não entregues da semana passada.

Mostre remessas com COD não pago do último mês.

Etiquetas

Imprima a etiqueta da remessa IZ123456.

Preciso de uma etiqueta A6 para impressora térmica.

Envio em massa

(enviar arquivo Excel) Envie todas as remessas deste arquivo via DPD.

Cancelamento

Cancele a remessa IZ123456.

Padrões e convenções

• Tamanho padrão do pacote: 20 × 20 × 20 cm, 1 kg quando as dimensões são omitidas. Para FedEx e UPS, sempre forneça dimensões exatas — cada centímetro afeta o preço.
• IDs de remessa: As remessas Zaslat usam o formato IZxxxxx (ex.: IZ123456). Isso difere do número de rastreamento da transportadora — obtenha-o via get_shipment_detail.
• Códigos de país: Use ISO 3166-1 alpha-2 (CZ, SK, DE).
• Códigos postais: Sem espaços (60200, não 602 00).