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

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

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

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

يدعم Claude الموصلات المخصصة البعيدة ضمن خطط Free وPro وMax وTeam وEnterprise. يمكن للحسابات ضمن خطة Free إضافة موصل مخصص واحد. في خطط Team، يجب أن يضيف صاحب دور "Owner" (المالك) أو "Primary Owner" (المالك الأساسي) في المؤسسة GWC Bridge إلى المؤسسة أولًا؛ وفي خطط Enterprise، يجب أن يضيفه أولًا صاحب دور "Owner" أو "Primary Owner" أو عضو لديه دور مخصص يتضمن صلاحية "Manage access to Libraries" (إدارة الوصول إلى المكتبات).^[1]

يتطلب الوصول إلى Claude Code أهلية منفصلة من خلال اشتراك مدعوم أو ترتيبات وصول تابعة للمؤسسة. حساب Claude ضمن خطة Free وحده لا يشمل الوصول إلى Claude Code.^[3]

2. قبل البدء

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

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

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

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

تتم المصادقة في GWC Bridge تلقائيًا باستخدام وثيقة البيانات الوصفية لمعرّف العميل (CIMD) المنشورة من Claude وPKCE. لا تحتاج إلى معرّف عميل OAuth أو سر عميل OAuth، ويجب ألا تُدخلهما. لا تلصق أبدًا كلمات المرور أو رموز الوصول أو أسرار العملاء في محادثة مع Claude أو في ترويسات الطلبات.^[4]

إعداد اختياري عبر ملف ZIP للإضافة: إذا كانت صفحة إعداد GWC Bridge تتيح تنزيل ملف ZIP الخاص بـ Claude، فنزّله منها أولًا. في Claude، اختر "Customize" → "Plugins" → "Add" → "Upload plugin" وارفع ملف ZIP، ثم افتح "GWC Bridge" → "Connectors" → "Connect" وسجّل الدخول بحساب GWC المستخدم على الكمبيوتر. استخدم هذا المسار أو خيار "Add custom connector" أدناه، وليس كليهما.

4. الإعداد الشخصي (Free أو Pro أو Max)

سجّل الدخول إلى حساب Claude الذي تريد استخدامه على claude.ai (أو في Claude Desktop)، ثم افتح "Customize" → "Connectors" (تخصيص → الموصلات).
انقر على "+ Add" (+ إضافة) (أو "+") → "Add custom connector" (إضافة موصل مخصص). في تصميم القائمة الموحّدة، انقر على "Add" → "Custom" → "Web".
سمِّ الموصل GWC Bridge، وأدخل https://mcp.gwc-corp.com/mcp؛ وإذا أظهر مربع الحوار قسم "Advanced settings" (إعدادات متقدمة) لإدخال معرّف عميل OAuth وسر عميل OAuth اختياريين، فاترك الحقلين فارغين.
انقر على "Continue" (متابعة) (أو "Add" إذا كنت تستخدم مربع الحوار ذي الخطوة الواحدة) لمراجعة إعدادات المصادقة المكتشفة: ضمن "Authentication"، أبقِ "Sign in now" محددًا (ولا تختر "No sign in")؛ وضمن "OAuth client"، أبقِ "Use Claude's published identity (Recommended)" محددًا (ولا تختر "Register automatically" لأن GWC Bridge لا يستخدم التسجيل الديناميكي للعملاء، ولا تختر "Use your own OAuth client")؛ واترك "Request headers" فارغًا.
انقر على "Add" لإنهاء إنشاء الموصل، ثم انقر على "Connect" (اتصال) إذا لم يكن تسجيل الدخول قد بدأ بالفعل، وأكمل خطوات تسجيل الدخول إلى GWC ومنح الموافقة في المتصفح.
تأكد من أن GWC Bridge يظهر على أنه متصل في "Customize" → "Connectors"، وافتح "+" → "Connectors" (أو قائمة "Search and tools") داخل محادثة لتفعيل GWC Bridge، وأبقِ تغييرات الملفات والأوامر مضبوطة على طلب الموافقة إلى أن تطمئن إلى نطاق الوصول، ونفّذ فحصًا أوليًا للقراءة فقط (Use GWC Bridge to show which of my computers and shared folders are available. Do not change files or run commands.)، مع مراجعة النتيجة الفعلية للأداة وليس مجرد قول Claude إنه اتصل.^[1]

5. إعداد المؤسسة (Team أو Enterprise)

