MCP kolumna

Pregled MCP kolumne

Ovaj vodič je Superroute MCP kolumna u Developer Centeru: oba servera, bezbednost agenata i live katalog alata.

• User MCP — porudžbine, rute, nalepnice, digesti za ops/support agente — https://api.miliexpress.com/mcp
• Developer MCP — vodiči, webhook-ovi i primer API-ja za integratore — https://api.miliexpress.com/mcp/developer
• Bezbednost: connection Bearer, profili/scopes, confirm za high-risk alate
• Red za ljudsko odobrenje (propose_write + /mcp-approvals)

Šta je MCP?

Model Context Protocol (MCP) je otvoreni standard koji omogućava AI asistentima kao što su Claude, Cursor i ChatGPT da komuniciraju sa spoljnim alatima i servisima. Omogućava vašem AI da izvršava stvarne radnje — kao što je praćenje paketa — direktno u razgovoru.

Konfigurisanjem Superroute MCP servera, vaš AI asistent dobija pristup logističkim alatima bez napuštanja radnog toka.

Dva MCP servera

Koristite pravi server. Ne dajte nenadgledanim agentima Developer server sa punim pristupom.

Brzi početak

Javni alati poput praćenja paketa rade bez autentifikacije. Dodajte ovu konfiguraciju svom MCP klijentu:

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

Autentifikovan pristup

Da biste koristili alate koji zahtevaju korisničke dozvole, dodajte svoj API Bearer token u konfiguraciju:

Tokene stavljajte samo u MCP connection headere — nikad u argumente alata ili promptove.

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

Kako dobiti API token

Pozovite endpoint za prijavu sa vašim akreditivima:

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

Odgovor će sadržati vaš pristupni token:

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

Koristite vrednost access_token u Authorization zaglavlju vaše MCP konfiguracije.

Model bezbednosti agenata

User MCP je za least privilege. Kreirajte tokene sa MCP profilom (podrazumevano ops samo čitanje) ili pošaljite headere.

Profili (X-MCP-Profile)

Imenovani scope paketi. Preferirajte ops-readonly ili support za nenadgledane agente.

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

Opcioni headeri

High-risk potvrda

Ovi alati zahtevaju confirm=true na tools/call (ili red odobrenja):

• 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

Red za ljudsko odobrenje

Nenadgledani agenti predlažu upise; ljudi odobravaju.

1. Agent: propose_write ili X-MCP-Require-Approval: 1
2. Čovek: MCP Approvals u aplikaciji ili list_pending_approvals
3. Čovek: approve_pending_write sa confirm=true ili reject_pending_write

Putanja Web UI (potrebna prijava): /mcp-approvals

Developer MCP autentifikacija

Preferirajte Authorization: Bearer na vezi. api_token po alatu je zastareo i seče se posle 2026-12-31.

Dostupni alati

Sledeći alati su trenutno dostupni na MCP serveru: 93 live alata iz serverskog kataloga

Ova tabela se generiše iz UserMcpToolCatalog u runtime-u i ostaje usklađena sa tools/list.

Podešavanje po klijentu

Izaberite svog AI klijenta ispod za prilagođena uputstva za podešavanje:

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

Tehnički detalji

• Protokol: JSON-RPC 2.0
• Транспорт: HTTP POST (Streamable HTTP)
• Ograničenje brzine: 60 zahteva u minuti
• Tip sadržaja: application/json
• Крајња тачка: https://api.miliexpress.com/mcp
• Verzije protokola: 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05
  Obe generacije protokola opslužuju se na istoj krajnjoj tački: klijenti koji počinju initialize rukovanjem i klijenti bez stanja koji verziju navode u svakom zahtevu. Server nikada ne izdaje identifikator sesije.
• OAuth otkrivanje: https://api.miliexpress.com/.well-known/oauth-protected-resource
  Neautentifikovani zahtev vraća 401 sa WWW-Authenticate zaglavljem koje upućuje na dokument metapodataka zaštićenog resursa.