ربط GWC Bridge يدويًا مع Gemini

اربط GWC Bridge بـ Gemini لكي يتمكّن Gemini من العمل مع الملفات والأوامر التي تسمح بها على جهاز الكمبيوتر الخاص بك.

ملاحظة حول تسميات الواجهة: التسميات بين علامتي اقتباس تتبع وثائق Google الإنجليزية الحالية. قد تختلف واجهتك مع طرح Google للميزات تدريجيًا. يتيح GWC Bridge لـ Gemini التعامل مع الملفات والأوامر المسموح بها على جهاز الكمبيوتر الخاص بك، حيث يعمل GWC for VS Code أو GWC Studio. إن إضافة خادم MCP مخصص لا تعني أن Google قد راجعت GWC Bridge أو أوصت به.

1. من يمكنه استخدام هذه الطريقة

Gemini: يمكن للمسؤول إضافة مخزن بيانات "Custom MCP Server" (خادم MCP مخصص) بعد أن تسمح سياسة المؤسسة المُدارة الخاصة بالمشروع بموصلات MCP المخصصة. تشترط Google منح دور "Discovery Engine Editor" للمسؤول الذي ينشئ مخزن البيانات، وقد يلزم إجراء تغييرات إضافية على سياسات حركة البيانات الصادرة ومصادر البيانات عند تفعيل VPC Service Controls أو الفرض المُدار للسياسات.^[1]^[2]

Gemini CLI: لا يدعم GWC Bridge هذا المسار حاليًا. لا تُعِدّ عميل OAuth ثابتًا لـ Gemini CLI.

تطبيقات Gemini المخصصة للمستهلكين: تقصر Google حاليًا التطبيقات المخصصة على المستخدمين المؤهلين: بعمر 18 عامًا فأكثر، داخل الولايات المتحدة، مسجّلين الدخول بحساب Google شخصي، مع تفعيل "Keep Activity" (الاحتفاظ بالنشاط)، واستخدام اللغة الإنجليزية لهذه الميزة. يبدأ الإعداد في تطبيق Gemini على الويب.^[4] لم يتم تفعيل GWC Bridge بعد لهذا المسار المخصص للمستهلكين. توثّق Google إدخال بيانات الاعتماد ضمن “Advanced features” (الميزات المتقدمة) عندما لا يدعم الخادم التسجيل الديناميكي للعملاء (Dynamic Client Registration)، لكن صفحة المساعدة الحالية لا تنشر عنوان URI لرد النداء الذي يتعين على GWC إضافته إلى قائمة السماح. لن تخمّنه GWC ولن تقبل إعادة توجيه بحروف بديلة (wildcard).

2. قبل البدء

جهّز حسابك في GWC، وتأكد من وجود اشتراك Connect Pass نشط، وأن GWC for VS Code أو GWC Studio يعمل ومتصل على جهاز الكمبيوتر الذي تريد أن يستخدمه Gemini.
سجّل الدخول إلى حساب GWC نفسه عند فتح نافذة OAuth. إن إضافة عنوان MCP لا تثبّت مكوّن الكمبيوتر ولا تشغّله.
راجع صلاحيات الملفات والمجلدات والأوامر المتاحة على ذلك الكمبيوتر، وابدأ بأقل قدر من الوصول اللازم.
يواصل GWC Bridge فرض سياساته الخاصة بالحسابات والمنح والمجلدات والموارد والموافقات والأوامر. لا يستطيع Gemini منح نفسه وصولًا ترفضه GWC.

3. عنوان الخادم وOAuth

استخدم عنوان خادم MCP التالي:

https://mcp.gwc-corp.com/mcp

نقاط نهاية OAuth الخاصة بـ GWC هي:

Authorization URL: https://api.gwc-corp.com/oauth/authorize
Token URL:         https://api.gwc-corp.com/oauth/token
Issuer:            https://api.gwc-corp.com

