ورشة مجانية 21–22.11ورشة مجانية لمدة يومين في Vibecoding يومي 21–22 نوفمبر الساعة 16:00 بتوقيت موسكو · الدفعة 3 تبدأ 23.11سجّل مجاناً ←الدفعة 3 (23.11)
إصدارتحليل · على الرادارHabr AI→ المصدر

كيف تدمج تطبيقك في ChatGPT: MCP Apps يعرض معرض صفحات التلوين داخل المحادثة مباشرة

كي يقيّم ChatGPT مخاطر إصدار يوم الجمعة، يحتاج إلى الوصول إلى GitHub ونظام تتبع المهام والتقويم، وهذا الجسر يبنيه MCP Server. لكن قراءة جدول من خمسين مهمة تقريبًا داخل المحادثة أمر غير مريح، وهنا يأتي دور MCP Apps الذي يعرض واجهة تفاعلية داخل الحوار نفسه. بهذه الطريقة دمج المؤلف في ChatGPT معرضًا لصفحات التلوين مبنيًا على React وSupabase. وللحصول على ملخص قصير يكفي الخادم، أما للمرشحات والإجراءات فيلزم MCP Apps.

معالج بواسطة الذكاء الاصطناعي من Habr AI؛ بتحرير Hamidun News
كيف تدمج تطبيقك في ChatGPT: MCP Apps يعرض معرض صفحات التلوين داخل المحادثة مباشرة
المصدر: Habr AI. كولاج: Hamidun News.
استمع للمقال
بطاقة الحقائق والأرقام
المعيارالتفاصيل
المصدر الأصليHabr AI ↗
رئيس التحرير
حقيقة رئيسية #1يعمل الخادم بوصفه Supabase Edge Function ويستخدم قاعدة PostgreSQL نفسها
حقيقة رئيسية #2حذف صفحة التلوين يتطلب نافذة تأكيد والمعامل DELETE
الواجهة تحمّل الصور المصغّرة بنفسهاالنموذج يتلقى المعرّفات فقط

تخيّل أن مدير مشروع يسأل الذكاء الاصطناعي: «ما المخاطر التي تهدد إصدار يوم الجمعة؟ افحص المهام غير المغلقة وطلبات الدمج (PR) التي لم تُراجَع والمواعيد النهائية القريبة». البيانات موزعة بين GitHub ونظام داخلي لتتبع المهام وتقويم الشركة، ومن دون الاتصال بها لا يستطيع النموذج الإجابة. لمثل هذه الاتصالات وُجد بروتوكول Model Context Protocol (MCP). وحين لا يكفي الرد النصي ويحتاج المستخدم إلى تصفح الصور أو تصفية المهام أو تنزيل ملف، يعمل الامتداد MCP Apps فوق MCP. وقد عرض مؤلف المقال على Habr الجزأين على مشروع حي. وهو مرجع مفيد لمن يخطط لدمج تطبيقه في عملاء الذكاء الاصطناعي.

ماذا يفعل MCP Server

لا يحلّ MCP محل واجهات API القائمة. فهو يوفّر واجهة موحّدة يعثر من خلالها عميل الذكاء الاصطناعي على الأدوات (tools) والموارد (resources) ويستدعيها. وداخليًا يتواصل الخادم بنفسه مع واجهات REST أو GraphQL وقاعدة البيانات وغيرها من الخدمات الخاصة بك. وتبقى منطق الأعمال والتحكم في الوصول في يد الشركة.

ففي مثال الإصدار يمكن إنشاء خادم واحد بأداة مثل get_release_readiness. تجمع هذه الأداة المهام غير المغلقة، وتفحص طلبات الدمج التي لم تُراجَع، وتطابق المواعيد النهائية، ثم تعيد ملخصًا. والخيار الآخر هو عدة خوادم مستقلة، واحد لكل نظام. ويعتمد الاختيار على المكان الأنسب لاحتضان منطق دمج البيانات ومعالجة الأخطاء. وميزة هذا النهج أن خادمًا واحدًا يعمل مع عملاء مختلفين يدعمون البروتوكول. لكن إمكانات هؤلاء العملاء وقيودهم تختلف.

ماذا يضيف MCP Apps

عادةً يعيد الخادم JSON، مثل «الإصدار 2.4.0، 3 مهام معطِّلة، 5 طلبات دمج بلا مراجعة، الحالة at_risk»، ثم يعيد النموذج سرده نصًا. وهذا يكفي لملخص صغير. لكن عشرات المهام والتصفية حسب الفرق ومقارنة الإصدارات أمور غير عملية في النص، كما أن الأسئلة التوضيحية المتتالية للنموذج مرهقة. يربط MCP Apps الأداة بمورد واجهة (UI). ويحمّل العميل الواجهة ويعرض جدولًا أو بطاقات أو مخططًا أو نموذجًا داخل المحادثة مباشرة.

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

مثال: معرض صفحات التلوين في ChatGPT

استخدم المؤلف خدمته الخاصة للحكايات وصفحات التلوين المخصصة، المبنية على React وTypeScript وSupabase. ولم ينقل التطبيق كله، بل أبقى في المحادثة ثلاثة إجراءات على صفحات التلوين الجاهزة: العرض والتنزيل والحذف. وعند الطلب «أرني أحدث صفحات التلوين الخاصة بي» يستدعي ChatGPT الأداة get_coloring_gallery، فيُفتح المعرض داخل الحوار.

