Azul Logistica MCP

Servidor MCP para integrar operacoes da Azul Cargo Express com outros MCPs e sistemas,como Shopify e TOTVS Moda.

Estrutura

azul_mcp_server.py: servidor MCP principal.
mcp_config.example.json: exemplo de configuracao do client MCP.
requirements.txt: dependencias do MCP.
.env.example: modelo das credenciais e parametros da Azul (copie para .env).

Configuracao

python -m pip install -r requirements.txt
cp .env.example .env   # preencha com as credenciais da sua conta Azul Cargo

Deixe SiglaServico vazio no .env para receber todos os servicos disponiveis.Uma sigla especifica (ex.: ECOMM_CORP) pode filtrar e retornar zero cotacoes.

Por padrao o MCP usa a API de producao:

https://ediapi.onlineapp.com.br/toolkit/api

Para apontar para homologacao ou outro ambiente, defina AZUL_BASE_URL no .env.

Ferramentas MCP

azul_status_config: valida configuracao local sem expor senha ou token.
azul_testar_autenticacao: testa login na API Azul.
azul_listar_servicos: lista as siglas de servico (PREMIUM, EXPRESSO, ECOMM, STANDARD e variantes CORP).
azul_cotar_frete: gera cotacao de frete.
azul_rastrear: consulta rastreio por AWB, NFe/CTe ou pedido.
azul_download_cte: baixa XML/PDF de CTe por AWB.
azul_gerar_remessa: emite AWB/Minuta usando payload da API Azul.
azul_cancelar_remessa: cancela AWB/Minuta por AWB.
azul_buscar_faturas: consulta faturas por periodo (data_inicio/data_fim),por ano+mes ou pelos ultimos_meses. Pode exigir liberacao da Azul.

As ferramentas que geram efeito operacional (azul_gerar_remessa eazul_cancelar_remessa) usam confirmar=False por padrao. Nesse modo elasretornam o endpoint e o payload sem executar a operacao. Para enviar para a Azul,chame novamente com confirmar=True.

Rodar

python azul_mcp_server.py

Para usar em um client MCP (Claude Desktop, etc.), copie mcp_config.example.jsone ajuste command, args e cwd para o caminho da sua maquina.

Azul Logistica MCP