Lewati ke konten utama
Halaman terjemahan

Halaman ini diterjemahkan dari bahasa Inggris dengan bantuan AI. Jika keduanya berbeda, versi bahasa Inggris menjadi acuannya.

reload_credentials

Memuat ulang file bergaya dotenv yang ditunjuk oleh flag --env.file ke lingkungan proses server, lalu melaporkan status resolusi kredensial untuk setiap provider. Ini mengatasi masalah lingkungan yang sudah tetap sejak proses dimulai: kredensial yang ditulis atau dirotasi di disk di tengah sesi sampai ke server yang sedang berjalan tanpa perlu memulai ulang server.

File env melapisi lingkungan proses alih-alih menggantikannya: resolusi kredensial selalu membaca lingkungan proses yang aktif pada saat permintaan, sehingga variabel yang sudah ada saat proses dimulai (dari shell atau blok env milik klien) tetap berfungsi dengan atau tanpa --env.file. Saat pemuatan ulang, hanya kunci yang ada di file dengan nilai yang tidak kosong yang ditulis dan tidak ada variabel yang pernah dihapus, sehingga pemuatan ulang yang gagal atau parsial tetap mempertahankan kredensial yang sebelumnya berfungsi.

Nilai rahasia tidak pernah dikembalikan, dicatat dalam log, atau diaudit - alat ini hanya melaporkan nama variabel dan status. Tanpa --env.file yang dikonfigurasi, alat ini hanya berfungsi sebagai pemeriksa status. Saat kueri gagal pada resolusi kredensial, error MCP menyertakan petunjuk yang mengarahkan agen untuk memanggil reload_credentials dan mencoba lagi, sehingga klien agentik dapat memulihkan diri sendiri.

catatan

Tersedia di rilis StackQL setelah v0.10.542.

Lihat juga: [ Ringkasan MCP ] [ Pemuatan (ulang) kredensial ] [ server_info ] [ Claude Desktop ]


Input​

ArgumenWajibDeskripsi
providerTidakMembatasi cakupan laporan status ke satu provider. Jika dihilangkan, semua provider dilaporkan.

Output​

PerenderBentuk
TabelHasil pemuatan file env ditambah satu baris per provider dengan status resolusi kredensial

Payload terstruktur berisi:

FieldDeskripsi
env_fileJalur --env.file yang dikonfigurasi (kosong jika tidak ada yang dikonfigurasi).
env_file_sourcedtrue jika file ditemukan dan dimuat pada panggilan ini.
sourced_varsNama variabel lingkungan yang ditetapkan dari file - hanya nama, tidak pernah nilai.
providersSatu baris per provider (lihat di bawah).

Setiap baris providers berisi:

KolomDeskripsi
providerNama provider.
auth_typeTipe autentikasi yang dikonfigurasi untuk provider.
sourced_fromAsal resolusi kredensial, misalnya env:OKTA_SECRET_KEY, file:/path/key.json, inline, atau none.
statusok, unresolved, atau not_checked.
detailTeks error jika unresolved.

Tipe autentikasi yang melakukan autentikasi di luar jalur byte kredensial (gcloud interaktif, azure CLI, kredensial klien oauth2, rantai pengambilan peran, penandatanganan OCI, null) melaporkan not_checked.


Pengendalian​

Diizinkan di semua mode server, termasuk read_only - alat ini tidak mengubah apa pun selain lingkungan proses server itu sendiri.

Tidak didukung dalam mode backend reverse_proxy: kueri dijalankan di proses server stackql jarak jauh, sehingga alat ini mengembalikan error yang mengarahkan pengguna untuk memuat ulang kredensial di server yang mendasari.


Contoh​

Coba prompt ini di klien MCP mana pun yang telah mendaftarkan server MCP StackQL (dimulai dengan --env.file):

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