繁體中文（香港）

MCP 伺服器
權杖交換
OAuth

MCP Server 如何代表用戶呼叫你的 API：生產級 token 策略實務

解釋 MCP 伺服器的外發權杖策略：為什麼權杖直通和 M2M 行不通，以及權杖交換如何讓權限和用戶一致。

Yijun

Developer

8/21/2026

Stop wasting weeks on user auth

Launch secure apps faster with Logto. Integrate user auth in minutes, and focus on your core product.

Get started

在上一篇文章裏，我們分享了 Logto 構建 Remote MCP Server 的整體經驗, 這篇文章我們將講解 Remote MCP Server 架構設計和 OAuth 認證流程的實作細節。

以 MCP Server 為分界，Remote MCP Server 的認證分**入站（inbound）和出站（outbound）**兩段：

入站：MCP client（VS Code、Cursor 等）透過 OAuth 登入，拿到 access token，用它存取你的 MCP Server
出站：MCP Server 處理 tool 呼叫時，代表用戶去請求你自己的業務 API

入站這部分，MCP 規範定義得很清楚，社群的討論和實作都很豐富，我們之前寫過一篇實作指南。出站的討論就少多了：MCP Server 手裏只有一張「用於存取 MCP Server」的 token，它要如何代表用戶去呼叫業務 API？

這正是我們在構建 Logto MCP Server 時反覆糾結的問題。Logto Cloud 是典型的 B2B 多租户產品：一個用戶可以屬於多個 tenant，權限由用戶在每個 tenant 裏的角色決定，AI 不僅要代表用戶行事，還要落到正確的 tenant。

這篇文章會沿着我們實際的決策過程展開：

為什麼 MCP Server 要獨立部署，並作為獨立的 protected resource
兩個被我們否決的出站方案（token 透傳、M2M token）以及它們的問題
最終方案 token exchange + subject token 的完整流程，包括多租户場景下 organization token 的處理
做同類設計時需要守住的幾條原則

問題的本質：MCP Server 的雙重身份

在 OAuth 的視角裏，Remote MCP Server 同時扮演兩個角色：

對 MCP client，它是 resource server：client 必須帶着 token 來存取它
對業務 API，它是 client：它要帶着 token 去存取別人

也就是説，MCP Server 在兩側扮演不同的角色，各自對應的是不同的 token：MCP client 透過 OAuth 拿到的 token，audience 是 MCP Server，業務 API 驗證 audience 時會直接拒絕它。

所以出站的本質是一個身份委託（delegation）問題：MCP Server 如何在不持有用戶憑證的前提下，以用戶的身份、在用戶的權限範圍內呼叫下游 API。

架構決策：MCP Server 作為獨立服務

把 MCP endpoint 做進業務 API 服務，共用同一個進程、同一套認證，看起來是最直接的做法。但經過考量，我們還是選擇了獨立部署：

風險隔離：做決策時 MCP 官方 SDK 離 production ready 還有距離，協議本身也在快速演進（transport 從 SSE 到 Streamable HTTP 的切換就是例子）。Logto 是 IAM 服務，登入主流程的可用性是底線。獨立部署下，MCP Server 出問題最多是 AI 入口不可用，主服務不受影響。
獨立迭代：MCP 生態的變化以週計，用户端相容性問題隨時需要緊急修復；核心服務有嚴格的發布流程和迴歸驗證。分開部署，兩邊互不拖累。
執行環境自由：獨立服務可以挑最適合自己的執行環境。Logto MCP Server 跑在 Cloudflare Workers 上，無狀態、依請求擴展、幾乎零運維；內嵌方案裏沒有這個選項。

MCP Server 部署在獨立的網域 mcp.logto.io 下，和主服務之間沒有任何私有耦合，未來想把它開源出去都沒有障礙。

內嵌方案也繞不開 token 問題：MCP endpoint 和業務 API 共享同一個 resource identifier，MCP client 拿到的 token 直接攜帶完整 API 的權限；「這次呼叫以誰的權限執行」從跨服務的 token 交換變成進程內的權限傳遞，問題本身還在。獨立部署要求我們把權限邊界顯式設計出來，這也是這篇文章接下來的內容。

MCP Server 必須有自己的 resource identifier

出站的討論要從一個更基礎的問題開始：MCP client 拿到的 token，audience 應該是誰？

直接複用業務 API 的 resource identifier 是最直接的做法：Logto 的 Management API 本身就是標準的 OAuth protected resource，讓 MCP client 直接申請它的 token，MCP Server 原樣轉發。不少 MCP Server 的早期實作就是這麼做的。

代價在於：如果 MCP token 的 audience 是業務 API，權限邊界就不存在了。

你精心設計的 MCP tools 形同虛設：token 本身就能呼叫完整的 API，不需要經過你的 tools
Token 洩漏的爆炸半徑，從「MCP Server 暴露的幾個受控操作」擴大到「整個 Management API」
MCP 場景的獨立審計、限流、權限收斂，都無從做起