كيف يعمل ذلك:

  • يعمل MCP Server بوصفه Supabase Edge Function على حزمة @modelcontextprotocol/server، ويستخدم قاعدة PostgreSQL نفسها التي يستخدمها التطبيق الرئيسي.
  • تتم المصادقة عبر Supabase Auth بواسطة OAuth. والوصول مقيّد بالحساب العائلي، كما يجري التحقق من ملكية الصور على الخادم أيضًا.
  • ترتبط الأداة بالواجهة عبر _meta.ui.resourceUri. أما الواجهة نفسها فتُسجَّل مورداً مستقلاً بنوع mimeType هو text/html;profile=mcp-app.
  • تُبنى React وCSS عبر esbuild وتُضمَّن في HTML، ولذلك لا حاجة إلى ملف JavaScript خارجي. وتعمل الواجهة في بيئة معزولة ولا تحصل على وصول اعتباطي إلى صفحة ChatGPT.
  • على جانب العميل تُستخدم حزمة @modelcontextprotocol/ext-apps: يتصل الكائن App بالمضيف، ويتلقى نتيجة الأداة، ويستجيب لتبديل السمة بين الفاتحة والداكنة.

نقل البيانات مصمَّم بحيث يكون مقتصدًا. فأداة المعرض لا تعيد سوى معرّفات صفحات التلوين، أما الصور المصغّرة فتحمّلها React بنفسها عبر أداة مساعدة هي get_coloring_gallery_thumbnail وعليها الوسم visibility: ['app']. وبذلك لا تمر الصور الثقيلة عبر النموذج، ويكفيه الحصول على قائمة المعرّفات.

يعمل التنزيل عبر الأداة get_coloring_image والدالة app.downloadFile(). يتلقى التطبيق ملف PNG من الخادم ويسلّم الملف إلى المضيف، من دون رابط إلى التخزين الخاص. أما الحذف فهو أكثر صرامة لأنه يغيّر البيانات. تظهر أولًا نافذة تأكيد، ولا تُستدعى الأداة delete_coloring مع المعامل confirmation: 'DELETE' إلا بعد موافقة المستخدم. وعمليات القراءة وعمليات التعديل مفصولة على الخادم.

القيود والخلاصة

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

والقاعدة العملية بسيطة. إذا كان المستخدم يكتفي بإجابة أو بملخص قصير، فابنوا MCP Server فقط. وإذا لزمت المرشحات أو اختيار عدة عناصر أو الملفات أو تأكيد الإجراءات الخطرة، فأضيفوا MCP Apps. وقبل ذلك قدّروا ما إذا كانت هذه الواجهة تستحق كلفة صيانتها.

القصة

أسئلة وأجوبة حول الخبر

ما أبرز التفاصيل حول ماذا يفعل MCP Server؟

لا يحلّ MCP محل واجهات API القائمة. فهو يوفّر واجهة موحّدة يعثر من خلالها عميل الذكاء الاصطناعي على الأدوات (tools) والموارد (resources) ويستدعيها. وداخليًا يتواصل الخادم بنفسه مع واجهات REST أو GraphQL وقاعدة البيانات وغيرها من الخدمات الخاصة بك. وتبقى منطق الأعمال والتحكم في الوصول في يد الشركة. ففي مثال الإصدار يمكن إنشاء خادم واحد بأداة مثل get_release_readiness. تجمع هذه الأداة المهام غير المغلقة، وتفحص طلبات الدمج التي لم تُراجَع، وتطابق المواعيد النهائية، ثم تعيد ملخصًا.

ما أبرز التفاصيل حول ماذا يضيف MCP Apps؟

عادةً يعيد الخادم JSON، مثل «الإصدار 2.4.0، 3 مهام معطِّلة، 5 طلبات دمج بلا مراجعة، الحالة at_risk»، ثم يعيد النموذج سرده نصًا. وهذا يكفي لملخص صغير. لكن عشرات المهام والتصفية حسب الفرق ومقارنة الإصدارات أمور غير عملية في النص، كما أن الأسئلة التوضيحية المتتالية للنموذج مرهقة. يربط MCP Apps الأداة بمورد واجهة (UI). ويحمّل العميل الواجهة ويعرض جدولًا أو بطاقات أو مخططًا أو نموذجًا داخل المحادثة مباشرة. والأدوار هنا موزعة. الخادم مسؤول عن العمليات والبيانات والمصادقة والاتصال بالأنظمة الخارجية.

ما أبرز التفاصيل حول مثال: معرض صفحات التلوين في ChatGPT؟

استخدم المؤلف خدمته الخاصة للحكايات وصفحات التلوين المخصصة، المبنية على React وTypeScript وSupabase. ولم ينقل التطبيق كله، بل أبقى في المحادثة ثلاثة إجراءات على صفحات التلوين الجاهزة: العرض والتنزيل والحذف. وعند الطلب «أرني أحدث صفحات التلوين الخاصة بي» يستدعي ChatGPT الأداة get_coloring_gallery، فيُفتح المعرض داخل الحوار. كيف يعمل ذلك: يعمل MCP Server بوصفه Supabase Edge Function على حزمة @modelcontextprotocol/server، ويستخدم قاعدة PostgreSQL نفسها التي يستخدمها التطبيق الرئيسي.

ZK
جمال حميدون — مدير المنتجات في Alpina Digital ومدير منتج AlpinaGPT. يبني منتجات الذكاء الاصطناعي منذ 2019. بدأ Hamidun News كمشروع شخصي ثم أصبح مُجمِّعًا إنتاجيًا بأكثر من 6000 قارئ.
✦ Hands-On AI Engineering · Hamidun Academy

Build & Ship Production AI Agents Without Boilerplate Code

Start your free 72-hour trial at Hamidun Academy (academy.hamidun.com) — interactive lessons on Claude Code & Cursor, live Tech Radar, and production agent templates.

Start 72h Free Trial →Vibe-Coding Intensive
ما رأيك؟
جارٍ تحميل التعليقات…