MCP stĺpec

Prehľad MCP stĺpca

Táto príručka je Superroute MCP stĺpec v Developer Center: oba servery, bezpečnosť agentov a živý katalóg nástrojov.

• User MCP — objednávky, trasy, štítky, digesty pre ops/support agentov — https://api.miliexpress.com/mcp
• Developer MCP — príručky, webhooky a ukážkové API pre integrátorov — https://api.miliexpress.com/mcp/developer
• Bezpečnosť: connection Bearer, profily/scopes, confirm pre high-risk nástroje
• Fronta ľudských schválení (propose_write + /mcp-approvals)

Čo je MCP?

Model Context Protocol (MCP) je otvorený štandard, ktorý umožňuje AI asistentom ako Claude, Cursor a ChatGPT komunikovať s externými nástrojmi a službami. Umožňuje vášmu AI vykonávať skutočné akcie — ako sledovanie zásielky — priamo v konverzácii.

Konfiguráciou MCP servera Superroute získa váš AI asistent prístup k logistickým nástrojom bez opustenia vášho pracovného toku.

Dva MCP servery

Vyberte správny server. Nedávajte bezobslužným agentom Developer server s plným prístupom.

Rýchly štart

Verejné nástroje ako sledovanie zásielok fungujú bez autentifikácie. Pridajte túto konfiguráciu do svojho MCP klienta:

{
  "mcpServers": {
    "mili-express": {
      "type": "url",
      "url": "https://api.miliexpress.com/mcp"
    }
  }
}

Autentifikovaný prístup

Na použitie nástrojov vyžadujúcich používateľské oprávnenia pridajte svoj API Bearer token do konfigurácie:

Tokeny dávajte vždy do hlavičiek MCP pripojenia — nikdy do argumentov nástrojov ani promptov.

{
  "mcpServers": {
    "mili-express": {
      "type": "url",
      "url": "https://api.miliexpress.com/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-token>",
        "X-MCP-Profile": "ops-readonly"
      }
    }
  }
}

Ako získať API token

Zavolajte prihlasovací endpoint so svojimi prihlasovacími údajmi:

curl -X POST https://api.miliexpress.com/api/v1/user/login \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "password": "your-password"}'

Odpoveď bude obsahovať váš prístupový token:

{
  "access_token": "eyJ0eXAiOiJKV1Qi...",
  "token_type": "Bearer",
  "expires_at": "2026-02-20 00:00:00"
}

Použite hodnotu access_token v hlavičke Authorization vašej MCP konfigurácie.

Bezpečnostný model agentov

User MCP je pre least privilege. Vytvárajte tokeny s MCP profilom (predvolené ops iba na čítanie) alebo hlavičkami.

Profily (X-MCP-Profile)

Pomenované balíky scope. Pre bezobslužných agentov ops-readonly alebo support.

{
  "mcpServers": {
    "mili-express": {
      "type": "url",
      "url": "https://api.miliexpress.com/mcp",
      "headers": {
        "Authorization": "Bearer <ops-readonly-token>",
        "X-MCP-Profile": "ops-readonly"
      }
    }
  }
}

Voliteľné hlavičky

High-risk potvrdenie

Tieto nástroje vyžadujú confirm=true pri tools/call (alebo frontu schválení):

• cancel_order
• bulk_create_orders
• reroute_to_address
• build_route
• hold_order
• release_order
• approve_pending_write
• bulk_create_orders_async
• get_shipping_detail
• download_shipping_label
• cancel_shipping_label
• submit_shipping_information
• end_of_day
• uniorder_cancel
• uniorder_purchase_label
• uniorder_create_batch
• uniorder_create_batch_async
• pay_shipping_order
• cancel_shipping_order
• pay_storage_order
• cancel_storage_order
• pay_shipout
• cancel_shipout

Fronta ľudských schválení

Bezobslužní agenti navrhujú zápisy; človek schvaľuje.

1. Agent: propose_write alebo X-MCP-Require-Approval: 1
2. Človek: MCP Approvals v appke alebo list_pending_approvals
3. Človek: approve_pending_write s confirm=true alebo reject_pending_write

Cesta Web UI (vyžaduje prihlásenie): /mcp-approvals

Developer MCP autentifikácia

Preferujte Authorization: Bearer na pripojení. api_token v tooli je zastaraný a končí po 2026-12-31.

Dostupné nástroje

Nasledujúce nástroje sú momentálne dostupné na MCP serveri: 93 živých nástrojov zo serverového katalógu

Táto tabuľka sa generuje z UserMcpToolCatalog za behu a je synchronizovaná s tools/list.

Nastavenie pre klienta

Vyberte svojho AI klienta nižšie pre prispôsobené pokyny na nastavenie:

{
  "mcpServers": {
    "mili-express": {
      "type": "url",
      "url": "https://api.miliexpress.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "mili-express": {
      "type": "url",
      "url": "https://api.miliexpress.com/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-token>",
        "X-MCP-Profile": "ops-readonly"
      }
    }
  }
}

{
  "mcpServers": {
    "mili-express": {
      "type": "url",
      "url": "https://api.miliexpress.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "mili-express": {
      "serverUrl": "https://api.miliexpress.com/mcp"
    }
  }
}

Technické detaily

• Protokol: JSON-RPC 2.0
• Doprava: HTTP POST (Streamable HTTP)
• Limit rýchlosti: 60 požiadaviek za minútu
• Typ obsahu: application/json
• Endpoint: https://api.miliexpress.com/mcp
• Verzie protokolu: 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05
  Obe generácie protokolu sú obsluhované na rovnakom koncovom bode: klienti, ktorí začínajú výmenou initialize, a bezstavoví klienti, ktorí verziu uvádzajú v každej požiadavke. Server nikdy nevydáva identifikátor relácie.
• Zisťovanie OAuth: https://api.miliexpress.com/.well-known/oauth-protected-resource
  Neautentifikovaná požiadavka vráti 401 s hlavičkou WWW-Authenticate, ktorá odkazuje na dokument metadát chráneného zdroja.