Перейти до основного вмісту
Перекладена сторінка

Цю сторінку перекладено з англійської мови за допомогою ШІ. Якщо тексти відрізняються, еталоном є англійська версія.

reload_credentials

Повторно завантажує в середовище процесу сервера файл у форматі dotenv, вказаний прапорцем --env.file, а потім повідомляє стан визначення облікових даних для кожного провайдера. Це розв'язує проблему середовища, зафіксованого під час запуску: облікові дані, які записали на диск або ротували посеред сеансу, потрапляють до запущеного сервера без перезапуску.

Файл env накладається на середовище процесу, а не замінює його: визначення облікових даних завжди читає поточне середовище процесу на момент запиту, тому змінні, наявні вже під час запуску (з оболонки або з блоку env клієнта), працюють і далі з прапорцем --env.file або без нього. Під час повторного завантаження сервер записує лише ключі, які є у файлі й мають непорожні значення, і ніколи не скасовує значення жодної змінної, тому невдале або часткове повторне завантаження зберігає облікові дані, які працювали раніше.

Значення секретів ніколи не повертаються, не записуються в журнал і не потрапляють до журналу аудиту - інструмент повідомляє лише імена змінних і їхній стан. Якщо прапорець --env.file не налаштовано, інструмент зводиться до простої перевірки стану. Коли запит завершується помилкою під час визначення облікових даних, помилка MCP містить підказку, яка вказує агентові викликати інструмент reload_credentials і повторити спробу, тож агентні клієнти відновлюються самостійно.

примітка

Доступно у випусках StackQL після v0.10.542.

Див. також: [ Огляд MCP ] [ (Повторне) завантаження облікових даних ] [ server_info ] [ Claude Desktop ]


Вхідні дані​

АргументОбов'язковийОпис
providerНіОбмежує звіт про стан одним провайдером. Якщо аргумент не вказано, звіт охоплює кожен провайдер.

Вихідні дані​

Засіб відображенняФорма
ТаблицяРезультат завантаження файлу env, а також один рядок на кожен провайдер зі станом визначення облікових даних

Структуроване корисне навантаження містить:

ПолеОпис
env_fileНалаштований шлях --env.file (порожній, якщо шлях не налаштовано).
env_file_sourcedtrue, якщо файл знайдено й завантажено під час цього виклику.
sourced_varsІмена змінних середовища, встановлених із файлу - лише імена, ніколи не значення.
providersОдин рядок на кожен провайдер (див. нижче).

Кожен рядок providers містить:

СтовпецьОпис
providerІм'я провайдера.
auth_typeТип автентифікації, налаштований для провайдера.
sourced_fromДжерело, з якого визначено облікові дані, наприклад env:OKTA_SECRET_KEY, file:/path/key.json, inline або none.
statusok, unresolved або not_checked.
detailТекст помилки для стану unresolved.

Типи автентифікації, які автентифікують поза шляхом байтів облікових даних (інтерактивний gcloud, azure CLI, oauth2 client credentials, ланцюжки прийняття ролей, підписування OCI, null), повідомляють стан not_checked.


Контроль​

Дозволено в усіх режимах сервера, зокрема в режимі read_only - інструмент не змінює нічого, крім власного середовища процесу сервера.

Не підтримується в режимі бекенду reverse_proxy: запити виконуються у віддаленому процесі сервера stackql, тому інструмент повертає помилку, яка вказує користувачеві повторно завантажити облікові дані на базовому сервері.


Приклад​

Спробуйте цей промпт у будь-якому клієнті MCP, у якому зареєстровано сервер MCP StackQL (запущений із прапорцем --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.