من ملف موثّق إلى أول عملية مضبوطة.

ثبّت HelixFlow وفعّل ترخيص الجهاز واربط عميل MCP وابدأ ببيئة اختبار.

1. التنزيل والتثبيت

اختر الملف التنفيذي المطابق لنظام تشغيل الجهاز المستهدف ومعماريته. تحقّق من بصمة SHA-256 في صفحة التنزيلات، ثم ضعه في مسار دائم.

نظام التشغيل

المعمارية

فتح التنزيلات

استخراج أرشيف Windows

استخرج ملف ZIP في مجلد التنزيل. تستخدم الأوامر التالية ملف ‎.exe المستخرج.

Expand-Archive -LiteralPath '.\helixflow-windows-amd64.exe.zip' -DestinationPath '.'

التحقق من سلامة الملف

احسب البصمة من مجلد التنزيل وقارنها بالقيمة المعروضة في صفحة التنزيلات.

Get-FileHash .\helixflow-windows-amd64.exe -Algorithm SHA256

استخدام مسار دائم

انقل الملف التنفيذي من مجلد التنزيل المؤقت. يستخدم هذا الدليل المسار التوضيحي C:\Outils\HelixFlow\helixflow-windows-amd64.exe

.\helixflow-windows-amd64.exe version

2. تفعيل ترخيص الجهاز

أنشئ الطلب على الجهاز الذي سيشغّل HelixFlow. سجّل الدخول لطلب تجربة أو ترخيص دائم، ثم أعد ملف الترخيص المنزّل إلى الجهاز إذا كان غير متصل.

.\helixflow-windows-amd64.exe license request --out request.json

يعرّف الطلب الجهاز لأغراض الترخيص. راقب مكان نقله ولا تنشره.

إرسال request.json لطلب تجربة

بعد الموافقة، نزّل helixflow.lic من صفحة حسابك وانقله إلى الجهاز المستهدف عند الحاجة، ثم استورده وتحقق منه:

.\helixflow-windows-amd64.exe license import helixflow.lic
.\helixflow-windows-amd64.exe license status

3. إعداد ملف تعريف

يحتوي ملف التعريف على عنوان الخادم وفئة البيئة وسياسة TLS ومصدر بيانات الاعتماد. تبقى بيانات الاعتماد في مخزن مفاتيح النظام أو بيئة العملية المدعومة.

اختيار جذر إعداد صريح

استخدم الجذر نفسه في الطرفية وعميل MCP. يستخدم هذا الدليل C:\Outils\HelixFlow\config

$env:HELIXFLOW_CONFIG_DIR = 'C:\Outils\HelixFlow\config'

أنشئ مجلد profiles ثم أنشئ الملف C:\Outils\HelixFlow\config\profiles\validation.yaml

base_url: https://st01.example.test:8444
env_class: test
tls:
  mode: system
credentials:
  source: env

استبدل العنوان التوضيحي بهدف الاختبار. تقبل env_class القيم test أو preprod أو prod. يلزم HTTPS باستثناء الحلقة المحلية.

إدخال بيانات الاعتماد في PowerShell

يستخدم ملف Windows القيمة credentials.source: env. شغّل هذه المطالبة التفاعلية في جلسة PowerShell نفسها، ثم ابدأ عميل MCP منها.

$stCredentials = Get-Credential -Message 'SecureTransport credentials for validation'
$env:HELIXFLOW_LOGIN = $stCredentials.UserName
$env:HELIXFLOW_PASSWORD = $stCredentials.GetNetworkCredential().Password
Remove-Variable stCredentials

توجد هذه المتغيرات في عملية PowerShell هذه وأبنائها فقط. أدخلها مجددًا في كل جلسة جديدة وأغلق الجلسة بعد الاستخدام.

مخزن مفاتيح النظام

في macOS وLinux استخدم الخدمة helixflow/validation والمدخلين login وpassword. إذا كانت أداة keyring مضبوطة فستطلب هذه الأوامر القيم تفاعليًا.

keyring set helixflow/validation login
keyring set helixflow/validation password

يجب أن يكون مخزن المفاتيح متاحًا لعملية MCP التي تعمل بالحساب نفسه.

لا تلصق بيانات اعتماد SecureTransport في هذا الموقع أو ملف إعداد MCP أو محادثة مع المساعد.

4. ربط مساعدك

اضبط عميل MCP لتشغيل الملف المحلي عبر الإدخال والإخراج القياسيين. حدّد مجلد ملفات التعريف في بيئة HelixFlow.

Claude Desktop

أضف الإدخال التالي إلى %APPDATA%\Claude\claude_desktop_config.json

لا ترث عملية Desktop التي تبدأ خارج جلسة PowerShell بيانات اعتمادها. استخدم طريقة تشغيل موثّقة من تلك الجلسة أو استخدم Claude Code.

Claude Code

سجّل الخادم المحلي وجذر إعداده. عدّل المسارين المطلقين قبل تشغيل الأمر.

احتفظ ببيانات اعتماد SecureTransport في مخزن مفاتيح النظام أو بيئة العملية المدعومة. لا تلصقها أبدًا في محادثة.

5. تنفيذ أول قراءة

ابدأ بـ server_info للتحقق من اتصال MCP دون الاتصال بـ SecureTransport. ثم اطلب قراءة باستخدام الاسم الدقيق لملف الاختبار.

يشير ملف validation إلى validation.yaml. تحقّق من هدفه قبل أول استدعاء. قد تستخدم القراءات ذاكرة مؤقتة لمدة ثلاثين ثانية افتراضيًا.

6. إعداد تغيير

تتبع تغييرات التدفق دورة صريحة. هذه الأسماء أدوات MCP وليست أوامر طرفية.

تحقّق من مستند التدفق باستخدام flow_validate.
عاينه باستخدام flow_plan وراجع مرجع الخطة الناتج.
أكّد قبل أن يستخدم flow_apply المستند ومرجع الخطة نفسيهما.

تنتهي الخطة بعد خمس عشرة دقيقة افتراضيًا. يجب تخطيط المستند المعدّل من جديد. يرفض MCP التغييرات على ملف إنتاج.

بالنسبة إلى flow_path أو ملفات الشهادات، عيّن HELIXFLOW_FLOW_DIR في بيئة MCP. يجب أن تبقى الملفات تحت هذا الجذر المسموح.

7. حل المشكلات

لا يجد العميل الملف التنفيذي: تحقّق من المسار المطلق واسم الملف الخاص بالمعمارية وإذن التنفيذ في macOS أو Linux. شغّل version مجددًا في الطرفية.
لم يُعثر على ملف تعريف: تحقّق من HELIXFLOW_CONFIG_DIR ومجلد profiles تحته. يطابق الاسم المطلوب اسم ملف YAML دون الامتداد.
فشل اتصال TLS: تحقّق من العنوان والشهادة وسلسلة الثقة. لجهة داخلية استخدم tls.mode: ca مع tls.ca_path صالح.
رُفضت المصادقة: تحقّق من خدمة مخزن المفاتيح أو البيئة الموروثة في عملية MCP. قد تختلف بيئة تطبيق سطح المكتب عن الطرفية.
رُفض الترخيص: شغّل license status على الجهاز المستهدف. تأكد أن helixflow.lic يخص ذلك الجهاز وأن مدة التجربة لم تنتهِ.

الإبلاغ عن حادث اتصل بنا