# reload_credentials

> أداة MCP تعيد تحميل بيانات الاعتماد من ملف dotenv الذي تحدده العلامة --env.file وتبلغ عن حالة حلها لكل موفر

Source: https://stackql.io/ar/mcp/reload_credentials

تعيد تحميل الملف بتنسيق dotenv الذي تحدده العلامة [`--env.file`](/command-line-usage/global-flags) إلى بيئة عملية الخادم، ثم تبلغ عن حالة حل بيانات الاعتماد لكل موفر.  يحل ذلك مشكلة البيئة الثابتة منذ لحظة التشغيل: بيانات الاعتماد التي تتم كتابتها أو تدويرها على القرص أثناء الجلسة تصل إلى الخادم قيد التشغيل دون الحاجة إلى إعادة تشغيله.

يتراكب ملف البيئة فوق بيئة العملية بدلًا من أن يحل محلها: يقرأ حل بيانات الاعتماد دائمًا بيئة العملية كما هي وقت الطلب، لذا تظل المتغيرات الموجودة بالفعل عند التشغيل (من واجهة الأوامر أو من الكتلة `env` الخاصة بالعميل) تعمل مع `--env.file` أو بدونه.  عند إعادة التحميل، تتم كتابة المفاتيح الموجودة في الملف ذات القيم غير الفارغة فقط، ولا يتم إلغاء تعيين أي شيء أبدًا، لذا تحافظ إعادة التحميل الفاشلة أو الجزئية على بيانات الاعتماد التي كانت تعمل سابقًا.

لا يتم أبدًا إرجاع قيم الأسرار أو تسجيلها أو تدقيقها - تبلغ الأداة عن أسماء المتغيرات وحالاتها فقط.  وبدون تكوين `--env.file`، تقتصر الأداة على فحص الحالة فقط.  عندما يفشل استعلام في حل بيانات الاعتماد، يحتوي خطأ MCP على تلميح يوجه الوكيل إلى استدعاء `reload_credentials` وإعادة المحاولة، ومن ثم تتعافى العملاء القائمة على الوكلاء ذاتيًا.

:::note

متاح في إصدارات StackQL بعد `v0.10.542`.

:::

راجع أيضًا:
[[ نظرة عامة على MCP ]](/command-line-usage/mcp) [[ (إعادة) تحميل بيانات الاعتماد ]](/command-line-usage/mcp#credential-resourcing---envfile--reload_credentials) [[ `server_info` ]](/mcp/server_info) [[ Claude Desktop ]](/getting-started/claude-desktop)

* * *

## الإدخالات

| الوسيطة | مطلوب | الوصف |
|--|--|--|
|`provider`|لا|تقصر تقرير الحالة على موفر واحد.  عند حذفها، يتم الإبلاغ عن جميع الموفرين.|

* * *

## الإخراج

| أداة العرض | الشكل |
|--|--|
| جدول | نتيجة تحميل ملف البيئة بالإضافة إلى صف واحد لكل موفر مع حالة حل بيانات الاعتماد |

تحتوي الحمولة المنظمة على:

| الحقل | الوصف |
|--|--|
|`env_file`|مسار `--env.file` الذي تم تكوينه (فارغ عند عدم تكوين أي مسار).|
|`env_file_sourced`|`true` عند العثور على الملف وتحميله في هذا الاستدعاء.|
|`sourced_vars`|أسماء متغيرات البيئة التي تم تعيينها من الملف - الأسماء فقط، وليس القيم أبدًا.|
|`providers`|صف واحد لكل موفر (راجع ما يلي).|

يحتوي كل صف في `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 البعيد، لذا تعيد الأداة خطأ يوجه المستخدم إلى إعادة تحميل بيانات الاعتماد على الخادم الأساسي.

* * *

## مثال

جرّب هذا الموجه مع أي عميل MCP مسجل فيه خادم StackQL MCP (تم تشغيله باستخدام `--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.
```