所以我們的第一個決定是：MCP Server 是一個獨立的 protected resource，有自己的 resource identifier（https://mcp.logto.io）和對應的 scope。

這個決定讓權限邊界乾淨了，出站的問題也隨之變得具體：token 只能存取 MCP Server，那 MCP Server 拿什麼去呼叫 API？

下面進入方案演進。

方案一：token 透傳

第一個想法來自一個很自然的類比。

Logto Console 是一個 SPA，它呼叫 Management API 的方式很簡單：用戶在瀏覽器裏 OAuth 登入，拿到 audience 為 Management API 的 token，前端直接帶着它呼叫 API。

那 MCP Server 是不是也可以當作另一種 Console？讓 MCP client 在登入時直接申請業務 API 的 token，MCP Server 不做任何轉換，原樣轉發：

這個方案的誘人之處就在於它極其簡單，MCP Server 只負責轉發 token。但是它有顯而易見的問題：

第一，它和上一節的權限邊界決定直接衝突。 Token 透傳要求 MCP client 持有業務 API 的 token，這正是我們剛剛否決掉的事情。

第二，MCP Server 不再是真正的 protected resource。 它收到的 token audience 不是自己，audience 驗證形同虛設，只能退化成「驗證簽名和 issuer」。這不符合 MCP 規範對 authorization 的定義（MCP Server 應作為 resource server，透過 RFC 9728 的 Protected Resource Metadata 宣告自己），本質上是把一個後端服務偽裝成了瀏覽器裏的 SPA。

第三，MCP client 不配合。 規範的 MCP client 按 Protected Resource Metadata 的指引申請 token，audience 就是 MCP Server。沒有標準的方式讓它去申請業務 API 的 token，這條路在用户端側走不通。

方案二：M2M token

既然不能用用戶的 token，那用 MCP Server 自己的身份呢？

給 MCP Server 建一個 M2M（machine-to-machine）應用程式，用 client credentials 拿 token，去呼叫業務 API。這也是很多內部服務之間的標準做法。

入站認證也順了：MCP client 的 token audience 是 MCP Server，MCP Server 正常驗證，然後用自己的 M2M token 做事。

這個方案的致命缺陷是，M2M token 的權限和用戶的權限沒有任何關係：

權限越界：M2M token 的權限是「MCP Server 能做什麼」，不是「這個用戶能做什麼」。一個唯讀角色的用戶，透過 MCP 卻能刪除應用程式，因為 M2M token 有這個權限
身份遺失：下游 API 看到的呼叫者永遠是那個 M2M 應用程式，審計日誌對不到具體的人
混淆代理人問題（confused deputy）：MCP Server 成了一個高權限代理，任何能説服它發起呼叫的人，都借到了它的權限

M2M 適合排程任務、系統間同步這類沒有用戶上下文的場景。MCP Server 不一樣，每次呼叫都由具體的用戶發起，就應該以這個用戶的身份和權限去執行。

最終方案：token exchange + subject token

前兩個方案的教訓彙總起來，就是理想方案的要求：

MCP client 手裏的 token 只能存取 MCP Server（方案一的教訓）
MCP Server 呼叫下游 API 時，必須以用戶身份、在用戶權限範圍內（方案二的教訓）

這指向一個標準機制：token exchange（RFC 8693）。MCP Server 拿一張代表用戶的憑證去 auth server 交換下游 API 的 token，用戶的身份和權限在交換中保留。

在 Logto 裏，這張「代表用戶的憑證」由 user impersonation 能力提供：subject token。它是伺服器端為指定用戶申請的短期憑證，語義是「接下來這次 token exchange，以這個用戶的身份進行」。用戶不需要手動建立或設定任何東西，全程自動化；subject token 短期、一次性，用完即失效。

整個架構裏有四個角色，MCP Server 獨立部署在 mcp.logto.io：

一次 tool 呼叫背後的完整 token 流轉：

逐步拆解：

① 入站驗證。MCP client 帶着 user token 呼叫 tool。這個 token 的 audience 是 MCP Server 自己的 resource identifier，scope 是 mcp:all。MCP Server 驗證簽名、issuer、audience、scope，拿到用戶身份。入站到此為止，這個 token 不會再往下游走。

② 服務身份認證。MCP Server 用自己的 M2M 憑證換一個 access token，scope 是專設的 access:mcp:api，它只有一個用途：呼叫下一步的專用介面。

③ 申請 subject token，整條流程的關鍵一步。MCP Server 呼叫 Cloud 專門為 MCP 開的介面 POST /api/mcp/subject-tokens，同時出示兩個憑證：

Authorization 標頭：M2M token，證明「我是官方 MCP Server」
x-mcp-user-token 標頭：用戶的 user token，證明「這個用戶確實授權過我，且授權仍然有效」

Cloud 這邊會對 user token 做完整驗證：簽名、issuer、有效期限，audience 必須是 MCP Server 的 resource identifier，scope 必須包含 mcp:all。驗證通過後，userId 直接取自 user token 的 sub claim，介面沒有「指定用戶」的參數。

