التوثيق/الاتصال/لوحتك الخاصة/وكيل الذكاء الاصطناعي وMCP·9 / 9

وكيل الذكاء الاصطناعي وMCP

يمكن ربط اللوحة بـ Claude Code وCursor وVS Code وغيرها من وكلاء الذكاء الاصطناعي عبر MCP: يسأل المشغّل بالكلمات — «من تنتهي اشتراكاته هذا الأسبوع»، «ما حال عقدة de-fra»، «مدّد لمن عليهم وسم vip» — فيتوجه الوكيل إلى واجهة API نفسها برمزك. يرى الوكيل ما يسمح به الرمز تمامًا.

  1. أنشئ رمزًا

    بالأمر ‎veli token add agent --rights read على خادم اللوحة. ابدأ بـ«قراءة فقط»: يستطيع الوكيل أن ينظر ولا يغيّر شيئًا.

  2. اربط اللوحة

    مرة واحدة: عبر HTTPS — دون تثبيت أي شيء، أو بالأمر veli على حاسوب بنظام Linux. الرمز في ملف أو في مخزن الوكيل، لا في المحادثة.

  3. اسأل

    للوكيل سيناريوهات جاهزة: الجولة الصباحية، حال العقدة، معالجة رسالة عميل، تنظيف غير النشطين، تقرير بعد الانتقال.

رمز للوكيل — قراءة فقط
veli token add agent --rights read
عبر HTTPS — اللوحة ذات النطاق تجيب الوكيل بنفسها، ولا حاجة لتثبيت شيء
claude mcp add --transport http veli-panel https://panel.example.com/Zq7mT2xP4vLc9wRbE5nK/api/mcp --header "Authorization: Bearer $VELI_TOKEN"
بالأمر veli على حاسوبك بنظام Linux (الرمز في الملف ~/.veli/panel.token)
claude mcp add veli-panel -- veli panel mcp --url https://panel.example.com/Zq7mT2xP4vLc9wRbE5nK/api --token-file ~/.veli/panel.token
قراءة فقط
العملاء والعقد والمجموعات والأحداث وحركة البيانات وسلة المحذوفات. لا رابط عميل في الإجابات.
العملاء
ويمكنه أيضًا: الإضافة والتمديد وتغيير الحقول والوسوم والإيقاف والتشغيل وإظهار رابط العميل وتغيير كثيرين معًا — معاينة أولًا ثم ذكر العدد.
الكل
ويمكنه أيضًا: حذف عميل ورابط جديد والاستعادة من السلة والحذف النهائي منها — مع إعادة كتابة الاسم فقط. وبالأمر — مع الخيار --destructive.
  • لا يغيّر الوكيل شيئًا إلا برمز «العملاء» أو «الكل» وإذا فعّلت الخيار --write. عبر HTTPS يحدد الرمز نفسه الأدوات.
  • رابط العميل سرّ: الإجابات العادية لا تحتويه، ولا تعطيه إلا الأداة client_link، وعبر HTTPS يُكتب سطر في السجل باسم الرمز. وبالأمر لا يُكتب هذا السطر: حيث يلزم أثر، اربط عبر HTTPS.
  • اسم العميل وملاحظته وجهة اتصاله نصّ كتبه العميل. يتلقاه الوكيل بيانات ولا ينفّذ ما فيه.

تعليمات للذكاء الاصطناعي

نص جاهز تلصقه في Claude أو أي مساعد ذكاء اصطناعي مع مخطط API، فتحصل على واجهة تناسب مهامك.

  1. الرمز

    veli token add cabinet --rights clients. وللواجهة والتقارير يكفي read. لا تلصق الرمز في المحادثة: ضعه في متغيّرات البيئة على خادمك فقط.

  2. المخطط

    نزّل openapi.json وأرفقه بالمحادثة مع الذكاء الاصطناعي — أو أعطه عنوان المخطط.

  3. التعليمات

    انسخ النص أدناه، واكتب مهامك مكان السطر بين القوسين، وأرسله مع المخطط.

  4. تحقّق

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

الرمز
veli token add cabinet --rights clients --days 90

VELI=https://panel.example.com/Zq7mT2xP4vLc9wRbE5nK/api
VELI_TOKEN=veli_…
curl -s "$VELI/openapi.json" \
  -H "Authorization: Bearer $VELI_TOKEN" -o veli-openapi.json
تعليمات لـ Claude
ساعدني في بناء واجهة لخدمة VPN الخاصة بي فوق واجهة API الجاهزة للوحة Veli. ليس للوحة واجهة خاصة في المتصفح: كل العمل يجري عبر HTTP API.

ما لديك:
- مخطط API: الملف openapi.json (مرفق). خذ الاستدعاءات والحقول منه فقط ولا تخترع شيئًا.
- عنوان API: https://panel.example.com/<المسار السري>/api (استخدم عنواني).
- الرمز في متغيّر البيئة VELI_TOKEN ويُمرَّر في الترويسة Authorization: Bearer. لا تكتب الرمز في الشيفرة ولا السجلات ولا صفحات الموقع.

القواعد:
1. كل استدعاء يغيّر شيئًا يجب أن يحمل الترويسة Idempotency-Key (رقم الطلب): قد يرسل النظام الإشعار مرتين ويجب أن يظهر العميل مرة واحدة.
2. رابط اشتراك العميل سرّ: اعرضه للعميل نفسه فقط ولا تكتبه في السجلات.
3. الحد 300 طلب في الدقيقة لكل رمز. عند 429 انتظر عدد الثواني المذكور في Retry-After.
4. يجب ألا يصل الرمز أبدًا إلى متصفح العميل: تستدعي الواجهة API من خادمي لا من صفحة.
5. تصل الأحداث (أُضيف عميل، توشك مدة على الانتهاء، توشك البيانات على النفاد، صمتت عقدة) عبر خطّافات الويب. تحقّق من توقيع HMAC-SHA256 في الترويسة veli-signature، وردّ فورًا ثم أنجز العمل بعد ذلك.
6. اربط العميل بنظامي عبر الحقل external (رقم الطلب أو معرّف المستخدم في نظامك).

مهامي:
[اكتبها هنا: مثلًا — نموذج «اطلب» ينشئ عميلًا لمدة 30 يومًا ويعرض الرابط ورمز QR؛ صفحة «اشتراكاتي» حسب رقم الطلب؛ قائمة من تنتهي مدتهم خلال 3 أيام مع زر «مدّد»؛ ملخص للعُقد.]

اطرح عليّ أسئلة أولًا إن كان ينقصك شيء. ثم اقترح خطة، وابنِ الواجهة خطوة خطوة، وبيّن كيف أشغّلها محليًا وكيف أجرّبها على عميل تجريبي.