MCP 驗證

/mcp 端點需要在 Authorization 標頭中提供 Bearer 權杖。MCP 用戶端會透過 OAuth 2.1 PKCE 流程自動取得權杖，你無需建立、貼上或輪替任何 API 金鑰。你也可以為了測試而手動提供權杖。

OAuth 2.1 PKCE 流程

Flowstep 在 https://api.flowstep.ai 運行自己的 OAuth 2.1 授權伺服器。MCP 用戶端會自動探索並完成流程：它們會開啟瀏覽器視窗，讓你登入並核准存取權，接著在背後處理權杖交換。用戶端可以自行動態註冊，因此你不需要事先設定用戶端 ID。

支援的登入方式

/oauth/authorize 的授權頁面支援：

Email/password — 任何已設定密碼的 Flowstep 帳號
Google SSO — 透過 Supabase 社群驗證進行重新導向，完成後自動返回用戶端

檢視並核准存取

登入後，Flowstep 會在發出權杖前顯示一個授權畫面。未經你明確核准，任何用戶端都無法完成連接。此畫面的標題為 Authorize access，會列出請求存取的用戶端名稱（名稱以粗體顯示，後接 “is requesting access to your Flowstep account”（正在請求存取你的 Flowstep 帳號）），然後顯示 You’ll be redirected to 以及目的地主機。選擇 Allow 完成連接，或選擇 Deny 取消。拒絕會讓用戶端收到 access_denied 錯誤，且不會發出任何權杖。

用戶端名稱是由註冊該用戶端的人所設定，因此請將它視為標籤，而非身分證明。在你點擊 Allow 之前，請確認 You’ll be redirected to 下方的主機，是你預期用於該用戶端的主機。

claude.ai 連接器用戶的帳號建立

OAuth 登入頁面不包含註冊表單。如果你是從 Claude 的連接器目錄新增 Flowstep 連接器，且尚未擁有 Flowstep 帳號，請先在 app.flowstep.ai 建立帳號，然後返回 Claude 完成連接。如果請求中沒有 Authorization 標頭，中介軟體會退回使用以 Cookie 為基礎的 Supabase 工作階段。當你在已登入 Flowstep 的瀏覽器中直接存取 /mcp 時，此方式即可運作。MCP 用戶端一律使用 Bearer 路徑。

手動權杖（測試用）

要在不經過用戶端 OAuth 流程的情況下直接呼叫端點：

在瀏覽器中登入 app.flowstep.ai
開啟 DevTools → Console，執行：

const pairs = document.cookie.split("; ").map((c) => {
  const i = c.indexOf("=");
  return [c.slice(0, i), c.slice(i + 1)];
});
const authPairs = pairs
  .filter(([k]) => /^sb-.+-auth-token(\.\d+)?$/.test(k))
  .sort(([a], [b]) => a.localeCompare(b));
const raw = authPairs.map(([, v]) => decodeURIComponent(v)).join("");
const session = JSON.parse(
  raw.startsWith("base64-") ? atob(raw.slice(7)) : raw,
);
console.log(session.access_token);

將權杖以標頭形式傳入：

curl -X POST https://api.flowstep.ai/mcp \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

MCP 工作階段有效期為 30 天——伺服器會透明地更新底層權杖，因此使用 OAuth 流程的用戶端在一般使用時無需重新驗證。像上面這樣手動擷取的權杖，約一小時後即會過期，僅適用於快速測試。

快速開始

使用 Flowstep

團隊與組織

匯出與整合

MCP 伺服器

計費與方案

安全與隱私

OAuth 2.1 PKCE 流程

支援的登入方式

檢視並核准存取

claude.ai 連接器用戶的帳號建立

手動權杖（測試用）

​OAuth 2.1 PKCE 流程

​支援的登入方式

​檢視並核准存取

​claude.ai 連接器用戶的帳號建立

​Cookie 備援機制

​手動權杖（測試用）

OAuth 2.1 PKCE 流程

支援的登入方式

檢視並核准存取

claude.ai 連接器用戶的帳號建立

Cookie 備援機制

手動權杖（測試用）