يستخدم مسار Gemini المدعوم Authorization Code مع PKCE S256. معرّف العميل الثابت هو معرّف عام مرتبط برد النداء المستضاف الدقيق من Google. لا يسجّل GWC Bridge حاليًا عميل OAuth لـ Gemini CLI.

4. إعداد المسؤول في Gemini

تتعامل Google مع تهيئة Custom MCP Server بوصفها عملية إدارية على مستوى المؤسسة.^[1]

في Google Cloud، اختر المشروع الذي يملك تطبيق Gemini.
افتح Organization Policies (سياسات المؤسسة) وابحث عن Disable custom MCP server connector for Gemini Enterprise (constraints/discoveryengine.managed.disableCustomMcpServerConnector). تجاوز السياسة الأصلية لهذا المشروع واضبط الفرض على Off (إيقاف). لا تعطّل السياسة لنطاق أوسع داخل المؤسسة إلا إذا كان ذلك قرار حوكمة مقصودًا من مؤسستك.^[2]
إذا كان مشروعك محميًا بواسطة VPC Service Controls، أو كانت سياسات الموصلات المُدارة ذات الصلة مفروضة على هذا المشروع، فاسمح بـ custom_mcp كمصدر بيانات واسمح بحركة البيانات الصادرة إلى كل من mcp.gwc-corp.com وapi.gwc-corp.com.^[1]^[5]
امنح المسؤول الذي ينشئ مخزن البيانات دور Discovery Engine Editor المطلوب (roles/discoveryengine.editor).^[1]
افتح Gemini Enterprise → Data stores (مخازن البيانات) → Create data store (إنشاء مخزن بيانات) → Custom MCP Server (خادم MCP مخصص) → Add MCP server (إضافة خادم MCP).
اختر OAuth 2.0 وأدخل القيم التالية:

الحقل	القيمة
MCP Server URL	`https://mcp.gwc-corp.com/mcp`
Authorization URL	`https://api.gwc-corp.com/oauth/authorize`
Authorization URL Parameters	اتركه فارغًا (Leave blank)
Token URL	`https://api.gwc-corp.com/oauth/token`
Client ID	`gwc-google-gemini-v1`
Client Secret	`none`
Scopes	`files:read files:write commands:run`
Enable PKCE Support	On
Use HTTP Basic	Off

يُظهر مثال Google Cloud الحالي لتطبيق MCP في Gemini بالمثل تفعيل PKCE وعدم تحديد HTTP Basic.^[7]

عنوان إعادة التوجيه الموثق لدى Google لهذا الموصل هو تحديدًا https://vertexaisearch.cloud.google.com/oauth-redirect؛ ويقبل ملف تعريف عميل GWC هذا العنوان فقط دون أي مسار فرعي أو مضيف بديل أو حرف بديل (wildcard).^[1] القيمة none ليست سرًا مشتركًا؛ إذ تستخدم إرشادات Looker MCP الخاصة بـ Google هذه القيمة النصية عندما يتطلب النموذج ملء حقل Client Secret لعميل عام يستخدم PKCE.^[6]

انقر على Verify Auth (التحقق من المصادقة)، وسجّل الدخول إلى GWC، وراجع صلاحيات GWC المطلوبة، ولا توافق إلا إذا كان الحساب والوجهة صحيحين.
أكمل إنشاء مخزن البيانات، وانتظر حتى تصبح حالته Active (نشط).
افتح عرض Actions (الإجراءات) الخاص بمخزن البيانات، وأعد تحميل الإجراءات المخصصة عند الحاجة، وفعّل فقط أدوات GWC Bridge التي تريد أن يستخدمها Gemini. تعطّل Google إجراءات MCP المخصصة افتراضيًا.^[1]
اربط مخزن البيانات بتطبيق Gemini المقصود، ثم نفّذ فحصًا أوليًا للقراءة فقط: Use GWC Bridge to show which of my computers and shared folders are available. Do not change files or run commands.

5. Gemini CLI

