خادم MCP (قم بتوصيل مساعد الذكاء الاصطناعي الخاص بك)
CHAMPREP يستضيف عن بُعد بروتوكول سياق النموذج خادم (MCP). قم بتوصيله بأي عميل ذكاء اصطناعي يدعم MCP — Claude (claude.ai و الكمبيوتر المكتبي)، ChatGPT، Claude Code، Codex، Cursor، VS Code، Windsurf، وغيرها — ويمكن لمساعدك العمل على ملفك CHAMPREP الحساب: قم بإدراج أحداث التقويم وحجزها، وقراءة البريد الإلكتروني وصياغة رسائله، وإدارة لوحات العمل، والبحث في محرك الأقراص الخاص بك، وإنشاء الفواتير والملاحظات والمستندات وجداول البيانات، وغير ذلك الكثير، كل ذلك من خلال المحادثة.
:::تحذير[تم تحديث نقطة النهاية: استخدم /mcp/v1] نقطة النهاية الآن مُرقمة. اتصل بـ https://ai-api.champrep.com/mcp/v1. نقطة النهاية القديمة غير المرقمة https://ai-api.champrep.com/mcp هي تم إيقاف العمل بها — يتم رفض الطلبات الموجهة إليها مع ظهور رسالة تطلب منك التبديل. إذا كان عميلك لا يزال موجهًا إلى /mcp، قم بتغيير عنوان URL إلى /mcp/v1 (مستخدمو npm-bridge على npx -y @champrep/mcp سيحصلون على نقطة النهاية الجديدة تلقائيًا عند التشغيل التالي). :::
لا يوجد شيء لتثبيته بالنسبة للعملاء الحديثين. يتم استضافة الخادم على:
https://ai-api.champrep.com/mcp/v1يتم تنفيذ منطق المساعد في عميل الذكاء الاصطناعي الخاص بك مع نموذج عميلك — CHAMPREP لا تستهلك مكالمات MCP أيًا من CHAMPREP AIرصيدك. يتم تنفيذ كل استدعاء للأداة بهويتك الخاصة ويخضع لخطة اشتراكك، و سياسات مؤسستك، و(بالنسبة للمفاتيحAPI) النطاقات التي اخترتها.
اختيار طريقة المصادقة
Section titled “اختيار طريقة المصادقة”هناك طريقتان للاتصال. كلاهما مدعومان بالكامل — اختر حسب الحالة:
| تسجيل الدخول عبر المتصفح (OAuth) | API المفتاح | |
|---|---|---|
| الأفضل لـ | الأشخاص الذين يستخدمون تطبيق الذكاء الاصطناعي بشكل تفاعلي | البرامج النصية، التكامل المستمر (CI)، الخوادم، الأدوات غير التفاعلية |
| الإعداد | الصق عنوان URL؛ وافق في متصفحك | أنشئ مفتاحًا مرة واحدة؛ والصقه في ملف التكوين |
| الأسرار التي يجب التعامل معها | لا شيء — لا يلامس أي مفتاح إعدادات العميل أبدًا | تقوم بتخزين cpk_… أدخل المفتاح في إعدادات العميل |
| نطاق الوصول | حسابك الكامل (كما لو كنت مسجلاً الدخول) | فقط نطاقات فأنت تمنح المفتاح (على سبيل المثال، فقط calendar:read) |
| يعمل في | claude.ai، Claude Desktop، ChatGPT، Claude Code، Codex، Cursor، VS Code، Windsurf | كل شيء، بما في ذلك العملاء الذين لا يمتلكون متصفحًا |
| انتهاء الصلاحية | يتم تحديث الجلسات تلقائيًا؛ يمكن إلغاء الصلاحية في أي وقت | تاريخ انتهاء صلاحية اختياري؛ يمكن إلغاؤه في أي وقت |
| إلغاء من | قطع الاتصال في العميل | الحساب → المفاتيحAPI على champrep.com |
قاعدة عامة: إذا كان هناك شخص أمام العميل، فاستخدم تسجيل الدخول عبر المتصفح. إذا كان هناك جهاز، فاستخدم مفتاحAPI API ذي النطاقات الأضيق التي تؤدي المهمة.
الخيار أ: تسجيل الدخول باستخدام المتصفح (موصى به)
Section titled “الخيار أ: تسجيل الدخول باستخدام المتصفح (موصى به)”أضف عنوان URL للخادم باستخدام لا يوجد مفتاح أو رؤوس. يكتشف عميلك تدفق CHAMPREPتسجيل الدخول تلقائيًا (OAuth 2.1 مع التسجيل الديناميكي)، ويفتح متصفحك على صفحة CHAMPREPالموافقة، ويتصل بعد موافقتك. إذا كنت قد سجلت الدخول بالفعل إلى CHAMPREPفي ذلك المتصفح، فستنتقل مباشرةً إلى شاشة الموافقة؛ أما إذا كنت مسجلاً الدخول إلى عدة CHAMPREPحسابات، فستختار الحساب الذي تريد الاتصال به.
claude.ai و Claude Desktop
Section titled “claude.ai و Claude Desktop”- الإعدادات → الموصلات → إضافة موصل مخصص.
- الصق
https://ai-api.champrep.com/mcp/v1ثم احفظ. - يفتح متصفحك صفحة الموافقةCHAMPREP — راجعها وانقر السماح.
- في أي محادثة، قم بتمكين الموصلCHAMPREP من قائمة الأدوات واسأل ببساطة: “تحقق من بريديCHAMPREP الإلكتروني بحثًا عن الرسائل غير المقروءة.”
ChatGPT
Section titled “ChatGPT”تتطلب الموصلات خطة ChatGPT مع وضع المطور (الإعدادات → الموصلات → متقدم → وضع المطور).
- الإعدادات → الموصلات → إنشاء (أو أضف موصلًا).
- قم بتسميته
CHAMPREP، اضبط عنوان URL لخادم MCP علىhttps://ai-api.champrep.com/mcp/v1، اختر OAuth المصادقة، ثم احفظ. - وافق على صفحة الموافقةCHAMPREP عند فتح المتصفح.
Claude Code
Section titled “Claude Code”claude mcp add --transport http champrep https://ai-api.champrep.com/mcp/v1ثم قم بتشغيل /mcp، حدد champrep، واختر المصادقة — يفتح متصفحك صفحة الموافقة.
المؤشر
Section titled “المؤشر”الإعدادات → MCP → إضافة خادم MCP جديد، أو أضف إلى ~/.cursor/mcp.json:
{ "mcpServers": { "champrep": { "url": "https://ai-api.champrep.com/mcp/v1" } }}عندما يُبلغ Cursor أن الخادم يحتاج إلى مصادقة، اتبع تعليمات تسجيل الدخول.
VS Code (GitHub Copilot) و Windsurf
Section titled “VS Code (GitHub Copilot) و Windsurf”أضف خادم MCP عبر HTTP مع عنوان URL https://ai-api.champrep.com/mcp/v1 في إعدادات MCP الخاصة بالعميل. وكلاهما يدعم تدفق OAuth: يفتح الاتصال الأول صفحة الموافقةCHAMPREP.
الخيار ب: استخدام مفتاحAPI API
Section titled “الخيار ب: استخدام مفتاحAPI API”
1. إنشاء المفتاح
Section titled “1. إنشاء المفتاح”- سجّل الدخول على champrep.com وافتح الحساب → المفاتيحAPI.
- أنشئ مفتاحًا وحدد نطاقات — هذه الخيارات تحدد الأدوات التي يمكن للمساعد استخدامها.
calendar:readيكشف عن أدوات التقويم المخصصة للقراءة فقط؛calendar:writeكما يُظهر أيضًا الأدوات التي تنشئ الأحداث أو تغيرها. امنح حق الوصول فقط للخدمات التي تريدها. - انسخ المفتاح (
cpk_live_…). يتم عرضه مرة واحدة.
2. أضفه إلى عميلك
Section titled “2. أضفه إلى عميلك”رمز كلود:
claude mcp add --transport http champrep https://ai-api.champrep.com/mcp/v1 \ --header "Authorization: Bearer cpk_live_YOUR_KEY"Cursor / VS Code / Windsurf (mcp.json(تكوين من النوع):
{ "mcpServers": { "champrep": { "url": "https://ai-api.champrep.com/mcp/v1", "headers": { "Authorization": "Bearer cpk_live_YOUR_KEY" } } }}Codex CLI (~/.codex/config.toml) — يتواصل Codex مع خوادم stdio، لذا استخدم حزمة bridge:
[mcp_servers.champrep]command = "npx"args = ["-y", "@champrep/mcp"]env = { CHAMPREP_API_KEY = "cpk_live_YOUR_KEY" }Claude Desktop (تكوين stdio) وعملاء stdio الآخرون فقط —
@champrep/mcp يقوم الجسر بتوجيه خادم stdio المحلي إلى نقطة النهاية المستضافة:
{ "mcpServers": { "champrep": { "command": "npx", "args": ["-y", "@champrep/mcp"], "env": { "CHAMPREP_API_KEY": "cpk_live_YOUR_KEY" } } }}إذا CHAMPREP_API_KEY في حالة عدم وجوده، يفتح الجسر متصفحك على صفحةAPI «المفاتيح» ويعرض التعليمات بدلاً من الفشل بصمت.
HTTP الخام (لتكاملاتك الخاصة — JSON-RPC 2.0 عادي). قم بتمرير المفتاح من متغير بيئة بدلاً من إدخاله مباشرةً، حتى يبقى خارج سجل أوامر شل:
export CHAMPREP_API_KEY="cpk_live_..." # from Account -> API Keys
curl https://ai-api.champrep.com/mcp/v1 \ -H "Authorization: Bearer $CHAMPREP_API_KEY" \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
كيف تعمل الموافقات
Section titled “كيف تعمل الموافقات”
التأكيد في عميلك
Section titled “التأكيد في عميلك”يتحكم عميل MCP الخاص بك في ما إذا كان سيطلب منك تأكيد استدعاء الأداة، ومتى، وكيف يتم ذلك. إرشادات تفاعل المستخدم في مواصفات MCP توصي بالإشراف البشري ومطالبات التأكيد، ولكنها لا تفرض نموذج تفاعل معين. تعتمد المطالبة على العميل وإعداداته، بما في ذلك أي أذونات مخزنة أو قواعد الموافقة التلقائية.
CHAMPREP توفر تعليقات توضيحية للأداة لمساعدة العملاء على تقييم كل عملية:
- الأدوات المخصصة للقراءة فقط (سرد الأحداث، والبحث في البريد، وقراءة الملاحظات …) لها
readOnlyHint: true. - الأدوات التي تُحدث تغييرات (إرسال بريد، إنشاء أحداث، تحميل ملفات …) لها
readOnlyHint: false. - الأدوات المدمرة لديك
destructiveHint: trueوتبقى مخفية ما لم يتم تمكين الوصول المدمر (القسم التالي).
تصف تعليقات الأدوات سلوكها. وهي لا تفرض ظهور مربع حوار للتأكيد ولا تضمن ظهور مطالبة قبل كل استدعاء، حتى بالنسبة للأدوات المدمرة. راجع إعدادات الموافقة الخاصة بالعميل قبل السماح بإجراء أي تغييرات.
الإجراءات الوقائية التي يتم فرضها بواسطة CHAMPREP
Section titled “الإجراءات الوقائية التي يتم فرضها بواسطة CHAMPREP”بالنسبة لإجراءات MCP العادية، CHAMPREPتعتمد على معالجة الموافقة من جانب العميل بدلاً من طلب بطاقة موافقةCHAMPREP ثانية. لا يقوم الخادم بالتحقق بشكل مستقل من أن العميل قد عرض مطالبة.
CHAMPREP لا تزال تفرض قيود الاتصال، ونطاقات APIالمفاتيح القابلة للتطبيق، وتفويض الخدمة، وسياسات المؤسسة، وحدود المعدل. كما تخضع الإجراءات الموجهة عبر CHAMPREPمنفذ الإجراءات لـ لفحوصات أمان ويتم تسجيلها في حسابك سجل الأنشطة، مع التراجع حيثما كان ذلك مدعومًا. لا يمكن لموافقة العميل تجاوز الرفض من جانب الخادم أو الموافقة المطلوبة من قبل المؤسسة ؛ قد تُرفض الإجراءات التي تتطلب موافقة CHAMPREPخاصة عبر MCP.
تمكين الأدوات المدمرة (الاشتراك الاختياري)
Section titled “تمكين الأدوات المدمرة (الاشتراك الاختياري)”بشكل افتراضي، يخفي الخادم الأدوات التي تحذف البيانات أو تمسحها نهائيًا — مثل حذف مجلدات محرك الأقراص، ومسح الملاحظات، وإزالة السجلات، وما شابه ذلك. إذا كان لديك عملية تنظيف حقيقية تريد القيام بها وترغب في مساعدة مساعدك، فيجب أن يسمح الاتصال بالإجراءات المدمرة ويجب أن يطلبها العميل عن طريق إضافة
?destructive=true إلى عنوان URL للخادم:
https://ai-api.champrep.com/mcp/v1?destructive=trueاستخدم هذا الرابط في أي مكان يقبل عناوين URL (موصل claude.ai، Claude Code، Cursor، ChatGPT). بالنسبة لجسر stdio، قم بتعيين متغير بيئة بدلاً من ذلك:
"env": { "CHAMPREP_API_KEY": "cpk_live_YOUR_KEY", "CHAMPREP_ENABLE_DESTRUCTIVE": "true"}لا يتجاوز إعداد علامة URL أو الجسر وحده أذونات الاتصال. فالاتصال للقراءة فقط، أو الخدمة غير المسموح بها، أو الوصول التدميري المعطل، لا يزال يمنع توفر الأداة.
أنت مسؤول عما يفعله مساعدك بهذه الأدوات. قد لا تكون البيانات المحذوفة قابلة للاسترداد. لا تزال الأدوات المدمرة تتطلب نطاقات المفتاح API المناسبة، مثل خدمة :write النطاق أو نطاق الحذف المنفصل الخاص به حيثما ينطبق ذلك. فهي لا تزال تحمل destructiveHint، لكن ما إذا كنت سترى مطالبة بالتأكيد أم لا يعتمد على عميلك وتكوينه. لا تزال عمليات الفحص من جانب الخادم وتدقيق الإجراءات الموضحة أعلاه سارية. تدعم بعض الإجراءات المدمرة التراجع من صفحة «النشاط» في حسابك — ولكن تعامل مع كل عملية حذف على أنها نهائية.
بغض النظر عن هذا الإعداد، هناك بعض الأمور التي أبدًا متاح عبر MCP: العمليات الإدارية، وأدوات تنفيذ الكود، وحذف الحساب. الاستثناءات الوحيدة لقاعدة تنفيذ الكود هي بدء إصدار معاينة QA أو جلسة QA cloud IDE: كلاهما يعملان في بيئة اختبار معزولة تابعة لـ QA، بعد موافقتك (انظر MCP للكود، وCI، وRunner Farm، وQA).
ما يمكن للمساعد القيام به
Section titled “ما يمكن للمساعد القيام به”تغطي الأدوات المنصة بأكملها، دائمًا على النحو التالي أنت: Calendar (الأحداث، الحجوزات، التوافر)، Mail (القراءة، البحث، المسودات، الإرسال، العلامات، القواعد)، Drive (البحث، الملفات، المجلدات، المشاركة)، Notes، Meetings (الجدول الزمني، الملخصات، التسجيلات)، Work (لوحات، تذاكر)، مستندات (وثائق، تعليقات، تعديلات مقترحة، إصدارات، تصدير)، جداول (مصنفات، نطاقات، صيغ، تنسيق، التحقق من الصحة، التنسيق الشرطي، الحماية، تعليقات، إصدارات، تصدير)، فواتير، Forms، Contacts، مخططات، CHAMPREP الكود، مزرعة المشغلات، ضمان الجودة، و Learn. يعتمد تحديد الأدوات التي تظهر بالضبط على خطتك، وسياسات مؤسستك، وأذونات الذكاء الاصطناعي الخاصة بك لكل خدمة، و(بالنسبة للمفاتيحAPI) نطاقات المفتاح.
بالنسبة إلى CHAMPREP Code (المشاريع، وخطط النسخ، وخطوط الأنابيب، وسجلات المهام، ووحدات التشغيل)، وRunner Farm، وQA، راجع MCP للكود، وCI، وRunner Farm، وQA: ما يمكن للمساعد القيام به، أمثلة على المطالبات، ما يحتاج إلى موافقتك وما يبقى في تطبيقات الويب.
جرب الخطوات التالية أولاً:
- “ماذا يوجد في CHAMPREPتقويمي هذا الأسبوع؟”
- “هل لدي بريد غير مقروء؟ لخص لي أي شيء مهم.”
- “ابحث عن عقود PDF في محرك الأقراص الخاص بي من هذا الشهر.”
- “أنشئ تذكرة عمل بعنوان ‘تجديد شهادات SSL’ على لوحة العمليات الخاصة بي.”
- “أنشئ مستندًا في Docs باسم ‘خطة الربع الرابع’ يتضمن أقسامًا للأهداف والمخاطر و المسؤولين.”
- “في مصنف «الميزانية الشهرية» الخاص بي، قم بتمييز كل نفقة تزيد عن 500.”
جسر ترحيل المتصفح (ملحق Chrome) و Eve AI
Section titled “جسر ترحيل المتصفح (ملحق Chrome) و Eve AI”بالإضافة إلى أدوات الخدمة السحابية، فإن CHAMPREP لملحق Chrome يمكنك ربط متصفحك الخاص بـ Eve:
- تشغيل دع Eve يستخدم هذا المتصفح في إعدادات الملحق.
- تتواصل Eve عبر الويب، وفي تطبيق سطح المكتب، وفي Eve AI لـ VS Code، وفي وكيل المحطة الطرفية (
eve/champrep ai) يمكنه بعد ذلك قراءة علامة التبويب النشطة، وإدراج قائمة بعلامات التبويب، والتقاط لقطات شاشة، وبعد موافقتك على كل إجراء، يمكنه التنقل أو النقر أو ملء حقل ما. - لا يتعامل «إيف» أبدًا مع مواقع البريد الإلكتروني أو الخدمات المصرفية أو الدفع أو تسجيل الدخول، ولا يكتب أبدًا في حقول كلمات المرور أو الرموز أحادية الاستخدام أو بيانات البطاقات.
إدارة الوصول وإلغاؤه
Section titled “إدارة الوصول وإلغاؤه”- API المفاتيح — العرض، والنطاق، وانتهاء الصلاحية، والإلغاء في الحساب → المفاتيحAPI. يسري الإلغاء على الفور.
- تسجيل الدخول عبر المتصفح — افصل الموصل داخل عميل الذكاء الاصطناعي. يمكنك أيضًا تسجيل الخروج CHAMPREPمن ذلك المتصفح؛ وبذلك لن يتم إصدار رموز جديدة له بعد ذلك.
- كل إجراء وكيل يظهر في حسابك سجل الأنشطة مع ما تم تشغيله، ومتى، ومن أين — وإمكانية التراجع حيثما كان ذلك مدعومًا.
الحدود
Section titled “الحدود”- 120 طلب MCP في الدقيقة لكل هوية. يجب أن تستخدم عمليات الأتمتة الأكثر تعقيدًا المطور API باستخدام مفاتيح نطاق الخدمة.
- تخضع استدعاءات الأداة لنفس الحصص المحددة لكل خطة مثل باقي حسابك — لا يمكن للمساعد تجاوز ما يمكنك القيام به بنفسك.
استكشاف الأخطاء وإصلاحها
Section titled “استكشاف الأخطاء وإصلاحها”| الأعراض | الأسباب المحتملة والحلول |
|---|---|
| يظهر على العميل رسالة «المصادقة مطلوبة» ولا يتم فتح أي شيء | قد لا يدعم العميل الخاص بك MCP OAuth — استخدم APIمفتاحًا (الخيار ب). |
Invalid API key | تم إلغاء المفتاح، أو انتهت صلاحيته، أو تمت كتابته بشكل خاطئ. قم بإنشاء مفتاح جديد من الحساب → المفاتيحAPI. |
Unknown or unavailable tool | الأداة خارج نطاقات مفتاحك، أو معطلة بواسطة أذونات الذكاء الاصطناعي أو أذونات الاتصال، أو مدمرة دون وجود كل من إذن الاتصال و ?destructive=true الاشتراك. |
| تعمل الأداة دون ظهور مطالبة بالتأكيد | يتم التحكم في المطالبة من خلال عميل MCP الخاص بك وإعدادات الموافقة الخاصة به. تعليقات الأداة، بما في ذلك destructiveHint، لا تضمن ظهور مطالبة. راجع الأذونات المخزنة وقواعد الموافقة التلقائية في ذلك العميل. |
| تم رفض أداة الكتابة مع ظهور رسالة الحد الأقصى | رفضتها بوابات الإجراءات من جانب CHAMPREPالخادم (الحدود اليومية، الحماية من إساءة الاستخدام) — توضح الرسالة السبب. حاول لاحقًا أو قلل من الحجم. |
| تظهر رسالة “انتهت صلاحية الجلسة” في صفحة الموافقة | استغرقت عملية الموافقة وقتًا طويلاً. أعد تشغيل عملية الاتصال من العميل. |
| يعمل في اختبار المتصفح ولكنه لا يعمل من الخادم/CI يعمل في اختبار المتصفح ولكنه لا يعمل من الخادم/CI | استخدم APIمفتاحًا — حيث إن تسجيل الدخول عبر المتصفح لا يصدر الرموز إلا بشكل تفاعلي. |
429 الردود | لقد وصلت إلى الحد الأقصى المسموح به في الدقيقة؛ تراجع وحاول مرة أخرى. |
نقطة النهاية: https://ai-api.champrep.com/mcp/v1.