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).

Related MCP server: Tienda Nube MCP Server

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 e azul_cancelar_remessa) usam confirmar=False por padrao. Nesse modo elas retornam 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.json e ajuste command, args e cwd para o caminho da sua maquina.