MCP Reference: chatmcp.googleapis.com

توفّر Chat MCP API بروتوكول سياق النموذج (MCP) عن بُعد لميزات Google Chat.

يعمل خادم بروتوكول سياق النموذج (MCP) كوكيل بين خدمة خارجية توفّر السياق أو البيانات أو الإمكانات لنموذج لغوي كبير (LLM) أو تطبيق ذكاء اصطناعي. تربط خوادم بروتوكول سياق النموذج (MCP) تطبيقات الذكاء الاصطناعي بالأنظمة الخارجية، مثل قواعد البيانات وخدمات الويب، وتحوّل ردودها إلى تنسيق يمكن لتطبيق الذكاء الاصطناعي فهمه.

إعداد الخادم

يجب إعداد خادم بروتوكول سياق النموذج (MCP) في Chat قبل استخدامه. لمزيد من المعلومات حول استخدام خوادم بروتوكول سياق النموذج (MCP) عن بُعد من Google وGoogle Cloud، يُرجى الاطّلاع على نظرة عامة على خوادم بروتوكول سياق النموذج (MCP) في Google Cloud.

نقاط نهاية الخادم

نقطة نهاية خدمة بروتوكول سياق النموذج (MCP) هي عنوان الشبكة وواجهة الاتصال (عادةً عنوان URL) لخادم بروتوكول سياق النموذج (MCP) الذي يستخدمه تطبيق الذكاء الاصطناعي (المضيف لعميل بروتوكول سياق النموذج (MCP)) لإنشاء اتصال آمن وموحّد. وهي نقطة الاتصال التي يستخدمها النموذج اللغوي الكبير لطلب السياق أو استدعاء أداة أو الوصول إلى مورد. يمكن أن تكون نقاط نهاية بروتوكول سياق النموذج (MCP) من Google عالمية أو إقليمية.

يحتوي خادم بروتوكول سياق النموذج (MCP) في Chat API على نقطة نهاية بروتوكول سياق النموذج (MCP) العالمية التالية:

  • https://chatmcp.googleapis.com/mcp/v1

أدوات بروتوكول سياق النموذج (MCP)

أداة بروتوكول سياق النموذج (MCP) هي دالة أو إمكانية قابلة للتنفيذ يعرضها خادم بروتوكول سياق النموذج (MCP) لنموذج لغوي كبير أو تطبيق ذكاء اصطناعي لتنفيذ إجراء في العالم الحقيقي.

الأدوات

يحتوي خادم بروتوكول سياق النموذج (MCP) في chatmcp.googleapis.com على الأدوات التالية:

أدوات بروتوكول سياق النموذج (MCP)
list_messages يستردّ الرسائل من محادثة محدّدة على Google Chat (مساحة أو رسالة مباشرة أو رسالة مباشرة جماعية). يسمح بالفلترة حسب السلسلة الزمنية والنطاق الزمني وعدد الرسائل. بالإضافة إلى ذلك، يمكن استرداد الصفحة التالية من الرسائل للحصول على مزيد من السياق. تتم فلترة الرسائل الخاصة (الرسائل التي لا يراها سوى مستخدم واحد).
search_conversations

يبحث عن محادثات Google Chat حسب الاسم المعروض.

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

إذا تم تقديم طلب بحث فقط، تبحث هذه الأداة عن المحادثات التي يكون فيها طلب البحث سلسلة فرعية غير حساسة لحالة الأحرف من الاسم المعروض للمحادثة.

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

إذا لم يتم تقديم المشاركين أو طلب البحث، تسرد هذه الأداة جميع المحادثات التي يكون المستخدم الذي يستدعي الأداة عضوًا فيها.

لا تسرد هذه الأداة سوى المحادثات التي يكون المستخدم الذي يستدعي الأداة عضوًا فيها.

ملاحظة مهمة: لا تعني قائمة "المحادثات" الفارغة أنّه ما مِن نتائج أخرى بشكل عام. إذا كان الرمز "next_page_token" متوفرًا، يمكن جلب المزيد من الصفحات. إذا ظهرت لك قائمة فارغة ولكن ظهر الرمز "next_page_token"، اسأل المستخدم عمّا إذا كان يجب مواصلة البحث.

الحصول على مواصفات أداة بروتوكول سياق النموذج (MCP)

للحصول على مواصفات أداة بروتوكول سياق النموذج (MCP) لجميع الأدوات في خادم بروتوكول سياق النموذج (MCP)، استخدِم طريقة tools/list. يوضّح المثال التالي كيفية استخدام curl لسرد جميع الأدوات ومواصفاتها المتوفّرة حاليًا في خادم بروتوكول سياق النموذج (MCP).

طلب Curl 
curl --location 'https://chatmcp.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'