跳至主要內容
翻譯頁面

本頁面由英文在 AI 協助下翻譯而成。若兩者有出入,請以英文版本為準。

reload_credentials

將 --env.file 旗標所指定的 dotenv 格式檔案重新載入伺服器的處理程序環境,然後回報每個 Provider 的憑證解析狀態。這解決了環境在啟動時即固定的問題:在工作階段期間於磁碟上寫入或輪替的憑證,不需重新啟動即可送達執行中的伺服器。

env 檔案會疊加在處理程序環境之上,而不是取代它:憑證解析一律在要求時讀取即時的處理程序環境,因此啟動時已存在的變數(來自 shell 或用戶端的 env 區塊)無論是否使用 --env.file 都能繼續運作。重新載入時,只會寫入檔案中存在且值不為空的鍵,且絕不會取消設定任何變數,因此重新載入失敗或只完成一部分時,先前可用的憑證都會保留。

祕密值絕不會被傳回、記錄或稽核;此工具只回報變數名稱與狀態。未設定 --env.file 時,此工具會降級為單純的狀態探查。當查詢因憑證解析失敗時,MCP 錯誤會附帶提示資訊,指示代理程式呼叫 reload_credentials 並重試,讓代理式用戶端能夠自我修復。

備註

適用於 v0.10.542 之後的 StackQL 發行版本。

另請參閱: [ MCP 概觀 ] [ 憑證(重新)載入 ] [ server_info ] [ Claude Desktop ]


輸入​

引數必要描述
provider否將狀態報告的範圍限定為單一 Provider。省略時,會回報所有 Provider。

輸出​

轉譯器結構
表格env 檔案的載入結果,加上每個 Provider 一個資料列的憑證解析狀態

結構化承載包含:

欄位描述
env_file所設定的 --env.file 路徑(未設定時為空)。
env_file_sourced在此次呼叫中找到並載入該檔案時為 true。
sourced_vars從檔案設定的環境變數名稱:只有名稱,絕不包含值。
providers每個 Provider 一個資料列(請參閱下方)。

每個 providers 資料列包含:

資料行描述
providerProvider 名稱。
auth_type為該 Provider 設定的驗證類型。
sourced_from憑證的解析來源,例如 env:OKTA_SECRET_KEY、file:/path/key.json、inline 或 none。
statusok、unresolved 或 not_checked。
detail為 unresolved 時的錯誤文字。

在憑證位元組路徑之外進行驗證的驗證類型(互動式 gcloud、azure CLI、oauth2 用戶端憑證、擔任角色鏈、OCI 簽署、null)會回報 not_checked。


管控​

在所有伺服器模式中皆允許,包括 read_only:此工具除了伺服器自身的處理程序環境之外,不會變更任何內容。

不支援 reverse_proxy 後端模式:查詢會在遠端 stackql 伺服器處理程序中執行,因此此工具會傳回錯誤,指示使用者在後端伺服器上重新載入憑證。


範例​

請在任何已註冊 StackQL MCP 伺服器(以 --env.file 啟動)的 MCP 用戶端中試用以下提示詞:

My okta query failed with a credential error - I've just written the key
to the credentials file. Reload credentials and retry the query.