TrackMage

oficial

Recursos de API de rastreamento de remessas e gerenciamento logístico através da API TrackMage

GitHub
2

O que você pode fazer com TrackMage MCP?

  • Criar uma remessa para rastreamento — Use create_shipment para registrar um número de rastreio e, opcionalmente, definir uma transportadora e um e-mail de notificação.

  • Obter pontos de verificação de rastreamento da remessa — Recupere eventos detalhados de pontos de verificação de uma remessa com get_shipment_checkpoints.

  • Detectar uma transportadora a partir de um número de rastreio — Use detect_carrier para encontrar possíveis transportadoras que correspondam ao formato do número de rastreio.

  • Listar remessas em um workspace — Navegue pelas remessas com list_shipments, com paginação opcional e filtragem por workspace.

  • Rastrear novamente várias remessas de uma vez — Reative o rastreamento de vários números de rastreio em lote usando retrack_shipments.

  • Gerenciar pedidos junto com remessas — Crie, atualize e liste pedidos via create_order, update_order e list_orders.

Documentação

TrackMage MCP Server - API de Rastreamento de Encomendas & Integração com API de Logística

Um servidor Model Context Protocol (MCP) para API de rastreamento de encomendas, monitoramento de pacotes e gerenciamento logístico usando a API TrackMage. Suporta rastreamento em mais de 1600 transportadoras no mundo todo.

Funcionalidades

  • Suporte a Transportadoras: Rastreie pacotes em mais de 1600 transportadoras no mundo todo (lista completa)
  • Recursos: Áreas de trabalho, envios, pedidos, transportadoras, status de rastreamento
  • Ferramentas: Criar envios/pedidos, obter pontos de verificação de envio, detecção de transportadora
  • Autenticação: OAuth com credenciais de cliente

⚠️ Aviso de Privacidade de Dados

Compartilhamento de dados com seu provedor de LLM: Este servidor MCP fornece dados para qualquer LLM que você estiver usando (Claude, ChatGPT, etc.). Embora esse seja o comportamento esperado para servidores MCP, certifique-se de que você está confortável em compartilhar dados logísticos, incluindo números de rastreamento, e-mails de clientes, endereços e detalhes de envio com o provedor de LLM escolhido.

Boas práticas:

  • Use apenas com dados não sensíveis ou de teste se tiver preocupações com privacidade
  • Verifique as políticas de tratamento de dados do seu provedor de LLM
  • Considere optar por não participar de programas de dados de treinamento, se disponível
  • Garanta a conformidade com as políticas de dados da sua organização

Pré-requisitos

  • Node.js v18+
  • Conta TrackMage

Obtendo Credenciais

  1. Registre-se e faça login no TrackMage.
  2. Vá para Configurações > API KEYS.
  3. Insira um Nome do App (ex.: "MCP") e URL do App (ex.: http://localhost:3000).
  4. Clique em Gerar e copie seu Client ID e Client Secret.
  5. Anote seu Workspace ID a partir da URL do painel.

Instalação

Opção 1: Configuração Local

git clone https://github.com/yourusername/trackmage-mcp-server.git
cd trackmage-mcp-server
npm install
cp .env.example .env
# Edit .env with your credentials
npm start

Configuração

Edite .env:

TRACKMAGE_CLIENT_ID=your_client_id_here
TRACKMAGE_CLIENT_SECRET=your_client_secret_here
TRACKMAGE_WORKSPACE_ID=your_workspace_id_here

Uso

Execute o servidor:

npm start

e então use

{
  "mcpServers": {
    "trackmage": {
      "transport": {
        "type": "http",
        "host": "localhost",
        "port": 3000
      }
    }
  }
}

ou usando processo de arquivo:

{
  "mcpServers": {

    "trackmage": {
      "command": "node",
      "args": ["/path/to/trackmage-mcp-server/index.js"],
      "env": {
        "TRACKMAGE_CLIENT_ID": "your_client_id_here",
        "TRACKMAGE_CLIENT_SECRET": "your_client_secret_here",
        "TRACKMAGE_WORKSPACE_ID": "your_workspace_id_here"
      }
    }

  }
}

Recursos MCP

  • trackmage:///workspaces/{id}
  • trackmage:///shipments/{id}
  • trackmage:///orders/{id}
  • trackmage:///carriers/{id}
  • trackmage:///tracking_statuses/{id}

Ferramentas MCP

Gerenciamento de Envios

  • create_shipment: Criar um novo envio

    • Parâmetros: { trackingNumber, originCarrier?, email?, workspaceId? }
    • Retorna: Objeto de envio criado

  • update_shipment: Atualizar um envio existente

    • Parâmetros: { shipmentId, trackingNumber?, originCarrier?, email?, status? }
    • Retorna: Objeto de envio atualizado

  • list_shipments: Listar envios da área de trabalho

    • Parâmetros: { workspaceId?, page?, itemsPerPage? }
    • Retorna: Array de objetos de envio

  • get_shipment_checkpoints: Obter pontos de verificação de rastreamento para um envio

    • Parâmetros: { shipmentId }
    • Retorna: Array de eventos de ponto de verificação de rastreamento

  • retrack_shipments: Rastrear novamente múltiplos envios por números de rastreamento

    • Parâmetros: { trackingNumbers: [{ number, originCarrier? }], workspaceId? }
    • Retorna: Resultados do re-rastreamento

Gerenciamento de Pedidos

  • create_order: Criar um novo pedido

    • Parâmetros: { orderNumber, email?, workspaceId? }
    • Retorna: Objeto de pedido criado

  • update_order: Atualizar um pedido existente

    • Parâmetros: { orderId, orderNumber?, email?, status? }
    • Retorna: Objeto de pedido atualizado

  • list_orders: Listar pedidos da área de trabalho

    • Parâmetros: { workspaceId?, page?, itemsPerPage? }
    • Retorna: Array de objetos de pedido

Gerenciamento de Transportadoras

  • list_carriers: Listar transportadoras disponíveis

    • Parâmetros: { page?, itemsPerPage? }
    • Retorna: Array de objetos de transportadora com códigos e nomes

  • detect_carrier: Detectar possíveis transportadoras para um número de rastreamento

    • Parâmetros: { trackingNumber }
    • Retorna: Array de possíveis correspondências de transportadora

Testes

npm test