يفتح صاحب دور "Owner" أو "Primary Owner" في المؤسسة (أو شخص لديه دور مخصص يتضمن صلاحية "Manage access to Libraries" في خطة Enterprise) مسار "Organization settings" → "Connectors" → "Add" → "Custom" → "Web" (أو يختار "Add custom connector").
أدخل الاسم GWC Bridge وعنوان الخادم https://mcp.gwc-corp.com/mcp، ثم انقر على "Continue".
أبقِ إعدادات المصادقة المكتشفة ("Sign in now" و"Use Claude's published identity (Recommended)")، واترك "Request headers" وأي حقول لبيانات اعتماد عميل OAuth مخصص فارغة، ثم انقر على "Add".
بعد إضافة الموصل إلى المؤسسة، يفتح كل عضو "Customize" → "Connectors"، ويعثر على GWC Bridge الذي يحمل علامة "Custom"، وينقر على "Connect" لتسجيل الدخول باستخدام حسابه الخاص في GWC، ثم يفعّله من "+" → "Connectors" (أو "Search and tools").

إتاحة الموصل للمؤسسة لا تسجّل دخول الأعضاء تلقائيًا.^[1]

6. الهاتف وClaude Code

أعدّ GWC Bridge وصادِق عليه أولًا عبر Claude على الويب أو Claude Desktop، ثم سجّل الدخول إلى حساب Claude نفسه—وإلى المؤسسة نفسها عند الاقتضاء—في تطبيق Claude على iOS أو Android. تعمل موصلات الويب على Claude Mobile بعد إعدادها في حسابك؛ وتثبيت الموصلات مباشرةً على الهاتف لا يزال حاليًا في المرحلة التجريبية، لذا يظل Claude Desktop والويب المسار الأساسي لإعداد الموصلات المخصصة.^[2]

في Claude Code، تحقق أولًا من /mcp: إذا سجّلت الدخول باستخدام حساب Claude، فقد يكون الموصل الذي أضفته على claude.ai قد تم تحميله تلقائيًا بالفعل، فتجنّب إضافة إدخال مكرر عبر واجهة سطر الأوامر إذا كان موصل الحساب موجودًا. لإضافة GWC Bridge (أو إزالته لاحقًا) مباشرةً عبر واجهة سطر الأوامر في الطرفية:^[3]

claude mcp add --transport http --scope user gwc-bridge https://mcp.gwc-corp.com/mcp
claude mcp remove gwc-bridge --scope user

بعد الإضافة، افتح Claude Code وشغّل /mcp، واختر gwc-bridge، ثم اختر "Authenticate" (المصادقة)، وأكمل خطوات تسجيل الدخول إلى GWC في المتصفح. يتيح النطاق user هذا الخادم في جميع مشاريعك على ذلك الجهاز. تحقق من حالة الخادم ونفّذ الفحص الأولي للقراءة فقط الموضح أعلاه. قد تقيّد مؤسستك خوادم MCP التي يمكن لـ Claude Code تحميلها؛ لا تحاول تجاوز سياسات المؤسسة بتغيير المصادقة أو تبديل الحسابات.^[3]^[4]

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

GWC Bridge ليس مجرد قائمة بأسماء الأدوات. عندما تقرأ أداة مصرح لها ملفًا أو تُرجع مخرجات أمر، يُرسل ذلك المحتوى إلى Claude، ويمكن للموصل أيضًا إتاحة موارد MCP وموجّهات لسير العمل. تعتمد الإجراءات المتاحة عبر GWC Bridge على صلاحياتك في GWC وسياسات المجلدات على جهاز الكمبيوتر؛ وتستطيع ضوابط صلاحيات الأدوات في Claude تقييد الأدوات التي يستدعيها Claude، لكنها لا تستطيع منح وصول يرفضه GWC Bridge. راجع طلبات الموافقة بعناية، خاصةً قبل تعديل الملفات أو حذفها أو تشغيل الأوامر. لا تفترض أن حركة بيانات الموصلات البعيدة تبقى محلية بالكامل: عبر claude.ai وClaude Desktop وCowork وClaude Mobile، يتصل Claude بخوادم MCP البعيدة من البنية التحتية السحابية لـ Anthropic. لا تمنح إضافة العنوان أبدًا تحكمًا تلقائيًا في الشاشة أو وصولًا غير مقيّد إلى الملفات أو تنفيذًا للأوامر دون موافقة؛ ولا تتاح إلا المجلدات المشتركة والإمكانات التي سمحت بها في GWC.

لقطع اتصال GWC Bridge أو إزالته، افتح "Customize" → "Connectors" واختر GWC Bridge:

يؤدي "Disconnect" (قطع الاتصال) إلى تسجيل خروج Claude من GWC Bridge مع إبقاء الموصل في قائمتك.
يؤدي "Remove" / "Delete" (إزالة / حذف)، من قائمة الموصل، إلى إزالة موصل مخصص شخصي من حسابك.
يجب أن يتولى مالك مخوّل إجراء "Organization-wide removal" (الإزالة على مستوى المؤسسة) في خطط Team وEnterprise من خلال "Organization settings" → "Connectors".
إيقاف الموصل من قائمة "+" → "Connectors" أو "Search and tools" داخل محادثة يعطّله لتلك المحادثة فقط؛ وإذا كان الموصل متزامنًا من حسابك على claude.ai أو مقدمًا من مؤسستك، فأدِره أو أزِله من إعدادات الموصلات في Claude (أو عطّله لنفسك في /mcp).

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