這樣設計是為了防止 M2M 憑證被濫用：如果介面接受任意 userId，拿到 M2M 憑證就能冒充任何用戶；在這個設計下，MCP Server 只有在某個用戶的有效授權在場時，才能為這個用戶兑換憑證。

簽發出來的 subject token 短期、一次性，實作裏不做快取，每次使用都現場申請。

④ 換出工作用的 token。拿 subject token 走標準 token exchange，視需要換兩種 token：

Cloud API token：以用戶身份做用戶級操作，例如列出 tenant、建立 tenant
org token：指定目標 tenant（Logto Cloud 裏每個 tenant 對應一個 organization），換到的 token 以用戶身份簽發，權限嚴格等於用戶在該 tenant 裏的角色

⑤ 出站呼叫。帶着換來的 token 呼叫業務 API，做完事把結果返回給 MCP client。

多租户的 tenant 上下文也在交換這一步解決：tenant 不在連線層，而在交換層。list_tenants 用 Cloud API token 列出選項，用戶在對話裏選一個，MCP Server 再為選中的 tenant 換 org token。一個 endpoint 服務所有 tenant，不需要為每個 tenant 單獨部署，對話中途新建的 tenant 也即刻可用。

為什麼説這套流程是對的

把前面每個方案的失敗點拿回來對照，會發現它們都被逐一堵上了：

user token 的爆炸半徑受控（方案一的教訓）：它的 audience 只有 MCP Server，洩漏了也只能調那幾個受控的 tools
M2M 無法被濫用（方案二的教訓）：M2M token 不再直接呼叫業務 API，只用來證明服務身份。簽發 subject token 時必須同時出示該用戶的有效 user token，MCP Server 只能為授權過它的用戶換取憑證，confused deputy 問題就不存在了
沒有任何用戶憑證需要保管：subject token 現場申請、用完即棄，MCP Server 除了自己的 M2M 憑證，不存任何東西
撤銷是聯動的：用戶撤銷對 MCP 的授權，user token 隨之失效，x-mcp-user-token 驗證失敗，出站流程當場斷掉
權限對齊用戶本人：換出的 token 以用戶身份簽發，唯讀用戶透過 MCP 還是唯讀，越權在 auth server 層面就不成立；審計日誌裏看到的也是真實的用戶身份

回頭看，M2M 在最終方案裏有了正確的分工：它負責證明「我是誰」，而「以用戶身份行事」的資格，必須由用戶的有效授權當場兑換。

結語

回顧整條流程，Remote MCP Server 的 token 策略可以歸納成幾條：

入站和出站是兩段獨立的認證，MCP token 的 audience 必須是 MCP Server 自己
出站用 token exchange 解決：auth server 支援拿入站 token 直接交換的，標準 token exchange 就夠了；不支援的（例如 Logto 的 token exchange 需要 subject token 作為輸入），用 impersonation 類能力由伺服器端發起交換
多租户不影響機制的選擇，organization 上下文是交換時的一個參數，單租户產品不傳這個參數就可以了
AI 代表用戶做事，下游 token 的權限必須收斂到用戶本人

一個簡單的檢驗方法：假設 MCP client 手裏的 token 洩漏，攻擊者能做的應該只有「呼叫 MCP Server 上那幾個受控的 tools，且仍受用戶權限約束」。如果能直接呼叫到完整的 API，表示權限邊界有問題。

MCP 生態還在快速演進，入站認證已經被規範覆蓋得很好，「MCP Server 如何呼叫下游」目前還是各家自己發揮的地帶。希望我們的實務經驗能給你一些參考。

如果你在給自己的產品做 MCP Server，可以看看 Logto 為 AI 場景提供的完整方案：Auth for AI apps, agents, and MCP servers。想看這套 token 流程的實際效果，可以直接連線 Logto MCP Server 體驗。

文中涉及的技術文件：

問題的本質：MCP Server 的雙重身份#

架構決策：MCP Server 作為獨立服務#

MCP Server 必須有自己的 resource identifier#

方案一：token 透傳#

方案二：M2M token#

最終方案：token exchange + subject token#

為什麼説這套流程是對的#

結語#

問題的本質：MCP Server 的雙重身份#

架構決策：MCP Server 作為獨立服務#

MCP Server 必須有自己的 resource identifier#

方案一：token 透傳#

方案二：M2M token#

最終方案：token exchange + subject token#

為什麼説這套流程是對的#

結語#

問題的本質：MCP Server 的雙重身份

架構決策：MCP Server 作為獨立服務

MCP Server 必須有自己的 resource identifier

方案一：token 透傳

方案二：M2M token

最終方案：token exchange + subject token

為什麼説這套流程是對的

結語

問題的本質：MCP Server 的雙重身份

架構決策：MCP Server 作為獨立服務

MCP Server 必須有自己的 resource identifier

方案一：token 透傳

方案二：M2M token

最終方案：token exchange + subject token

為什麼説這套流程是對的

結語