MCP 專欄

MCP 專欄概覽

本指南是開發者中心的 Superroute MCP 專欄，涵蓋兩個伺服器、代理安全模型，以及來自 UserMcpToolCatalog 的即時工具目錄。

• User MCP — 供營運/客服代理管理訂單、路線、託運單與日報 — https://api.superlabel.ca/mcp
• Developer MCP — 面向整合開發者的指南、Webhook 與打單/建線示例 API — https://api.superlabel.ca/mcp/developer
• 安全：連線級 Bearer、X-MCP-Profile/scopes、高風險工具 confirm
• 人工審批佇列（propose_write + /mcp-approvals 介面）

什麼是 MCP？

模型上下文協議（MCP）是一種開放標準，允許 Claude、Cursor 和 ChatGPT 等 AI 助手與外部工具和服務互動。它使您的 AI 能夠在對話中直接執行實際操作，例如追蹤包裹。

透過設定 Superroute MCP 伺服器，您的 AI 助手無需離開工作流程即可使用物流工具。

兩個 MCP 伺服器

依受眾選擇正確的伺服器。不要給無人值守代理使用具完整權限的 Developer 伺服器。

快速開始

包裹追蹤等公開工具無需驗證即可使用。將以下設定加入您的 MCP 客戶端：

{
  "mcpServers": {
    "super-label": {
      "type": "url",
      "url": "https://api.superlabel.ca/mcp"
    }
  }
}

驗證存取

要使用需要使用者權限的工具，請在設定中加入您的 API Bearer 權杖：

務必把權杖放在 MCP 連線標頭，切勿寫入工具參數或提示詞。

{
  "mcpServers": {
    "super-label": {
      "type": "url",
      "url": "https://api.superlabel.ca/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-token>",
        "X-MCP-Profile": "ops-readonly"
      }
    }
  }
}

如何取得 API 權杖

使用您的憑證呼叫登入端點：

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

回應將包含您的存取權杖：

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

在 MCP 設定的 Authorization 標頭中使用 access_token 值。

代理安全模型

User MCP 面向最小權限代理。建立 token 時選擇 MCP 設定檔（預設營運唯讀），或透過 header 傳遞 profile/scopes。

設定檔（X-MCP-Profile）

命名的權限包。無人值守代理優先 ops-readonly 或 support。

{
  "mcpServers": {
    "super-label": {
      "type": "url",
      "url": "https://api.superlabel.ca/mcp",
      "headers": {
        "Authorization": "Bearer <ops-readonly-token>",
        "X-MCP-Profile": "ops-readonly"
      }
    }
  }
}

可選請求頭

高風險確認

以下工具在 tools/call 時需要 confirm=true（或使用審批佇列）：

• cancel_order
• bulk_create_orders
• reroute_to_address
• build_route
• hold_order
• release_order
• approve_pending_write

人工審批佇列

無人值守代理應提議寫入；由人在應用內或透過 MCP 批准。

1. 代理：propose_write 或發送 X-MCP-Require-Approval: 1
2. 人：開啟 Web 的 MCP 審批，或 list_pending_approvals
3. 人：approve_pending_write（confirm=true）或 reject_pending_write

Web 介面路徑（需登入）： /mcp-approvals

Developer MCP 驗證

優先在連線使用 Authorization: Bearer。依工具傳 api_token 已棄用，將於 2026-12-31 後硬切斷。

可用工具

以下工具目前在 MCP 伺服器上可用： 47 個來自伺服器目錄的即時工具

此表在請求時由 UserMcpToolCatalog 產生，與生產環境認證全量 tools/list 保持同步。

客戶端設定

選擇您的 AI 客戶端以取得相應的設定說明：

{
  "mcpServers": {
    "super-label": {
      "type": "url",
      "url": "https://api.superlabel.ca/mcp"
    }
  }
}

{
  "mcpServers": {
    "super-label": {
      "type": "url",
      "url": "https://api.superlabel.ca/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-token>",
        "X-MCP-Profile": "ops-readonly"
      }
    }
  }
}

{
  "mcpServers": {
    "super-label": {
      "type": "url",
      "url": "https://api.superlabel.ca/mcp"
    }
  }
}

{
  "mcpServers": {
    "super-label": {
      "serverUrl": "https://api.superlabel.ca/mcp"
    }
  }
}

技術細節

• 協議: JSON-RPC 2.0
• 傳輸方式: HTTP POST (Streamable HTTP)
• 速率限制: 每分鐘 60 次請求
• 內容類型: application/json
• 端點: https://api.superlabel.ca/mcp
• 協定版本: 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05
  同一端點同時服務兩代協定：以 initialize 交握開始的用戶端，以及在每個請求中宣告版本的無狀態用戶端。伺服器從不簽發工作階段 ID。
• OAuth 探索: https://api.superlabel.ca/.well-known/oauth-protected-resource
  未經驗證的請求會回傳 401，並在 WWW-Authenticate 標頭中指出受保護資源中繼資料文件的位址。