إنتقل إلى المحتوى الرئيسي

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

بروتوكول سياق النموذج (MCP) هو معيار مفتوح لمنح مساعدي الذكاء الاصطناعي وصولًا آمنًا ومنظَّمًا إلى الأدوات والبيانات. بدلًا من كتابة كود ربط، توجّه مساعدًا مثل Claude إلى خادم MCP فيتمكن من اكتشاف الأدوات المتاحة واستدعائها نيابةً عنك. تكشف منتجات imatic عن خوادم MCP حتى يتمكن وكيل من إنجاز عمل حقيقي — التحقق من التوافر وحجز اجتماع، وإرسال استجابات الاستبيان وتلخيصها، وتشغيل استطلاع مباشر — باستخدام أذونات حسابك.

ما يمنحك MCP​

  • اكتشاف الأدوات — يسأل المساعد الخادم عمّا يمكنه فعله فيحصل على قائمة أدوات بأنواع محددة، فلا تكتب التكاملات يدويًا.
  • إجراءات حقيقية، لا مجرد دردشة — تقرأ الأدوات بياناتك الفعلية وتكتبها (ضمن النطاقات التي تمنحها).
  • بروتوكول واحد، منتجات كثيرة — يعمل نمط الاتصال نفسه مع Calendar وSurvey وVoice Portal.

أي أدوات يكشفها كل منتج​

Calendar​

يأتي Calendar مزوّدًا بخادم MCP إنتاجي بـ7 أدوات:

  • list_event_types — سرد أنواع الاجتماعات التي تقدّمها.
  • list_slots — العثور على الأوقات المتاحة لنوع فعالية في نافذة زمنية.
  • create_booking — حجز وقت لمدعوّ.
  • cancel_booking — إلغاء حجز.
  • reschedule_booking — نقل حجز إلى وقت جديد.
  • list_bookings — سرد الحجوزات الموجودة.
  • get_booking — قراءة حجز واحد بمعرّفه.

هذا يجعل Calendar مناسبًا بطبيعته لمساعد جدولة بالذكاء الاصطناعي: يمكنه اكتشاف أنواع فعالياتك، والتحقق من التوافر الحقيقي، والحجز دون حجز مزدوج. انظر Calendar للمطوّرين.

Survey​

يشغّل Survey خادم MCP مباشرًا على POST /mcp (JSON-RPC 2.0) بـ10 أدوات للعمل مع النماذج والاستجابات والاستطلاعات:

  • whoami — تحديد المستدعي المُصادَق عليه والمؤسسة.
  • list_forms — سرد النماذج في مؤسستك.
  • get_form — قراءة بنية نموذج واحد.
  • submit_response — إرسال استجابة لنموذج.
  • list_responses — سرد استجابات نموذج.
  • get_response — قراءة استجابة واحدة.
  • get_response_stats — تجميع إحصاءات استجابات نموذج.
  • create_poll — إنشاء استطلاع سريع.
  • cast_vote — الإدلاء بصوت في استطلاع.
  • live_poll_results — قراءة الإحصاء المباشر لاستطلاع.

انظر Survey للمطوّرين.

Voice Portal​

يقارب Voice Portal MCP من الاتجاه الآخر: فبدلًا من أن يكون خادم MCP (فقط)، يتيح لك تسجيل خوادم MCP خارجية حتى تتمكن وكلاء الصوت لديك من استخدام أدواتها أثناء مكالمة. في البوابة، اذهب إلى التكاملات ← خوادم MCP لتسجيل خادم، وتخزين بيانات اعتماده، واكتشاف وظائفه، وربط تلك الأدوات بوكيل. انظر الأدوات وMCP للوكلاء.

النقل​

يدعم Calendar MCP كلاً من HTTP وstdio، حتى تتمكن من ربط مساعد بعيد أو محلي؛ أما Survey MCP فيدعم HTTP (JSON-RPC) فقط.

  • HTTP — يتصل المساعد بنقطة نهاية الخادم /mcp عبر HTTPS. استخدم هذا للوكلاء المستضافين/البعيدين.
  • stdio — يعمل الخادم كعملية محلية يطلقها المساعد ويتحدث إليها عبر الإدخال/الإخراج القياسي. استخدم هذا لأدوات سطح المكتب المحلية.

المصادقة والعزل​

تعتمد بيانات الاعتماد التي يتوقعها خادم MCP على المنتج:

  • Calendar — يصادق بـمفتاح API ذي النطاقات يحمل النطاق mcp، مُرسَلًا كرمز حامل. تظل نطاقات المفتاح تحدّ ما يمكن لكل استدعاء أداة فعله، وتُحصر الاستدعاءات في مؤسسة المفتاح. اصكّ مفتاحًا مخصصًا لكل وكيل في للمطوّرين ← مفاتيح API.
  • Survey — يصادق بـJWT الخاص بالبوابة (رمز جلسة)، مُرسَلًا كرمز حامل. تحصر مؤسسة الرمز كل استدعاء، فلا يرى الوكيل أبدًا إلا نماذج تلك المؤسسة واستجاباتها.
  • Voice Portal — لا تصادق مع خادم MCP صوتي؛ بل تسجّل خوادم MCP خارجية في البوابة وتخزّن بيانات اعتمادها هناك (انظر أدناه).

في كل حالة، تُحصر الاستدعاءات في الحساب أو المؤسسة التي تنتمي إليها بيانات الاعتماد — لا يمكن لوكيل أن يصل إلى بيانات عميل آخر.

امنح الوكلاء أضيق بيانات اعتماد

بالنسبة لـ Calendar، أنشئ مفتاح API مخصصًا لكل وكيل بالنطاقات التي يحتاجها فقط، وتذكّر أن المفتاح يُعرض مرة واحدة فقط عند الإنشاء — انسخه حينها. إذا أساء وكيل التصرف أو تسرّب مفتاحه، أبطل ذلك المفتاح في منطقة المطوّرين دون التأثير على تكاملاتك الأخرى.

اتصل من Claude​

تقرأ عملاء MCP (مثل Claude Desktop) تكوين JSON صغيرًا يخبرهم كيف يصلون إلى خادم. الشكل أدناه توضيحي — استخدم نقطة النهاية الدقيقة وأي أعلام من صفحة المطوّرين الخاصة بالمنتج، والصق مفتاح API أنشأته لهذا الغرض:

{
  "mcpServers": {
    "imatic-calendar": {
      "url": "https://<calendar-host>/mcp",
      "headers": {
        "Authorization": "Bearer cal_abc123.s3cr3t_keymaterial"
      }
    }
  }
}

بالنسبة لاتصال محلي (stdio)، يطلق العميل أمر الخادم بدلًا من الاتصال برابط — مرة أخرى، اتبع صفحة المطوّرين الخاصة بالمنتج للأمر الدقيق. بمجرد الاتصال، اسأل المساعد عن الأدوات التي لديه؛ بالنسبة لـ Calendar يجب أن يُبلِغ عن الأدوات السبع المسرودة أعلاه، ويمكنك أن تطلب منه، على سبيل المثال، "اعثر على وقتي الحر التالي مدته 30 دقيقة واحجزه لـ alex@example.com."

ذات صلة​