كيف تربط فريقي بـ Claude وChatGPT وCodex وأدواتك الأخرى عبر MCP

ما الذي يفعله هذا الربط؟

يصل مساعدك الذكي إلى مساحة عملك في فريقي عبر بروتوكول MCP المفتوح، فيقرأ مشاريعك، وقوائم مهامك، ومهامك، ونقاشات المجلس، وملفاتك، وينشئ فيها ويعدّل بحسب ما تسمح به. تقول له «ما مهامي المتأخرة؟» أو «حوّل هذه الملاحظات إلى قائمة مهام في مشروع الإطلاق»، فينفّذ داخل فريقي مباشرة، ويرد عليك برابط يفتح السجل.

عنوان الربط واحد في كل الأدوات: https://app.fareeqy.com/api/mcp

ماذا يحدث عند الربط؟

1. تضيف فريقي في أداتك، من دليل الـ connectors في Claude أو بالعنوان في غيره، فتفتح لك صفحة فريقي في المتصفح.
2. سجّل الدخول إلى فريقي إن لم تكن مسجّلاً.
3. تظهر صفحة «ربط التطبيق بفريقي»، وفيها اسم التطبيق، والنطاق الذي ستعود إليه بعد الموافقة.
4. اختر «قراءة فقط» أو «قراءة وكتابة»، ولتحديد الأدوات أداةً بأداة افتح «الصلاحيات المتقدمة». أدوات الحذف والأدوات الحساسة غير محددة إلا إذا اخترتها بنفسك.
5. اضغط «السماح بالربط»، فتعود إلى أداتك وقد اكتمل الربط.

ملاحظة: يعمل المساعد بصلاحياتك أنت، لا أكثر. فلا يصل إلى مشروع لا تستطيع فتحه، ولا ينفّذ ما لا يسمح به دورك في الشركة.

Claude (claude.ai وClaude Desktop والجوال)

6. افتح Customize ثم Connectors، واضغط Discover.
7. اكتب Fareeqy في Search connectors، وافتح «Fareeqy | فريقي».
8. اضغط Connect to Claude، وأكمل الموافقة في صفحة فريقي.
9. يظهر فريقي بعدها في claude.ai وClaude Desktop وتطبيق الجوال بالحساب نفسه.

نصيحة: في خطط Claude للفرق والمؤسسات، يضيف مالك الحساب الـ connector أولاً من إعدادات الإدارة، ثم يضغط كل عضو Connect to Claude ويوافق بحسابه في فريقي.

ملاحظة: لا تجد فريقي في الدليل؟ اضغط + بجانب Connectors ثم Add custom connector، واكتب الاسم «فريقي»، والصق العنوان https://app.fareeqy.com/api/mcp، ثم أكمل بالطريقة نفسها.

Claude Code

10. شغّل في الطرفية: claude mcp add --transport http fareeqy https://app.fareeqy.com/api/mcp (وأضف --scope user ليعمل في كل مشاريعك).
11. افتح Claude Code واكتب /mcp، ثم اختر fareeqy واضغط Authenticate.
12. وافق في صفحة فريقي التي تفتح في المتصفح.

ChatGPT

13. افتح Settings ثم Apps & Connectors، وفعّل Developer mode من الإعدادات المتقدمة.
14. أنشئ connector جديداً باسم «فريقي»، والصق العنوان، واختر OAuth للمصادقة.
15. وافق في صفحة فريقي، ثم فعّل فريقي من قائمة الأدوات في المحادثة.

ملاحظة: في حسابات ChatGPT للشركات قد يلزم أن يسمح المسؤول بالـ connectors المخصصة أولاً. وقد تختلف أسماء القوائم قليلاً بين الإصدارات.

Codex

16. شغّل: codex mcp add fareeqy --url https://app.fareeqy.com/api/mcp
17. ثم: codex mcp login fareeqy، ووافق في صفحة فريقي.
18. يعمل الإعداد نفسه في Codex داخل VS Code لأنه يقرأ الملف ~/.codex/config.toml ذاته.

VS Code وCursor

• VS Code: ابحث عن @mcp fareeqy في Extensions واضغط Install، أو استخدم الأمر MCP: Add Server واختر HTTP والصق العنوان. ثم وافق عند أول استخدام.
• Cursor: أضف فريقي إلى ~/.cursor/mcp.json بالحقل url والعنوان نفسه، ثم اضغط Connect بجانبه في Settings ثم MCP.

أداة لا تدعم تسجيل الدخول (OAuth)

أنشئ رمز وصول من «إعدادات الحساب» ثم تبويب «المساعد الذكي (MCP)»، واختر صلاحياته، ثم أضفه في أداتك كـ header باسم Authorization وقيمة Bearer متبوعة بالرمز. تجد في التبويب نفسه إعدادات جاهزة للنسخ لأشهر الأدوات.

مراجعة الربط أو إلغاؤه

19. افتح «إعدادات الحساب» من قائمة الصورة الرمزية، ثم تبويب «المساعد الذكي (MCP)».
20. يظهر كل ربط باسمه، وبجانبه «تطبيق متصل عبر OAuth».
21. عدّل صلاحياته أداةً بأداة، أو ألغِه فيتوقف فوراً. وسجل الاستدعاءات يعرض كل ما فعله، ما نجح منه وما رُفض.

• يبقى الربط يعمل دون أن تسجّل الدخول مرة أخرى. وإذا لم يُستخدم 90 يوماً، تعيد الربط من أداتك.
• في الأدوات التي تدعم ذلك، يسألك التطبيق قبل تنفيذ أي حذف، فلا يحذف المساعد شيئاً دون علمك.
• لكل خطة حد يومي لاستدعاءات MCP، تجده في صفحة الأسعار.

إذا لم يكتمل الربط

• «انتهت صلاحية طلب الربط»: طلب الموافقة صالح لدقائق. ارجع إلى أداتك وابدأ الربط من جديد.
• «ربط التطبيقات الخارجية غير متاح لشركتك حالياً»: تواصل معنا لتفعيله لشركتك.
• يرفض المساعد أداة بعينها: لم تحددها عند الموافقة. أضفها من تبويب «المساعد الذكي (MCP)» دون إعادة الربط.

النتيجة؟ يعمل مساعدك داخل فريقي لا بجانبه، وتبقى أنت من يحدد ما يستطيع فعله.