跳至主要内容

服務憑據

Settings → Credentials 為實際發起請求的服務配置憑據。Codex 訂閱提供模型訪問,不提供 OpenAlex、GitHub 或自定義 MCP 賬號。

內建服務

服務欄位與用途驗證方式
GitHubSkill 發現/匯入用 Personal access tokenConnect/Manage 後使用目標倉庫操作驗證
Literature access聯絡郵箱及可選 NCBI API key儲存真實聯絡資訊;支援的 NCBI 請求中金鑰可選
OpenAlexLiterature 中 OpenAlex 操作的 API keyValidate、儲存,再執行小查詢
Unpaywall查詢全文位置所需聯絡郵箱使用文獻聯絡郵箱,不填寫虛構地址

Connect 開啟未配置服務,Manage 管理已有配置,Desktop only 表示需要桌面環境。已儲存標記不是金鑰明文。

補充缺失的 OpenAlex 金鑰

  1. 未配置金鑰時請求 OpenAlex 查詢。
  2. 對話出現 Add your OpenAlex API keyAPI key 輸入框。
  3. Save key 成功儲存後繼續等待中的呼叫;Not now 保持未配置。
  4. 檢查最終狀態。選擇 Not now 可返回 credential_required;配置金鑰後再重試。

英文應用中的 OpenAlex 憑據請求

介面說明金鑰在本機加密並只傳送到 api.openalex.org。Settings 表單另有 Validate、Save、Remove key(已有金鑰時)和 Cancel。替換欄位不顯示舊金鑰;安全儲存不可用時需先解決系統鑰匙串狀態。

自定義 Connector 憑據

在此建立憑據,再到 Connector 配置選擇其名稱。修改或移除共享憑據前先核對使用者。

New credential 表單

欄位或按鈕操作
Name為憑據設定便於識別的本地名稱
Type選擇 API keyAccess tokenOAuth
Valuekey/token 的遮罩輸入框;必填項為空時 Save 禁用
OAuth → Resource URL填寫準確資源地址,Connector 按資源 URL、傳輸方式和註冊配置匹配
Advanced → Transport選擇服務要求的傳輸方式,當前預設是 Streamable HTTP
Scopes用空格或逗號分隔作用域
Use a pre-registered client展開 Authorization server URLClient IDCallback URLClient secret
Callback URL / Copy當前預設 http://127.0.0.1/oauth/callback,可複製用於服務註冊,也可展開自定義回撥選項
Discovery適用時發現伺服器後設資料;發現成功本身不是登入成功
Cancel / Save放棄草稿或儲存有效配置

OAuth 高階註冊欄位

在自定義 Connector 中,將命名憑據繫結到請求頭、環境變數或 OAuth 選擇器。名稱用於引用,不應把金鑰放進描述或專案指令。匯出的可移植配置以佔位符替換金鑰;儲存憑據後仍需實際服務測試才能確認可用。

驗證與排錯

儲存後執行一次小範圍操作,讀取實際響應。credential_required 表示缺少已配置憑據;401 需檢查認證,403 需檢查權限/策略,不能一律靠換金鑰解決。429 涉及限流或用量。保留服務正文,參見排錯

移除憑據可能影響所有繫結的 Connector。Connector 和 Specialist 匯出不會攜帶現成金鑰/信任,接收端應重新配置。不要將金鑰寫入 Skill、提示詞、截圖或 issue。

OpenAlex 查詢需要有效的 OpenAlex 金鑰;OAuth Connector 需要完成對應服務登入。處理顯示的認證錯誤後,再重試同一小請求。

實現依據: CredentialsPanel.tsx, ConnectorAddForm.tsx

可透過本地認證的 CLI/SDK 憑據管理建立/更新共享憑據。Linux headless 可顯式選擇未加密檔案儲存,桌面憑據仍遵循正常 OS 儲存行為;此選項不解決 Compute 密碼儲存,也不發起首次 OAuth 登入。