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

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

يتيح خادم MCP في Metricgram لعملاء الذكاء الاصطناعي مثل Claude و ChatGPT و Cursor و Claude Code العمل مع مجموعاتك على Telegram: قراءة التحليلات وبيانات الأعضاء، ونشر الرسائل، والإشراف، وإدارة المواضيع. مع OAuth لا تحتاج إلى نسخ أي مفتاح. كل ما عليك هو لصق عنوان URL واحد، وتسجيل الدخول إلى Metricgram، والموافقة على الوصول.

خادم MCP متضمَّن في جميع الخطط المدفوعة وفي التجربة المجانية لمدة 14 يوما.

1. انسخ عنوان URL للخادم

افتح التكاملات > MCP في لوحة المدير وانسخ عنوان URL الموجود في مربع الاتصال عبر OAuth:

https://metricgram.com/api/v1/mcp

2. أضفه إلى عميل الذكاء الاصطناعي

• Claude: انتقل إلى Settings > Connectors > Add custom connector (الإعدادات > الموصلات > إضافة موصل مخصص)، والصق عنوان URL، ثم احفظ.
• Claude Code: شغّل claude mcp add --transport http metricgram https://metricgram.com/api/v1/mcp، ثم اكتب /mcp لتسجيل الدخول.
• ChatGPT و Cursor والعملاء الآخرون: أضف خادم MCP جديدا (تسميه بعض العملاء موصلا) بعنوان URL نفسه، واختر OAuth إذا طلب العميل طريقة للمصادقة.

3. سجّل الدخول ووافق على الوصول

يفتح عميلك صفحة من Metricgram في المتصفح. سجّل الدخول إذا لزم الأمر، وتحقق من اسم التطبيق وصلاحياته، ثم انقر على سماح. ستعود بعدها إلى عميلك ويكون الاتصال جاهزا.

تعرض الصفحة:

• التطبيق الذي يطلب الوصول، والعنوان الذي ستعود إليه.
• ما سيتمكن التطبيق من فعله: قراءة مجموعاتك وأعضائك ورسائلك وتحليلاتك وإعداداتك، وكتابة، أي التصرف في مجموعاتك عبر النشر أو الإشراف أو تغيير الإعدادات.
• تحذير عندما لا يكون Metricgram قد تحقق من التطبيق. لا تتابع إلا إذا كنت أنت من بدأ الاتصال.

4. جرّبه

اطلب من وكيلك شيئا مثل "لخّص نشاط هذا الأسبوع في مجموعتي" أو "ما الأعضاء الذين لم يكتبوا شيئا خلال آخر 30 يوما؟".

إدارة التطبيقات المتصلة

يظهر كل تطبيق توافق عليه ضمن التطبيقات المتصلة في صفحة MCP، مع صلاحياته وتاريخ ربطه. انقر على فصل لإلغاء وصوله فورا.

OAuth أم مفتاح API؟

استخدم OAuth كلما كان عميلك يدعمه: لا يوجد سر عليك حفظه، ويمكنك فصل التطبيق في أي وقت. أما العملاء الذين لا يدعمون OAuth، فأنشئ لهم مفتاح API من التكاملات > API واستخدم أمثلة الإعداد في صفحة MCP. تشرح مقالة الوصول إلى API و MCP كيفية عمل المفاتيح ونطاقات الصلاحيات.

حل المشكلات

• "يحتاج حسابك إلى خطة Metricgram نشطة لربط وكلاء الذكاء الاصطناعي عبر MCP.": يتطلب MCP خطة نشطة أو التجربة المجانية.
• "طلب الاتصال هذا غير صالح": انتهت صلاحية الطلب أو تم تعديله. ابدأ الاتصال من جديد من عميل الذكاء الاصطناعي.
• الوكيل لا يرى مجموعة ما: يقتصر الوصول على مجموعات Telegram التي تديرها في Metricgram. تأكد من أن المجموعة متصلة وأن البوت لا يزال مشرفا.
• الوكيل لا يستطيع النشر أو الإشراف: الاتصال لديه صلاحية القراءة فقط. افصله ثم اتصل مجددا من عميل يطلب صلاحية الكتابة.