يمكن لـ Gemini CLI الاتصال بخوادم MCP البعيدة، لكن GWC Bridge لا يفعّل حاليًا عميل OAuth لـ Gemini CLI. لا تضف ملف تعريف OAuth لـ GWC Bridge إلى Gemini CLI الآن. يظل هذا المسار غير مدعوم حتى تنشر GWC آلية هوية عميل خضعت لمراجعة منفصلة.

6. تطبيقات Gemini المخصصة للمستهلكين

تشير مساعدة تطبيقات Gemini للمستهلكين من Google إلى أن المستخدمين المؤهلين يمكنهم فتح Settings → Connected Apps (الإعدادات → التطبيقات المتصلة)، وإضافة تطبيق مخصص عبر عنوان خادم MCP، وعندما لا يدعم الخادم التسجيل الديناميكي للعملاء، فتح Advanced features (الميزات المتقدمة) وإدخال بيانات الاعتماد.^[4]

لا تُدخل أيًا من معرّفي عميل GWC الثابتين هناك اليوم. لا توثّق صفحة مساعدة Google الحالية عنوان URI لرد نداء OAuth الخاص بالتطبيقات المخصصة للمستهلكين، ولا تملك GWC نقطة نهاية للتسجيل الديناميكي للعملاء. إن إعادة استخدام عنوان رد النداء الخاص بـ Enterprise أو عنوان الحلقة المحلية الخاص بـ CLI غير صحيحة؛ كما أن قبول حرف بديل (wildcard) سيُضعف ربط إعادة توجيه OAuth.

لا يصبح هذا المسار قابلًا للدعم إلا بعد تحقق واحد على الأقل مما يلي:

أن تنشر Google عنوان URI ثابتًا ومحددًا لرد نداء المستهلكين يمكن لـ GWC ربطه بمعرّف عميل عام مخصص؛ أو
أن تنفّذ GWC وتراجع أمنيًا آلية للتسجيل الديناميكي للعملاء تستوفي مسار تسجيل العملاء في Gemini.

حتى ذلك الحين، مسار العميل المدعوم الوحيد في هذا الدليل هو Gemini.

7. ما يمكن لـ Gemini رؤيته وكيفية قطع الاتصال

عندما يستدعي Gemini أداة من أدوات GWC Bridge، يمكن أن تتضمن نتيجة الأداة أسماء ملفات أو محتويات ملفات أو مخرجات أوامر أو تسميات أجهزة أو بيانات أخرى تُرجعها الأداة المصرح بها. يغادر هذا المحتوى جهاز الكمبيوتر الخاص بك وتتم معالجته بواسطة واجهة Gemini التي اخترتها. توضح Google أن خوادم MCP المخصصة التابعة لجهات خارجية تقع خارج نطاق سيطرة Google وتوصي بعدم ربط سوى الخوادم التي تثق بها.^[4]

تظل صلاحيات GWC Bridge هي المرجع الحاسم:

تقتصر قراءة الملفات على المجلدات المشتركة مع اتصال GWC Bridge النشط.
تتطلب تغييرات الملفات أن يسمح كل من الاتصال والمجلد بالتغييرات، بالإضافة إلى اجتياز أي فحوصات للإجراءات المحمية.
تتطلب الأوامر أن يسمح الاتصال بتشغيل Commands، وقد تظل خاضعة للموافقة.
لا يمكن استبدال جهاز الكمبيوتر أو الحساب أو المنحة التي فوّضتها بجهاز كمبيوتر آخر أو حساب آخر أو منحة ملغاة.

لقطع الاتصال:

Gemini: يمكن للمسؤول تعطيل الإجراءات أو فصل مخزن البيانات عن التطبيق أو إزالة مخزن بيانات MCP المخصص وفقًا لسياسة المؤسسة.
Gemini CLI: لا يوجد عميل OAuth من GWC مفعّل. أزل أي ملف تعريف OAuth تجريبي لـ GWC Bridge بدلًا من محاولة المصادقة.
في GWC، يؤدي إلغاء منحة Bridge الأساسية إلى إبطال الوصول بصرف النظر عن الإعدادات الموجودة على جانب Gemini.

