本頁面由英文在 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 資料列包含:
| 資料行 | 描述 |
|---|---|
provider | Provider 名稱。 |
auth_type | 為該 Provider 設定的驗證類型。 |
sourced_from | 憑證的解析來源,例如 env:OKTA_SECRET_KEY、file:/path/key.json、inline 或 none。 |
status | ok、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.