وكلاء MCP

يتيح MCP لعملاء Codex أو Claude Code أو Antigravity CLI استخدام أدوات DR-Terminal. يمكن للوكيل فحص الجلسات والاتصالات المحفوظة، وفتح اتصال، وقراءة خرج الطرفية، وكتابة الأوامر، ونقل الملفات، والتنقل داخل التطبيق. وضع MCP متاح أثناء فترة تجريبية نشطة ومع خطة Pro.

إضافة DR-Terminal إلى وكيل

1. انقر MCP في شريط عنوان DR-Terminal.
2. اختر Add to Codex أو Add to Claude أو Add to Antigravity. يُنشئ هذا إدخال dr-terminal على مستوى المستخدم يشغّل جسر DR-Terminal المضمّن في الحزمة؛ ولا يُخزَّن أي رمز أو نقطة نهاية في إعدادات العميل. تتشارك Antigravity 2.0 وAntigravity IDE وagy هذا الإدخال في ~/.gemini/config/mcp_config.json.
3. اختر فتح أو افتح العميل بالطريقة المعتادة. يُظهر الاتصال الأول نافذة DR-Terminal ويطلب منك السماح به عبر Allow أو رفضه عبر رفض.
4. بعد السماح بالاتصال، الصق الموجّه (prompt) الأول وأرسله.

اعرض جلسات DR-Terminal النشطة لديّ.

يجب أن يكون CLI المحدد مثبّتًا ومتاحًا في PATH. التثبيت مدعوم من حزمة DR-Terminal مثبّتة؛ أما تشغيلات التطوير من Gradle أو من بيئة تطوير فلا تُنشئ عمدًا إدخالًا دائمًا. يحذف Remove فقط إدخالًا مطابقًا تمامًا مملوكًا لـDR-Terminal ويطلب تأكيدًا. أي إدخال dr-terminal آخر موجود يُبلَّغ عنه كتعارض ولا يُستبدل أبدًا.

موجّهات مفيدة

• اعرض جلسات DR-Terminal النشطة لديّ.
• اعرض اتصالاتي المحفوظة واسألني أيّها أفتح.
• اقرأ أحدث خرج للطرفية من الجلسة المسماة server.
• اكتب uptime في الجلسة المسماة server.
• نزّل /var/log/app.log من الجلسة المسماة server.

استخدم اسم الجلسة أو معرّفها عندما تكون أكثر من جلسة واحدة مفتوحة. إذا أبلغ الوكيل بعدم وجود أي جلسة، فافتح اتصالًا في DR-Terminal أو اطلب من الوكيل أولًا سرد الاتصالات المحفوظة.

الموافقات والمؤشرات

قراءة البيانات الوصفية للجلسات وخرج الطرفية لا تقاطع عملك عادةً. أما الإجراءات الحساسة مثل الكتابة وضغط المفاتيح ونقل الملفات وقطع الاتصال فتتطلب موافقتك.

عندما تلزم الموافقة، تنبض شارة MCP ويحصل مربع حوار التأكيد على تركيز لوحة المفاتيح. راجع الجلسة الهدف والحمولة (payload)، ثم اختر السماح مرة واحدة أو السماح لهذه الجلسة أو رفض. تحمل علامة تبويب الجلسة المتأثرة علامة MCP ثابتة أثناء تنفيذ الإجراء؛ ويعرض لون الشارة حالة MCP العامة.

لا يتلقى الوكيل أبدًا كلمات المرور أو المفاتيح الخاصة المحفوظة في DR-Terminal. تسري الموافقة الممنوحة لجلسة ما فقط ما دام تشغيل خادم MCP الحالي نشطًا.

أمان الاتصال المحلي

يستمع خادم MCP على واجهة loopback فقط، لذا فهو غير مكشوف للشبكة. ومع ذلك يتطلب كل طلب رمز bearer مخزّنًا في ملف محلي لا يستطيع الوصول إليه سوى المالك. النافذة المنبثقة في شريط العنوان لا تعرض هذا الرمز أبدًا ولا تنسخه.

تُعرض نقطة النهاية فقط ضمن نقطة النهاية والإجراءات الأخيرة لأغراض التشخيص. لا تشارك ملف الرمز ولا تنسخ محتواه إلى الموجّهات أو رسائل الدردشة أو السجلات أو لقطات الشاشة.

إيقاف MCP

اختر إيقاف في النافذة المنبثقة لـMCP لرفض أي موافقة معلّقة، والتوقف عن قبول استدعاءات الأدوات، وإغلاق العملاء الذين شغّلهم تشغيل MCP الحالي. بدء MCP من جديد يُنشئ تشغيلًا جديدًا؛ ولا تُنقل موافقات الجلسات السابقة.

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

استكشاف الأخطاء وإصلاحها

لم يُعثر على CLI

ثبّت CLI المحدد لـCodex أو Claude Code أو Antigravity (agy) وتأكد من توفر ملفه التنفيذي في PATH. أعد تشغيل DR-Terminal بعد تغيير بيئة الصدفة لديك، ثم اختر تحقق مرة أخرى.

المنفذ مستخدم بالفعل

تستخدم عملية أخرى منفذ MCP المكوّن. أوقف تلك العملية أو اختر منفذًا آخر ضمن الإعدادات → وضع MCP، ثم ابدأ MCP من جديد.

لا توجد جلسة نشطة

افتح أولًا جلسة SSH أو Telnet أو جلسة تسلسلية أو طرفية محلية. يمكنك أيضًا أن تطلب من الوكيل عرض الاتصالات المحفوظة وفتح إحداها بعد موافقتك على الإجراء.

العميل يعمل لكن MCP غير مؤكد

بدأت عملية CLI، لكن DR-Terminal لم يتلقَّ بعد استدعاء أداة MCP. افحص علامة تبويب الطرفية الجديدة بحثًا عن أخطاء تسجيل الدخول أو الإعدادات أو المصافحة (handshake). ثم أرسل الموجّه النموذجي من جديد. تصف الحالة قيد التشغيل العملية المحلية، وليس اتصال MCP مؤكدًا.

مربع حوار موافقة بانتظارك

عد إلى DR-Terminal وراجع مربع الحوار الذي عليه التركيز. لا يستطيع الوكيل متابعة ذلك الإجراء الحساس حتى تسمح به أو ترفضه. إيقاف MCP يرفض الطلب المعلّق.