تخطَّ إلى المحتوى
Documentation

خوادم MCP في الوكيل الذكي

توفر خوادم MCP (بروتوكول سياق النموذج) أدوات إضافية للوكيل. ويدعم الوكيل نوعين منها:

النوعأين يعملمكان التهيئة
مستضافخارج جهازك؛ يتصلCHAMPREP به عبر HTTPSCHAMPREP AIحسابك، المشترك مع تطبيقات الويب والكمبيوتر المكتبي والهواتف المحمولة
محليبرنامج تم تشغيله على جهازك، ويتواصل عبر MCP باستخدام الإدخال والإخراج القياسيينأ mcp.json ملف خاص بك أو بالمشروع

تتناول هذه الصفحة توصيل الخوادم بالوكيل. لاستخدام CHAMPREP CHAMPREPنفسه من عميل MCP آخر، راجع CHAMPREP خادم MCP.

/mcp

تسرد النافذة كل خادم مستضاف ومحلي مع حالته وأدواته. حدد خادمًا باستخدام مفاتيح الأسهم واضغط على:

المفتاحالإجراء
Enterاعرض الإجراءات الخاصة بالخادم.
eتشغيل الخادم أو إيقاف تشغيله.
rالتحديث: إعادة الاتصال وإعادة تحميل أدواته.
aإعادة المصادقة: استبدل بيانات اعتمادها.
tأدرج أدواته.
xإزالة الخادم.
nأضف خادمًا.

تعمل الاختصارات أيضًا بدون النافذة، على سبيل المثال /mcp list, /mcp enable NAME, /mcp disable NAME, /mcp refresh NAME، وبالنسبة للخوادم المحلية ، /mcp restart NAME و /mcp remove NAME.

تنتمي الخوادم المستضافة إلى CHAMPREP AIحسابك، لذا فإن الخادم الذي تضيفه في المحطة الطرفية يكون متاحًا أيضًا على الويب، والعكس صحيح. تعمل أدواتها على CHAMPREP، وليس على جهازك.

لإضافة خادم، اضغط على n في /mcp، اختر خادمًا مستضافًا، وأدخل عنوان URL الخاص به و بيانات الاعتماد، مثل رمز الحامل. يتم إدخال بيانات الاعتماد في حقل مُخفي ، ويتم إرسالها مرة واحدة إلى CHAMPREP AIحسابك ، ولا يتم عرضها أبدًا، أو حفظها محليًّا، أو تسجيلها، أو إعطاؤها للنموذج. استخدم a لاستبدال بيانات اعتماد منتهية الصلاحية.

تؤدي إزالة خادم مستضاف إلى إزالته من حسابك على جميع الأسطح. إذا كان إجراء الخادم المستضاف غير متاح من CLIفي بيئتك، فإن الوكيل يبلغك بذلك؛ استخدم CHAMPREP AIإعداداتك على الويب بدلاً من ذلك.

الخوادم المحلية هي برامج يبدأها الوكيل على جهازك. أضف خادمًا باستخدام n في /mcp واختر:

  • اسم الخادم والأمر مع معلماته؛
  • لك وحدك (حساب المستخدم الخاص بك mcp.json) أو لهذا المشروع (.champrep/mcp.json، والتي يمكنك التزامها)؛
  • اختياريًا، متغير بيئة يحتوي على بيانات اعتماد. يتم إخفاء قيمته وتخزينها في حساب المستخدم الخاص بك فقط mcp.json، ولا تُكتب أبدًا في ملف المشروع أو السجل التاريخي أو سجلات التشغيل أو سياق النموذج.

يمكنك أيضًا تعديل الملفات مباشرةً. فهي تستخدم تنسيق عميل MCP الشائع. احتفظ ببيانات الاعتماد في ملف المستخدم الخاص بك، ولا تضعها أبدًا في ملف مشروع تقوم بإرساله:

{
"mcpServers": {
"github": {
"command": "github-mcp-server",
"args": ["stdio"],
"env": { "GITHUB_TOKEN": "YOUR_TOKEN" }
}
}
}

الحقول الاختيارية لكل خادم: disabled, include_tools, exclude_tools, startup_timeout_sec (الافتراضي 30)، tool_timeout_sec (الافتراضي 120، والحد الأقصى 600)، و priority. لا تنتمي إلى هذه الملفات سوى الخوادم المحلية (stdio)؛ أضف خوادم HTTP كخوادم مستضافة.

لا تتلقى الخوادم المحلية أبدًا بياناتCHAMPREP اعتمادك أو أي CHAMPREP_* متغير البيئة.

تشغيل champrep ai paths للعثور على المستخدم الخاص بك mcp.json. تعد خوادم MCP المحلية إحدى ميزات الخطة؛ انظر الباقات والحدود.

مشروع ما .champrep/mcp.json تقوم بتشغيل الأوامر على جهازك، لذا لا تبدأ خوادمها في العمل إلا بعد أن تثق في المشروع .champrep/ التكوين. إذا تغير الملف، فسيُطلب منك ذلك مرة أخرى. انظر ثقة المستودع.

الموافقة على مكالمات أداة MCP

Section titled “الموافقة على مكالمات أداة MCP”
  • أدوات الخادم المحلي يتم التعامل معها كأوامر: كل استدعاء يطلب إذنك، مع عرض الخادم والحجج، ما لم تكن هناك قاعدة سماح تشمل ذلك. على سبيل المثال، local_mcp__github__* تسمح كل أداة من github الخادم. تعمل قواعد الحظر بنفس الطريقة.
  • أدوات الخادم المستضاف تتبع إعدادات الموافقة الخاصة بالخادم في حسابك CHAMPREP AI. عندما تحتاج المكالمة إلى موافقة، يعرض الوكيل بطاقة موافقة ؛ ولا تتم الموافقة على أي شيء تلقائيًا.

يمكن للوكيل تقديم 64 أداة محلية كحد أقصى لكل دور. عندما توفر الخوادم المحلية المزيد، انخفضpriority يتم استبعاد الخوادم أولاً ويخبرك الوكيل بذلك. استخدم include_tools أو exclude_tools للاحتفاظ بالأدوات التي تحتاجها.