MCP rovat

MCP rovat áttekintés

Ez az útmutató a Superroute MCP rovat a Developer Centerben: mindkét szerver, ügynökbiztonság és élő eszközkatalógus.

• User MCP — megrendelések, útvonalak, címkék, digeszt ops/support ügynököknek — https://api.miliexpress.com/mcp
• Developer MCP — útmutatók, webhookok és minta API-k integrátoroknak — https://api.miliexpress.com/mcp/developer
• Biztonság: connection Bearer, profilok/scope-ok, confirm magas kockázatú tooloknál
• Emberi jóváhagyási sor (propose_write + /mcp-approvals)

Mi az MCP?

A Model Context Protocol (MCP) egy nyílt szabvány, amely lehetővé teszi az AI asszisztensek, mint a Claude, Cursor és ChatGPT számára, hogy külső eszközökkel és szolgáltatásokkal kommunikáljanak. Lehetővé teszi az AI számára valós műveletek végrehajtását — például csomag követését — közvetlenül a beszélgetésben.

A Superroute MCP szerver konfigurálásával AI asszisztense hozzáférhet a logisztikai eszközökhöz anélkül, hogy elhagyná a munkafolyamatát.

Két MCP szerver

A megfelelő szervert válassza. Ne adjon felügyelet nélküli ügynököknek teljes hozzáférésű Developer szervert.

Gyors indulás

A nyilvános eszközök, mint a csomagkövetés, hitelesítés nélkül működnek. Adja hozzá ezt a konfigurációt az MCP klienshez:

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

Hitelesített hozzáférés

A felhasználói jogosultságokat igénylő eszközök használatához adja hozzá API Bearer tokenjét a konfigurációhoz:

A tokeneket mindig az MCP kapcsolat fejléceibe tegye — soha ne tool argumentumokba vagy promptokba.

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

Hogyan szerezhet API tokent

Hívja meg a bejelentkezési végpontot a hitelesítő adataival:

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

A válasz tartalmazza a hozzáférési tokent:

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

Használja az access_token értéket az MCP konfiguráció Authorization fejlécében.

Ügynök-biztonsági modell

A User MCP least privilege ügynökökre épül. Token MCP profillal (alap: ops csak olvasható) vagy headerekkel.

Profilok (X-MCP-Profile)

Elnevezett scope csomagok. Felügyelet nélküli ügynökökhöz ops-readonly vagy support.

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

Opcionális headerek

Magas kockázatú megerősítés

Ezek a toolok confirm=true-t igényelnek tools/call-nál (vagy a jóváhagyási sort):

• 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

Emberi jóváhagyási sor

Felügyelet nélküli ügynökök javasoljanak írásokat; ember hagyja jóvá.

1. Ügynök: propose_write vagy X-MCP-Require-Approval: 1
2. Ember: MCP Approvals az appban vagy list_pending_approvals
3. Ember: approve_pending_write confirm=true-val vagy reject_pending_write

Web UI útvonal (bejelentkezés szükséges): /mcp-approvals

Developer MCP hitelesítés

Preferálja az Authorization: Bearer-t a kapcsolaton. A tool api_token elavult, 2026-12-31 után megszűnik.

Elérhető eszközök

Az alábbi eszközök jelenleg elérhetők az MCP szerveren: 93 élő tool a szerverkatalógusból

Ez a tábla futásidőben a UserMcpToolCatalogból jön, és szinkronban marad a tools/list-tel.

Kliens-specifikus beállítás

Válassza ki az AI kliensét az alábbiak közül a testreszabott beállítási utasításokhoz:

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

Technikai részletek

• Protokoll: JSON-RPC 2.0
• Szállítás: HTTP POST (Streamable HTTP)
• Sebességkorlát: 60 kérés percenként
• Tartalomtípus: application/json
• Végpont: https://api.miliexpress.com/mcp
• Protokollverziók: 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05
  Mindkét protokollgeneráció ugyanazon a végponton érhető el: az initialize kézfogással induló kliensek és az állapotmentes kliensek, amelyek minden kérésben megadják a verziót. A kiszolgáló soha nem ad ki munkamenet-azonosítót.
• OAuth-felderítés: https://api.miliexpress.com/.well-known/oauth-protected-resource
  A hitelesítés nélküli kérésre 401 a válasz, a WWW-Authenticate fejléc pedig a védett erőforrás metaadat-dokumentumára mutat.