يدعم Gemini بروتوكول سياق النموذج (Model Context Protocol)، لكن كل واجهة تتعامل معه بطريقة مختلفة. يقارن هذا المقال بين Gemini CLI وواجهة Gemini API وحزمة SDK، والوكلاء المُدارين، وتطبيق Gemini وGemini Enterprise، مع حقول الإعدادات والأوامر والحدود ومثال Python عملي.
نعم، يدعم Gemini بروتوكول سياق النموذج (Model Context Protocol)، لكن الجواب يتغيّر بحسب الباب الذي تدخل منه. يتعامل Gemini CLI مع MCP كميزة مدمجة. تصل واجهة Gemini API إليه عبر عميل SDK تجريبي، وفي مرحلة المعاينة عبر الوكلاء المُدارين. يقبل تطبيق Gemini الخوادم البعيدة لفئة ضيقة من المستخدمين فقط، وتترك Gemini Enterprise الإعداد للمسؤولين. وإذا أعطتك ثلاثة نقاشات في المنتديات ثلاث إجابات مختلفة، فمن المرجّح أنها كانت كلها صحيحة لكن عن منتجات مختلفة.
يستعرض هذا المقال كل مسار وفق ما توثّقه Google حتى أكتوبر 2026. ستعرف أي مسار يشغّل عملية محلية، وأيها يحتاج إلى عنوان HTTPS عام، وأين تقع حدود النموذج، وأي الحسابات يمكنها استخدام كل خيار. يتضمن المقال ملف إعدادات عملي، ومثال Python، وجدول قرار، وقائمة قصيرة بالأخطاء التي تهدر أكثر الوقت.
MCP، أي بروتوكول سياق النموذج (Model Context Protocol)، معيار مفتوح يتيح لمساعد الذكاء الاصطناعي استدعاء الأدوات وقراءة الموارد من خادم منفصل. تكتب الخادم مرة واحدة، ويمكن لأي عميل MCP استخدامه. يلعب Gemini دور العميل بخمسة أشكال مختلفة، ولكل شكل قواعده الخاصة فيما يخص مكان الخادم، ومن يسجّل الدخول، وما الذي يُسمح للنموذج بالوصول إليه.
| الواجهة | دعم MCP | موقع الخادم | الحالة |
|---|---|---|---|
| Gemini CLI | مدمج | عملية محلية أو عنوان URL بعيد | موثّق |
| Gemini API مع حزمتي Python وJS SDK | الجلسة تُمرَّر كأداة | أينما تستطيع شيفرتك الاتصال | تجريبي |
| الوكلاء المُدارون في Gemini API | أداة mcp_server | خوادم بعيدة | معاينة |
| تطبيق Gemini، على الويب والجوال | تطبيقات مخصصة | خوادم HTTPS بعيدة | أهلية محدودة |
| Gemini Enterprise | خادم MCP مخصص | خوادم بعيدة | إعداد من المسؤول |
💡 قاعدة سريعة: يمكن فقط عبر Gemini CLI أو شيفرتك الخاصة في SDK تشغيل خادم MCP محلي. كل مسار آخر يحتاج إلى عنوان URL.
يُعدّ Gemini CLI الأكثر قدرة بين عملاء MCP في هذه العائلة. يدعم ثلاث وسائل نقل (stdio وSSE وstreamable HTTP)، ولا يقتصر على الأدوات، إذ تظهر موارد الخادم وأوامره الجاهزة داخل الجلسة أيضًا. وبالنسبة لمن يختبر خادمًا جديدًا، فهذا أقصر طريق من الفكرة إلى أول استدعاء ناجح.
تأتي CLI بمجموعة صغيرة من الأوامر لإدارة الخوادم:
gemini mcp add [options] <name> <commandOrUrl> [args...]
gemini mcp list
gemini mcp remove <name>
gemini mcp enable <name>
gemini mcp disable <name>
يعرض الأمر gemini mcp list كل خادم مُعدّ مع حالة اتصاله، ما يجعله أسرع فحص سلامة بعد أي تعديل. وإذا فضّلت التحرير يدويًا، فالخوادم تُحفظ في كائن mcpServers داخل ملف settings.json الخاص بك، إما على مستوى المستخدم (~/.gemini/settings.json) أو على مستوى المشروع (.gemini/settings.json):
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "./docs"],
"timeout": 30000
},
"remote-tools": {
"httpUrl": "https://example.com/mcp",
"headers": { "Authorization": "Bearer YOUR_TOKEN" },
"includeTools": ["search_docs"]
}
}
}
يشغّل المدخل الأول خادمًا محليًا عبر stdio. أما الثاني فيتصل بخادم بعيد عبر streamable HTTP ويعرض أداة واحدة فقط، ما يُبقي خيارات النموذج قليلة ويمكن التنبؤ بها.
يحتاج كل مدخل خادم إلى حقل نقل واحد، وكل ما عداه اختياري:
command: الملف التنفيذي لخادم stdio المحلي، ومعه args وcwd وenv بجانبه. يمكن للقيم في env أن تشير إلى متغيرات باستخدام $VAR_NAME، فتبقى التوكنات خارج الملف.url: نقطة نهاية SSE.httpUrl: نقطة نهاية streamable HTTP.headers: ترويسات HTTP مخصصة لوسيلتي النقل المعتمدتين على عنوان URL.timeout: مهلة الطلب بالمللي ثانية، وقيمتها الافتراضية 600,000.includeTools وexcludeTools: قائمة سماح وقائمة منع لأسماء الأدوات.trust: عند ضبطه على true تُتجاوز نوافذ تأكيد الأدوات.authProviderType: يحدد موفّر المصادقة: البحث التلقائي عن نقطة نهاية OAuth، أو بيانات اعتماد Google (google_credentials)، أو انتحال حساب الخدمة (service_account_impersonation).💡 لا تفعّل
trustلأي خادم لم تكتبه بنفسك. نافذة التأكيد هي آخر نقطة تفتيش قبل تشغيل أي أداة.
بمجرد تشغيل CLI، يعرض /mcp حالة كل خادم وأدواته وموارده وأوامره الجاهزة. ويتولى /mcp auth [serverName] المصادقة عبر OAuth، بينما يفعّل /mcp enable و/mcp disable خادمًا أو يوقفه للجلسة الحالية فقط.
هناك بعض السلوكيات التي تفاجئ الناس في المرة الأولى:
mcp_{serverName}_{toolName}، وهذا يمنع التعارض بين الخوادم والأدوات المدمجة.@server://resource/path داخل أمرك النصي.~/.gemini/mcp-oauth-tokens.json، ويُدعم كذلك Google Application Default Credentials.لا تفتح واجهة Gemini API اتصالات بخادمك بمفردها، بل تتولى ذلك حزمة SDK. فهي تتصل بالخادم، وتطلب قائمة أدواته، وتسلّمها للنموذج كدوال قابلة للاستدعاء. وفي مستودع python-genai، تصف Google دعم MCP المدمج هذا بأنه ميزة تجريبية، وقد وُسم المثال بأنه مخصص لواجهة Gemini Developer API فقط، وليس لمنصة Enterprise Agent Platform.
يحتاج النمط إلى حزمة mcp بجانب google-genai. تفتح جلسة عميل مع خادم، ثم تمرّر هذه الجلسة مباشرة إلى إعدادات التوليد:
import asyncio
from google import genai
from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client
client = genai.Client() # reads the API token from the environment
server = StdioServerParameters(
command="npx",
args=["-y", "@modelcontextprotocol/server-filesystem", "./docs"],
)
async def main():
async with stdio_client(server) as (read, write):
async with ClientSession(read, write) as session:
await session.initialize()
response = await client.aio.models.generate_content(
model="gemini-flash-latest",
contents="List the markdown files in the docs folder.",
config=genai.types.GenerateContentConfig(tools=[session]),
)
print(response.text)
asyncio.run(main())
بما أن شيفرتك هي التي تحتفظ بالجلسة، فإن الاتصال يعمل داخل عمليتك أنت. ولهذا يعمل هذا المسار مع الخوادم المحلية. والثمن هو عمل إضافي لإدارة دورة الحياة: تفتح الجلسة، ثم تهيّئها، ثم تنفّذ الاستدعاء، ثم تغلقها.
في 7 يوليو 2026، أعلنت Google عن MCP البعيد للوكلاء المُدارين في Gemini API. فبدلًا من كتابة وسيط بروكسي، تمرّر أداة mcp_server وقت التفاعل، بجانب أدوات مثل Google Search أو تنفيذ الشيفرة. تنتقل بيانات الاعتماد عبر ترويسات مخصصة، لذا يمكن لترويسة Authorization أن تحمي نقطة النهاية الخاصة بك. ثم يستدعي الوكيل نقاط نهايتك من بيئته المعزولة الآمنة.
تستخدم أمثلة الإعلان الوكيل antigravity-preview-05-2026، وما زالت الميزة في مرحلة المعاينة، لذا توقّع أن تتغير التفاصيل.
تذكر نظرة عامة واجهة Interactions API قيدًا بوضوح: لا يدعم Gemini 3 MCP البعيد، وتشير الصفحة إلى أن الدعم قادم قريبًا. وتصف Google الوكلاء المُدارين ومسار النموذج العادي بوصفهما قدرتين منفصلتين، لذا اقرأ حدود الواجهة الدقيقة التي تستدعيها. ومسار SDK المذكور أعلاه مختلف مرة أخرى، لأن الاتصال يعيش في شيفرتك، لكن اختبره مع النموذج المستهدف قبل أن تبني عليه.
💡 عندما تبدو صفحة توثيق وإعلان متعارضَين، تحقّق من التاريخ. ميزات المعاينة تتغير بسرعة، والصفحة الأقدم هي غالبًا التي تتأخر.
تسرد مساعدة تطبيقات Gemini الشروط اللازمة لإضافة خادم MCP خاص بك إلى تطبيق Gemini:
تحتاج إجراءات الكتابة حاليًا إلى تأكيد يدوي، لذا يسألك التطبيق قبل أن تعدّل أي أداة شيئًا أو ترسله أو تحذفه. وهذا خيار افتراضي معقول لمنتج استهلاكي، حتى لو أبطأ سلسلة طويلة من الخطوات.
تصف صفحة المساعدة طريقة إضافة خادم من تطبيق الويب:
يتيح التسجيل الديناميكي للعميل أن يسجّل العميل نفسه لدى موفّر OAuth الخاص بالخادم. وبدونه، تنشئ العميل أولًا لدى الموفّر، ثم تلصق بيانات الاعتماد في Gemini.
تحصل المؤسسات على مسار منفصل. توثّق Google Cloud توصيل خادم MCP مخصص إلى Gemini Enterprise، ويتولى المسؤول الإعداد، وليس كل موظف على حدة. وتفيد مقالات من المجتمع تلخّص ملاحظات الإصدار بأنه منذ 15 يونيو 2026 يمكن لخادم MCP مخصص أن يتحقق من هويته بتوكن وصول لحساب خدمة في Google Cloud، وهذا مناسب للخوادم الداخلية التي لا تصادف أبدًا شاشة تسجيل دخول بشرية.
أعلنت Google أيضًا عن دعم MCP رسمي لخدماتها الخاصة، لذا قد تكون بعض الخوادم التي يحتاجها فريقك موجودة مسبقًا كنقاط نهاية مُدارة. تحقّق من ذلك قبل أن تبني خادمًا مخصصًا.
يعتمد أفضل خيار على مكان تشغيل خادمك ومن هو المستخدم. استخدم هذا الجدول كمرشّح أولي:
| ما تحتاجه | أفضل مسار | السبب |
|---|---|---|
| ملفات محلية وأدوات الطرفية | Gemini CLI | خوادم stdio تعمل على جهازك الخاص |
| واجهة خلفية بلغة Python أو JS بمنطق مخصص | جلسة SDK | شيفرتك تتحكم في الحلقة كاملة |
| وكيل مستضاف يستدعي نقاط نهاية بعيدة | الوكلاء المُدارون | لا توجد طبقة بروكسي، وما زالت في المعاينة |
| مساعد شخصي بأدواتك الخاصة | تطبيق Gemini | عنوان URL فقط، والإنجليزية الأمريكية، وحساب شخصي |
| نشر على مستوى الشركة | Gemini Enterprise | يدير المسؤولون الاتصالات |
هناك نمطان يتكرران كثيرًا. يبني المطورون النماذج الأولية في Gemini CLI لأن حلقة التغذية الراجعة أمر واحد فقط، ثم ينقلون الخادم نفسه إلى عنوان URL بعيد بعد أن يعمل. وهذا الانتقال يكلّف قليلًا جدًا، لأن الخادم المكتوب لعميل MCP واحد يتصرف عادةً بالطريقة نفسها مع عميل آخر. أما الفرق الذين يبدؤون من التطبيق فيكتشفون غالبًا مبكرًا أنهم غير مؤهلين، لأن شروط الولايات المتحدة والحساب الشخصي والإنجليزية تستبعد كثيرًا من بيئات العمل.
في Gemini CLI، يعني url وسيلة SSE، ويعني httpUrl وسيلة streamable HTTP. أي خادم يستخدم streamable HTTP لكنه موضوع تحت url سيفشل في الاتصال، ونادرًا ما تذكر رسالة الخطأ السبب. تحقّق من وسيلة النقل التي يوثّقها خادمك، ثم طابق الحقل معها. ويعرض gemini mcp list حالة الاتصال فورًا.
ضبط trust على true يتجاوز نوافذ التأكيد، وهذا يبدو رائعًا حتى تفعل أداة شيئًا لم تتوقعه. ابدأ بتفعيل التأكيدات. واستخدم includeTools لعرض الأدوات التي تحتاجها المهمة فقط، ووسّع القائمة بعد أن تراقب سلوك الخادم.
يأخذ تطبيق Gemini عنوان URL لا أمرًا. ولا يمكن الوصول من هناك إلى خادم على حاسوبك المحمول. انشره خلف HTTPS أولًا، ثم الصق هذا العنوان تحت Connected Apps. وإذا كان الخادم يحتاج إلى OAuth ولا يدعم التسجيل الديناميكي للعميل، فجهّز بيانات اعتماد العميل قبل أن تبدأ.
تتطلب مشاريع MCP كتابةً كثيرة: كتل الإعدادات، وأوصاف الأدوات، والأوامر النصية للاختبار، وملاحظات المراجعة. تستضيف PicassoIA عدة نماذج من Gemini ضمن فئة النماذج اللغوية الكبيرة، من بينها Gemini 3.5 Flash للمسودات السريعة، وGemini 3 Flash للدردشة السريعة، وGemini 3.1 Pro وGemini 3 Pro للمراجعات الأصعب. في سير العمل هذا، تكون PicassoIA مكتب الصياغة. أما اتصال MCP نفسه فما زال يتم في واجهة Gemini التي اخترتها أعلاه.
settings.json تستخدم httpUrl.excludeTools لجلسة للقراءة فقط؟"/mcp.💡 الأوامر النصية المحددة تعطي نتائج أفضل دائمًا. "اكتب إعدادًا لخادم بعيد بترويسة bearer وأداة مسموحة واحدة" أفضل من "اضبط MCP" في كل مرة.
ليس MCP للنصوص والشيفرة فقط. يستطيع فريق إبداعي توصيل مولّد صور أو فيديو كأداة، فينتج المساعد مواد مرئية ضمن مهمة أطول، مثل كتابة منشور وتوليد صورته الرئيسية في الجلسة نفسها.
تقدم PicassoIA واجهة برمجة تطبيقات للمطورين واتصالات MCP لنماذج الصور والفيديو الخاصة بها. تتبع الواجهة نمطًا غير متزامن: تنشئ تنبؤًا، ثم تستعلم عن حالته، ثم تجلب النتيجة. اعتبارًا من أوائل أكتوبر 2026، يبلغ الحد 5 تنبؤات متزامنة لكل حساب، تُشارَك بين توكنات API واتصالات MCP لديك. قد تتغير متطلبات الخطط والتسعير، لذا راجع صفحة التسعير قبل أن تبني عليها. أما قبول واجهة Gemini معينة لهذا الاتصال فيعتمد على القواعد أعلاه: تستطيع CLI و SDK الوصول إليه بالنقل الصحيح، بينما يحتاج تطبيق Gemini إلى توافر شروط الأهلية.
لا تحتاج إلى واجهة API للبدء. تحوّل PicassoIA Image الأمر النصي المكتوب إلى صورة واقعية كالصور الفوتوغرافية، وPicassoIA Image Editor Pro يحسّن صورة موجودة بتعديلات بلغة بسيطة. أما الفيديو، فتصفح الكتالوج الكامل على picassoia.com/en/all-models.
جرّبه الآن: افتح PicassoIA، وصف مشهدًا بعدسة واتجاه ضوء وحالة مزاجية، ثم شغّله. غيّر تفصيلة واحدة، وشغّله مرة أخرى، وقارن. غالبًا ما تكون أول صورة قوية لديك على بُعد محاولتين أو ثلاث.
اختر لغتك
