MCP-Kolumne

MCP-Kolumne Überblick

Dieser Leitfaden ist die Superroute-MCP-Kolumne im Developer Center: beide Server, Agentensicherheit und der Live-Tool-Katalog.

• User-MCP — Aufträge, Routen, Labels, Digests für Ops/Support-Agenten — https://api.miliexpress.com/mcp
• Developer-MCP — Guides, Webhooks, Beispiel-APIs für Integratoren — https://api.miliexpress.com/mcp/developer
• Sicherheit: Connection-Bearer, Profile/Scopes, Confirm für riskante Tools
• Menschliche Freigabewarteschlange (propose_write + /mcp-approvals)

Was ist MCP?

Das Model Context Protocol (MCP) ist ein offener Standard, der KI-Assistenten wie Claude, Cursor und ChatGPT ermöglicht, mit externen Tools und Diensten zu interagieren. Es ermöglicht Ihrer KI, echte Aktionen durchzuführen — wie z.B. ein Paket zu verfolgen — direkt im Gespräch.

Durch die Konfiguration des Superroute MCP-Servers erhält Ihr KI-Assistent Zugang zu Logistik-Tools, ohne Ihren Workflow zu verlassen.

Zwei MCP-Server

Wählen Sie den passenden Server. Geben Sie unbeaufsichtigten Agenten nicht den Developer-Server mit Vollzugriff.

Schnellstart

Öffentliche Tools wie Paketverfolgung funktionieren ohne Authentifizierung. Fügen Sie diese Konfiguration zu Ihrem MCP-Client hinzu:

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

Authentifizierter Zugang

Um Tools zu verwenden, die Benutzerberechtigungen erfordern, fügen Sie Ihr API-Bearer-Token zur Konfiguration hinzu:

Token immer in MCP-Connection-Headern setzen — nie in Tool-Argumenten oder Prompts.

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

So erhalten Sie ein API-Token

Rufen Sie den Login-Endpunkt mit Ihren Anmeldedaten auf:

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

Die Antwort enthält Ihr Zugriffstoken:

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

Verwenden Sie den access_token-Wert im Authorization-Header Ihrer MCP-Konfiguration.

Agenten-Sicherheitsmodell

User-MCP ist für Least-Privilege-Agenten gebaut. Token mit MCP-Profil (Standard: Ops nur lesen) oder Header setzen.

Profile (X-MCP-Profile)

Benannte Scope-Bündel. Für unbeaufsichtigte Agenten ops-readonly oder support.

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

Optionale Header

Hochrisiko-Confirm

Diese Tools erfordern confirm=true bei tools/call (oder Freigabewarteschlange):

• 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

Menschliche Freigabewarteschlange

Unbeaufsichtigte Agenten sollen Schreibvorgänge vorschlagen; Menschen freigeben.

1. Agent: propose_write oder X-MCP-Require-Approval: 1
2. Mensch: MCP-Freigaben in der App oder list_pending_approvals
3. Mensch: approve_pending_write mit confirm=true oder reject_pending_write

Web-UI-Pfad (Login erforderlich): /mcp-approvals

Developer-MCP-Authentifizierung

Bevorzugen Sie Authorization: Bearer auf der Verbindung. Per-Tool-api_token ist veraltet und endet nach 2026-12-31.

Verfügbare Tools

Die folgenden Tools sind derzeit auf dem MCP-Server verfügbar: 93 Live-Tools aus dem Serverkatalog

Diese Tabelle wird zur Laufzeit aus UserMcpToolCatalog erzeugt und bleibt mit tools/list synchron.

Client-spezifische Einrichtung

Wählen Sie Ihren KI-Client unten für maßgeschneiderte Einrichtungsanweisungen:

{
  "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"
    }
  }
}

Technische Details

• Protokoll: JSON-RPC 2.0
• Transport: HTTP POST (Streamable HTTP)
• Rate-Limit: 60 Anfragen pro Minute
• Inhaltstyp: application/json
• Endpunkt: https://api.miliexpress.com/mcp
• Protokollversionen: 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05
  Beide Protokollgenerationen werden über denselben Endpunkt bedient: Clients, die mit einem initialize-Handshake beginnen, und zustandslose Clients, die die Version bei jeder Anfrage angeben. Es wird nie eine Sitzungs-ID vergeben.
• OAuth-Discovery: https://api.miliexpress.com/.well-known/oauth-protected-resource
  Eine nicht authentifizierte Anfrage wird mit 401 beantwortet; der WWW-Authenticate-Header verweist auf das Metadatendokument der geschützten Ressource.