العَرَض	ما ينبغي التحقق منه
لا يوجد خيار لإضافة موصل مخصص	في خطة Free، تحقق مما إذا كانت الخانة الوحيدة المتاحة لموصل مخصص مستخدمة بالفعل. في Team أو Enterprise، اطلب من مالك المؤسسة (أو مسؤول Enterprise لديه صلاحية "Manage access to Libraries") إضافته ضمن "Organization settings" → "Connectors".
لا يظهر GWC Bridge في دليل الموصلات	استخدم مسار الإعداد عبر عنوان الموصل المخصص (`https://mcp.gwc-corp.com/mcp`). لا يتطلب الإعداد اليدوي إدراج الموصل في الدليل.
يطلب الإعداد معرّف عميل OAuth أو سر العميل	اترك حقول معرّف العميل وسر العميل الاختيارية في "Advanced settings" فارغة. لا تخمّن بيانات اعتماد ثابتة للعميل ولا تُدخلها.
يفشل تسجيل عميل OAuth	في مربع حوار الإعداد ذي الخطوتين، تأكد من ضبط "OAuth client" على "Use Claude's published identity (Recommended)"، وليس "Register automatically" (لأن GWC Bridge لا يستخدم التسجيل الديناميكي للعملاء) أو "Use your own OAuth client".
يكتمل تسجيل الدخول، لكن GWC يرفض الوصول	تحقق من أنك سجّلت الدخول إلى حساب GWC المقصود، وأن اشتراك Connect Pass الخاص به نشط. لا تختر "No sign in" لتجاوز الرفض.
“Couldn’t reach the MCP server” (تعذّر الوصول إلى خادم MCP)	أعد التحقق من أن العنوان هو `https://mcp.gwc-corp.com/mcp`. قد ينتج هذا الخطأ عن انقطاع مؤقت في الخدمة، أو انتهاء مهلة اكتشاف OAuth، أو حظر من جدار حماية الشبكة أو WAF بين نطاقات عناوين IP الخاصة بـ Anthropic والخادم. أرسل نص الخطأ الدقيق والمعرّف المرجعي إلى دعم GWC.
الموصل متصل، لكن Claude لا يستخدم الأدوات	تحقق من تفعيل GWC Bridge في قائمة "+" → "Connectors" / "Search and tools" داخل المحادثة، ومن أن الأدوات الفردية ليست معطلة. اطلب صراحةً تنفيذ إجراء باستخدام GWC Bridge.
جهاز الكمبيوتر أو أحد المجلدات غير متاح	تأكد من أن جهاز الكمبيوتر المقصود متصل بالإنترنت، وأن GWC Studio أو GWC for VS Code يعمل ومتصل، وأن المجلد مشارك لهذا الاتصال. لا تنتقل إلى جهاز كمبيوتر آخر دون التحقق من أنه الجهاز المقصود.
تنجح القراءة، لكن تفشل التعديلات أو الأوامر	تحقق من إعدادات الموافقة على الأدوات في Claude ومن صلاحيات "Change files" (تغيير الملفات) / "Commands" (الأوامر) الخاصة بالمجلد في GWC. تعامل مع رفض الصلاحية على أنه قيد تفرضه السياسة ويجب حله، وليس عطلًا مؤقتًا تعيد المحاولة معه دون تحقق.
لا يظهر الموصل على الهاتف	تأكد من تسجيل الدخول إلى حساب Claude والمؤسسة نفسيهما على الهاتف، وأكمل الإعداد الأولي للموصل المخصص على Claude عبر الويب أو تطبيق سطح المكتب أولًا.
لا يُظهر Claude Code موصلًا أُضيف عبر الويب	شغّل `/status` للتحقق من طريقة تسجيل دخولك. يمنع تسجيل الدخول باستخدام مفتاح API أو ملف تعريف لمزوّد مختلف تحميل موصلات حساب claude.ai. تحقق أيضًا من سياسات MCP الخاصة بالمؤسسة في `/mcp`.
يحتاج Claude Code إلى المصادقة أو لا يفتح المتصفح	شغّل `/mcp`، واختر `gwc-bridge`، ثم اختر "Authenticate". انسخ عنوان التفويض المعروض في الطرفية وافتحه إذا لم يُفتح المتصفح تلقائيًا.
تنتهي مهلة تغيير ملف أو تشغيل أمر	لا تفترض أن الإجراء فشل بالكامل. افحص الحالة الحالية للملف أو النشاط الأخير قبل تكرار عملية تغيّر الحالة.

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

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

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