reload_credentials

--env.file フラグで指定された dotenv 形式のファイルをサーバーのプロセス環境に再度読み込み、プロバイダーごとの認証情報の解決状況を報告します。これにより、環境が起動時に固定されるという問題が解決します。セッションの途中でディスク上に書き込まれた認証情報やローテーションされた認証情報が、再起動なしで実行中のサーバーに反映されます。

env ファイルはプロセス環境を置き換えるのではなく、その上に重ねて適用されます。認証情報の解決では、常にリクエスト時点のプロセス環境が読み取られます。そのため、起動時にすでに存在する変数（シェルまたはクライアントの env ブロックからのもの）は、--env.file の有無にかかわらず引き続き機能します。再読み込み時には、ファイル内にあって値が空でないキーだけが書き込まれ、設定が解除される変数はありません。そのため、再読み込みが失敗したり一部だけ完了したりしても、それまで機能していた認証情報は保持されます。

シークレットの値が返されたり、ログや監査に記録されたりすることはありません。このツールが報告するのは変数名と状態だけです。--env.file が設定されていない場合、このツールは単なる状態チェックとして動作します。クエリが認証情報の解決で失敗すると、MCP エラーには reload_credentials を呼び出して再試行するようエージェントに指示するヒントが含まれます。そのため、エージェント型のクライアントは自己修復できます。

注記

StackQL v0.10.542 より後のリリースで利用できます。

入力

引数	必須	説明
`provider`	いいえ	状態レポートの対象を 1 つのプロバイダーに限定します。省略した場合は、すべてのプロバイダーが報告されます。

出力

レンダラー	形状
テーブル	env ファイルの読み込み結果と、プロバイダーごとに 1 行の認証情報の解決状況

構造化ペイロードには次のものが含まれます：

フィールド	説明
`env_file`	設定された `--env.file` のパス（設定されていない場合は空）。
`env_file_sourced`	この呼び出しでファイルが見つかり、読み込まれた場合は `true`。
`sourced_vars`	ファイルから設定された環境変数の名前（名前のみで、値は含まれません）。
`providers`	プロバイダーごとに 1 行（以下を参照）。

providers の各行には次の列があります：

列	説明
`provider`	プロバイダー名。
`auth_type`	プロバイダーに設定された認証タイプ。
`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.

入力​

出力​

ゲート制御​

例​

入力

出力

ゲート制御

例