8. استكشاف المشكلات وإصلاحها

العَرَض	ما ينبغي التحقق منه
محاولة استخدام OAuth مع Gemini CLI	توقّف. لا يدعم GWC Bridge حاليًا OAuth في Gemini CLI.
يفيد Gemini بأن Custom MCP Server محظور	تأكد من تجاوز القيد المُدار على مستوى المشروع Disable custom MCP server connector for Gemini Enterprise وضبطه على Off. وإذا كانت VPC Service Controls أو الفرض المُدار مطبقين، فاسمح أيضًا بـ `custom_mcp` وبأسماء النطاقات المؤهلة بالكامل (FQDNs) المطلوبة لحركة البيانات الصادرة.
يفيد Verify Auth بوجود عنوان إعادة توجيه غير صالح	تأكد من أن Client ID هو `gwc-google-gemini-v1` تمامًا. لا تقبل GWC سوى العنوان الموثق لدى Google `https://vertexaisearch.cloud.google.com/oauth-redirect` لهذا العميل.
يفيد Verify Auth بوجود سر عميل غير صالح	أدخل `none` تمامًا، وفعّل PKCE، واترك Use HTTP Basic مضبوطًا على Off. تتعامل GWC مع هذه القيمة فقط بوصفها عنصرًا نائبًا يطلبه نموذج Google لهذا العميل العام المحدد؛ ويُرفض أي سر آخر.
يفشل التفويض فورًا	تأكد من أن GWC قد فعّلت OAuth اليدوي لـ Gemini. علم التوافق على جانب الخادم متوقف افتراضيًا.
يتعذر على Gemini الوصول إلى الخادم أو نقاط نهاية OAuth	إذا كانت ضوابط حركة البيانات الصادرة مطبقة، فاسمح بكل من `mcp.gwc-corp.com` و`api.gwc-corp.com`. أعد التحقق من عناوين HTTPS بدقة.
مخزن البيانات في حالة Active لكن Gemini لا يستدعي الأدوات	تكون إجراءات MCP المخصصة معطلة افتراضيًا. فعّل الإجراءات المقصودة واربط مخزن البيانات بتطبيق Gemini المقصود.

| ينجح تسجيل الدخول لكن GWC يرفض الوصول | تحقق من حساب GWC ووجود اشتراك Connect Pass نشط، ثم افحص منحة Bridge وصلاحيات الكمبيوتر. لا تعد محاولة تشغيل أداة تغيّر الحالة دون تحقق. | | جهاز الكمبيوتر أو المجلد غير متاح | تأكد من أن جهاز الكمبيوتر المقصود متصل بالإنترنت، وأن GWC Studio أو GWC for VS Code يعمل ومتصل، وأن المجلد مشارك لهذا الاتصال. | | تنجح القراءة لكن تفشل التعديلات أو الأوامر | راجع صلاحيات Change files (تغيير الملفات) / Commands (الأوامر) في GWC Bridge وأي مطالبة بالموافقة. الرفض يمثل حدًا تفرضه السياسة وليس دليلًا على فشل المصادقة. | | يطلب تطبيق Gemini المخصص للمستهلكين بيانات اعتماد | لا تستخدم معرّفي العميل الخاصين بـ Enterprise أو CLI. عنوان URI لرد نداء المستهلكين غير موثق حاليًا، لذلك ترفض GWC هذا المسار عن قصد. |

عند التواصل مع دعم GWC، اذكر واجهة Gemini المستخدمة (Enterprise أو CLI)، وخطوة الإعداد، ونص رسالة الخطأ الدقيق. لا ترسل أبدًا كلمات المرور أو رموز الحامل أو محتويات الملفات الخاصة أو أي سر عميل حقيقي.

9. المراجع الرسمية

تم التحقق من خطوات المزوّد في 2026-10-22 (Asia/Singapore) مقابل وثائق Google الإنجليزية الرسمية الحالية: