Leo
894408181f
判斷一台實例的 arcrun-mcp 是哪一代認證，原本只能打 /authorize 剖 HTML 有幾個欄位 （ops-facts 2026-08-10 的土法）。改成誠實版本面：200+auth=portal-login ＝新世代； 404 ＝舊世代（同意頁還要那把沒人拿得到的 MCP_OWNER_SECRET ⇒ 等於接不上）。 順帶 build 標記（MCP_BUILD var）讓「這台跑的是哪一版」看得到。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
50 lines
3.1 KiB
TypeScript
50 lines
3.1 KiB
TypeScript
export interface Env {
|
||
COMPONENT_REGISTRY: Fetcher;
|
||
CYPHER_EXECUTOR: Fetcher;
|
||
KBDB: Fetcher;
|
||
KBDB_INTERNAL_TOKEN: string;
|
||
API_KEY?: string;
|
||
// Platform telemetry / feedback aggregation key (optional)
|
||
// 對應 arcrun SDD .agents/specs/llm-interface/ M1.2-1.3
|
||
// 設了會把 agent-feedback / agent-telemetry block 都寫到 platform user_id 下；
|
||
// 沒設則 fallback 寫進 user 自己的 namespace
|
||
PLATFORM_API_KEY?: string;
|
||
// Self-hosted 單租戶模式旗標（與 cypher-executor 同名同義）。
|
||
// "false" = self-hosted：Bearer 帶的是 namespace 明碼（非平台 partner key），
|
||
// 不打 KBDB partner 驗證，直接當 org_namespace（對齊 cypher 的 opaque-key 模型）。
|
||
// 未設 / "true" = 官方 SaaS：維持 partner-key 驗證（行為完全不變）。
|
||
// SDD: sdk-and-website/mcp-account-source.md；HANDOFF §3b。
|
||
MULTI_TENANT?: string;
|
||
|
||
// ── OAuth 2.1 server（claude.ai 遠端 connector 安全登入，見 mcp/OAUTH.md）──────────
|
||
// 短效認證儲存：authorization code（TTL ~600s）+ access token（TTL = MCP_TOKEN_TTL）。
|
||
// 只放「取得的暫時性認證」，key 用 SHA-256 hash（KV list 不外洩可用 token）。長效機密不進 KV。
|
||
OAUTH_KV?: KVNamespace;
|
||
// Owner 祕密（CF Secret，非 KV、非明碼 var）：/authorize 同意頁的把關密碼。
|
||
// 只有 owner 知道 → 「只知 URL + 明碼 namespace」的人走不完 OAuth，拿不到 token。
|
||
// 未設 → OAuth /authorize 回 503（拒絕在無把關下發碼，不留不安全預設）。
|
||
MCP_OWNER_SECRET?: string;
|
||
// OAuth 換發出的 access_token 綁定的 namespace（owner 的資料分區）。預設 "leo"。
|
||
MCP_OWNER_NAMESPACE?: string;
|
||
// access_token 存活秒數（同時是 KV TTL）。字串（toml var）。預設 2592000（30 天）。
|
||
// 過期後 claude.ai 重走 OAuth（owner 重輸祕密）——刻意不做 refresh token 以免長效機密落地。
|
||
MCP_TOKEN_TTL?: string;
|
||
// 本機 CLI / GUI / 本機 Claude Code 的相容用「真祕密 token」（CF Secret）。
|
||
// 設了才啟用：Bearer 精確等於此值 → 解成 MCP_OWNER_NAMESPACE。取代舊「明碼 namespace 當 bearer」漏洞路徑。
|
||
MCP_STATIC_TOKEN?: string;
|
||
// 【不安全】相容逃生門：="true" 時恢復舊「Bearer 明碼即 namespace」行為（self-hosted）。
|
||
// 預設 undefined = 關（安全）。僅供遷移期，設了等於重新打開被修掉的漏洞——別在正式環境開。
|
||
ALLOW_PLAINTEXT_NAMESPACE?: string;
|
||
// 允許的 redirect_uri host 白名單（逗號分隔）。DCR 無狀態故靠此擋 open-redirect/釣魚。
|
||
// 未設 → 預設只允許 claude.ai / claude.com / anthropic.com（含子網域）＋ localhost。
|
||
MCP_ALLOWED_REDIRECT_HOSTS?: string;
|
||
// 部署標記（非機密）：GET /health 原樣回報，讓「這台跑的是哪一版」用一條 curl 看得到。
|
||
// 由各實例的 wrangler toml [vars] 帶入；沒帶 → /health 回 build:"unknown"（誠實，不假裝）。
|
||
MCP_BUILD?: string;
|
||
}
|
||
|
||
export interface ToolContext {
|
||
env: Env;
|
||
orgNamespace: string;
|
||
}
|