ربط GWC Bridge يدويًا مع ChatGPT
اربط GWC Bridge بـ ChatGPT بوصفه موصلًا مخصصًا، ليتمكّن ChatGPT من العمل مع الملفات والأوامر التي تسمح بها على جهاز الكمبيوتر الخاص بك.
ملاحظة حول تسميات الواجهة: التسميات بين علامتي اقتباس مأخوذة من وثائق الواجهة الإنجليزية للمزوّد. لم يتم التحقق من التسميات المترجمة، وقد تختلف واجهتك.
1. من يمكنه استخدام هذه الطريقة
استخدم ChatGPT على الويب (https://chatgpt.com) بحساب أو مساحة عمل ChatGPT Business أو Enterprise أو Edu تسمح بخيار "Add custom MCP server". يوثق مركز مساعدة OpenAI دعم MCP الكامل، بما فيه إجراءات الكتابة، لكل من Business وEnterprise/Edu؛ ويصف MCP المخصص في Pro بأنه وصول للقراءة والجلب، ولا تثبت هذه المراجع توفر وصول كامل مماثل لـFree أو Plus. في ChatGPT Business، يمكن فقط لأصحاب دوري Admins and Owners (المسؤولون والمالكون) في مساحة العمل إنشاء إضافات لخوادم MCP مخصصة ونشرها (تحقق من "Workspace settings" → "Members"). في ChatGPT Enterprise وEdu، يمكن لأصحاب دوري Admins and Owners إنشاء اتصالات MCP مخصصة واختبارها ونشرها، ويمكن للمسؤولين أيضًا استخدام التحكم في الوصول القائم على الأدوار (RBAC) ضمن "Workspace settings" → "Permissions & roles" لمنح أعضاء محددين صلاحية "Create plugins with MCPs" لبناء الاتصالات واختبارها، بينما يتولى Admins and Owners إدارة النشر لمساحة العمل وضوابط الإجراءات. تحقق من عناصر التحكم المتاحة فعليًا لحسابك؛ لا تستطيع GWC تغيير أهلية الاستخدام لدى المزوّد أو سياسة مساحة العمل.[2]
2. تجهيز الكمبيوتر
- على الكمبيوتر المستهدف، استخدم إصدارًا رسميًا مدعومًا من GWC Studio إذا كان متاحًا لنظام تشغيلك، أو ثبّت GWC for VS Code داخل Visual Studio Code.
- افتح التطبيق، وسجّل الدخول إلى حساب GWC الخاص بك، واربط الكمبيوتر المقصود، وأبقِ مكوّن GWC قيد التشغيل ومتصلًا بالإنترنت. فوّض حساب GWC نفسه داخل الموصل.
- شارك أولًا مجلد اختبار لا يحتوي على بيانات حساسة، وراجع صلاحيات Change files وCommands الفعلية لهذا التطبيق على ذلك الكمبيوتر، وليس فقط التعليمات المكتوبة في موجّه المحادثة. تظل حدود المجلدات والمسارات المحمية وتفويضات الاتصال ومبدأ الحد الأدنى من الصلاحيات والتأكيدات على الكمبيوتر ضوابط منفصلة يفرضها الخادم.
- احتفظ باشتراك GWC Personal Connect Pass ساري المفعول (Connect Pass) للتفويض عن بُعد وإجراءات الأدوات. ترفض GWC الطلبات الصادرة عن جهات غير مسجّلة الدخول أو لا تملك استحقاق الاستخدام بصورة مستقلة عن اشتراكك في ChatGPT. ظهور قائمة الأدوات لا يثبت وجود صلاحية الوصول، وإضافة موصل بعيد لا تثبّت مكوّن الكمبيوتر.
3. عنوان الخادم وOAuth
الصق عنوان MCP البعيد عبر HTTPS التالي كما هو تمامًا في حقل عنوان URL لخادم الموصل:
https://mcp.gwc-corp.com/mcpاستخدم تسجيل الدخول الفردي عبر OAuth 2.1 مع PKCE (S256) والاكتشاف التلقائي لـ وثائق البيانات الوصفية لمعرّف العميل (CIMD) (client_id_metadata_document_supported: true). تُرجع الطلبات غير المصادق عليها إلى https://mcp.gwc-corp.com/mcp رمز 401 Unauthorized مع ترويسة WWW-Authenticate تتضمن resource_metadata تشير إلى البيانات الوصفية للمورد المحمي (https://mcp.gwc-corp.com/.well-known/oauth-protected-resource، RFC 9728) وخادم التفويض https://api.gwc-corp.com. اترك "Advanced OAuth settings" ("Client ID" و"Client Secret") فارغة ولا تختر "No authentication": تستخدم GWC العملاء العموميين (none) مع CIMD بدلًا من التسجيل الديناميكي للعملاء (DCR) أو الأسرار الثابتة، وإدخال بيانات اعتماد ثابتة يتجاوز الاكتشاف التلقائي عبر CIMD. لا تلصق أبدًا كلمات مرور GWC أو رموز الوصول/التحديث أو مفاتيح API في المطالبات أو ترويسات الطلبات.[3]
الدعم اليدوي معطّل افتراضيًا. عند تفعيله، تكون مضيفات بيانات العميل الوصفية الافتراضية هي chatgpt.com وopenai.com وclaude.ai. يجب أن يكون مضيف Claude هو claude.ai بالضبط؛ ولا تسمح الإعدادات الافتراضية بـclaude.com أو نطاقات فرعية أخرى أو منافذ محددة صراحةً، بما فيها :443. تحل قائمة المضيفات التي يضبطها المشغّل محل هذه القيم الافتراضية، لذلك يجب أن تؤكد GWC الإعدادات الفعلية.
عند تفعيل الدعم اليدوي، تعلن GWC عن offline_access (دعم منح refresh_token) وتقبله، وتحتفظ به عندما يُطلب في تدفق OAuth. تخضع رموز التحديث الحالية للتدوير؛ ويجب أن يستخدم العميل كل رمز بديل جديد. لا يضيف هذا النطاق أذونات للملفات أو الأوامر أو غيرها من وظائف الكمبيوتر. يجب أن يبقى الكمبيوتر متصلًا لتنفيذ إجراءات الأدوات. يحتاج الاتصال الملغى أو غير الصالح إلى تسجيل دخول جديد عبر الواجهة الرسمية.
إعداد اختياري عبر ملف ZIP للإضافة: إذا كانت صفحة إعداد GWC Bridge تتيح تنزيل ملف ZIP الخاص بـ ChatGPT، فنزّله منها أولًا. في ChatGPT، اختر "Plugins" → "Add" → "Upload plugin" وارفع ملف ZIP، ثم افتح "GWC Bridge" → "Connect" وسجّل الدخول بحساب GWC المستخدم على الكمبيوتر. إذا ظهر "Open in desktop app"، فأكمل في تطبيق سطح المكتب. استخدم هذا المسار أو خيار "Add custom MCP server" أدناه، وليس كليهما.
4. الإعداد الشخصي
- افتح ChatGPT على الويب، وافتح "Plugins" من الشريط الجانبي للتنقل، ثم اختر "+" → "Add custom MCP server". لا تحتاج إلى تفعيل مفتاح "Developer Mode" منفصل أولًا.
- أدخل الاسم GWC Bridge (ووصفًا اختياريًا)، ثم ضمن "Connection" اختر "Server URL" وأدخل
https://mcp.gwc-corp.com/mcp. - اضبط "Authentication" على "OAuth"، واترك "Advanced OAuth settings" ("Client ID" و"Client Secret") فارغة حتى يكتشف ChatGPT البيانات الوصفية لـOAuth في GWC تلقائيًا عبر وثائق البيانات الوصفية لمعرّف العميل (CIMD). لا تدخل سرًا للعميل ولا تستخدم "No authentication".
- راجع تحذير المخاطر الخاص بالخادم، واختر "I understand and want to continue"، ثم اختر "Create as a plugin". أكمل مطالبة تسجيل الدخول إلى GWC ومنح الموافقة في المتصفح عند إعادة توجيهك، ثم راجع الأدوات والبيانات الوصفية المكتشفة في صفحة تفاصيل الإضافة.
- افتح العنصر ضمن "Plugins" الشخصية (أو بدّل الصفحة الرئيسية من "Chat" إلى "Work")، وابدأ محادثة جديدة على الويب، ثم اختر "+" في مربع كتابة الرسالة أو اكتب
@//لاختيار GWC Bridge. - ابدأ بموجّه تحقق للقراءة فقط (مثل تحديد جهاز الكمبيوتر المتاح وعرض أسماء الملفات في مجلد الاختبار المصرّح به دون قراءة محتويات الملفات أو تعديلها أو تشغيل الأوامر). في "Settings" → "Plugins" أو "Settings" → "Apps"، أبقِ تأكيدات الكتابة والأوامر مفعّلة؛ فإعدادات طلب التأكيد في ChatGPT لا تتجاوز ولا توسّع أبدًا صلاحيات المجلدات والأوامر التي يفرضها GWC على الكمبيوتر نفسه.[1]
5. إعداد المؤسسة أو مساحة العمل
- يتحقق Admin or Owner مخوّل من أذونات مساحة العمل ("Workspace settings" → "Members" في Business، أو "Workspace settings" → "Permissions & roles" في Enterprise/Edu حيث يمكن لـRBAC منح صلاحية "Create plugins with MCPs")، وينشئ GWC Bridge عبر "Plugins" باستخدام
https://mcp.gwc-corp.com/mcpو"OAuth" مع ترك بيانات الاعتماد فارغة. - اختبر الاتصال بشكل خاص في محادثة ويب جديدة قبل إتاحته لمساحة العمل: تحقق من اختيار الأدوات ومعاملاتها وحدود التفويض وعرض قائمة ملفات للقراءة فقط في مجلد اختبار خالٍ من البيانات الحساسة. لا تستخدم أبدًا بيانات الإنتاج أو حذف الملفات أو تثبيت الحزم أو النشر أو أوامر الصدفة واسعة النطاق كاختبار أولي للاتصال.
- من صفحة تفاصيل إضافة GWC Bridge (أو "Admin console" → "Plugins" → "Manage Legacy Apps" → "Drafts" / "Workspace Settings" → "Apps" → "Drafts" → "Publish")، ينشر Admin or Owner الإضافة لمساحة العمل أو لأدوار Enterprise/Edu المحددة بعد مراجعة ضوابط الإجراءات. يشارك النشر لمساحة العمل الإضافة داخل مؤسستك فقط، ولا يُعد تقديمًا إلى دليل OpenAI العام.
- يفتح كل عضو في مساحة العمل "Settings" → "Plugins" (أو "Settings" → "Apps")، ويختار GWC Bridge → "Connect"، ويسجّل الدخول باستخدام حساب GWC الخاص به (مع اشتراك Connect Pass نشط وكمبيوتر متصل بالإنترنت). ربط حساب GWC لا يغيّر مساحة عمل ChatGPT النشطة لدى المستخدم؛ لا تشارك أبدًا بيانات اعتماد المسؤول ولا تلصق الرموز في المحادثة.
تحتفظ إضافات MCP المنشورة أو المتصلة بتعريفات الأدوات المخزنة مؤقتًا إلى أن يتم تحديثها. عندما تضيف GWC أدوات أو تحدّثها، يمكن للمسؤول أو المستخدم المخوّل فتح صفحة تفاصيل GWC Bridge في إعدادات "Plugins" / "Apps" واختيار "Refresh" لجلب أحدث الأدوات والأوصاف وتعليمات الخادم دون حذف الإضافة (وإذا تغيرت البيانات الوصفية لاكتشاف OAuth في .well-known، فأعِد إنشاء الإضافة). في Enterprise وEdu، يستطيع المسؤولون والمالكون أيضًا تفعيل إجراءات التطبيق الفردية أو تعطيلها بعد النشر.[2]
لإزالة الوصول، افتح "Settings" → "Plugins" (أو "Settings" → "Apps")، واختر GWC Bridge، ثم اختر "Disconnect" لحساب فردي، أو عطّل/أزِل الإضافة المنشورة من صفحة إدارة "Plugins" (أو "Manage Legacy Apps") في مساحة العمل. يمنع قطع الاتصال استدعاءات الأدوات المستقبلية عن بُعد دون حذف نصوص المحادثات السابقة أو إنهاء عملية محلية طويلة التشغيل بدأت بالفعل على الكمبيوتر تلقائيًا؛ تحقق دائمًا من GWC Studio أو GWC for VS Code على الكمبيوتر قبل إعادة محاولة أمر أو تعديل ملف انقطع تنفيذه.[2]
6. العملاء الآخرون
توثّق OpenAI اتصالات MCP المخصصة لمساحات العمل والحسابات الشخصية على ChatGPT على الويب. لا تفترض أن تطبيقات ChatGPT للهواتف أو تطبيقات سطح المكتب الأصلية توفر مسار الإعداد أو التنفيذ اليدوي نفسه لـMCP؛ واصل استخدام ChatGPT في متصفح على الكمبيوتر بدلًا من تكرار محاولات الاتصال من تطبيقات الهاتف.[2]
إذا كانت مساحة عملك تعرض واجهة الإدارة القديمة للتطبيقات المخصصة ("Admin console" → مساحة العمل → "Plugins" → "Manage Legacy Apps"، أو "Workspace settings" → "Apps" → "Create" مع "Scan Tools" و"Workspace Settings" → "Apps" → "Drafts")، فاستخدمها فقط حيث تعرض مساحة عملك تلك الواجهة. لا تخلط الخطوات بين واجهة "Plugins" الحالية وواجهة "Apps" القديمة، ولا تفترض أن غياب قائمة قديمة يعني قبول GWC أو رفضه.[2]
7. استكشاف المشكلات وحلها
| ما قد يظهر | الخطوة التالية |
|---|---|
| عنصر الإعداد غير موجود — "Add custom MCP server" | تأكد من أنك تستخدم ChatGPT على الويب، وأنك داخل مساحة العمل المقصودة من نوع Business أو Enterprise أو Edu (أو حساب مؤهل)، وأن لديك دور Admin/Owner أو دورًا في Enterprise/Edu يتضمن صلاحية "Create plugins with MCPs". |
invalid_client — إدخال Client ID/Secret يدويًا أو client_id host is not allowed | اترك "Client ID" و"Client Secret" فارغين عند إنشاء الإضافة حتى يستخدم ChatGPT وثائق البيانات الوصفية لمعرّف العميل (client_id_metadata_document_supported: true على chatgpt.com / openai.com)، واطلب من GWC التحقق من تفعيل الدعم اليدوي وقائمة المضيفات المسموح بها. لا تستخدم GWC أسرارًا ثابتة أو التسجيل الديناميكي للعملاء (DCR). |
invalid_request — redirect_uri is not registered by the client | يستخدم ChatGPT العنوان https://chatgpt.com/connector_platform_oauth_redirect (والعنوان https://chatgpt.com/connector/oauth/{callback_id} عند استخدام عمليات إعادة توجيه خاصة بمعرّف رد النداء) عبر بياناته الوصفية في CIMD. تأكد من أن أي خادم وكيل أو جدار حماية لا يعيد كتابة redirect_uri ولا يزيل المعامل resource. |
invalid_scope — Requested scope is not supported أو يفتح الاتصال دون ظهور أدوات | تأكد من أن "Server URL" هو https://mcp.gwc-corp.com/mcp، وأن تسجيل الدخول عبر OAuth قد اكتمل، وأن النطاقات المطلوبة تطابق البيانات الوصفية المفعّلة لدى GWC، وأن https://mcp.gwc-corp.com/.well-known/oauth-protected-resource يمكن الوصول إليه من عناوين IP الصادرة لموصلات OpenAI (https://openai.com/chatgpt-connectors.json). |
invalid_grant / GRANT_REVOKED أو تكرار مطالبات تسجيل الدخول بعد انتهاء الصلاحية | يدعم خادم التفويض في GWC (https://api.gwc-corp.com) منح refresh_token المتجددة مع PKCE (S256). إذا أُلغي تفويض أو خزّن ChatGPT إعدادًا قديمًا للتطبيق مؤقتًا قبل توفر البيانات الوصفية للتحديث، فأعِد إنشاء الإضافة أو أعد ربطها عبر الواجهة الرسمية؛ ولا تعِد استخدام رمز تحديث أو تشاركه أبدًا. |
CONNECT_PASS_REQUIRED / connect_pass_required — Your GWC account does not currently have an active Connect Pass entitlement. | تحقق من أن حساب GWC الذي تم تسجيل الدخول إليه لديه اشتراك GWC Personal Connect Pass (Connect Pass) نشط. النشر لمساحة العمل أو الاشتراك في ChatGPT لا يمنح Connect Pass. |
PC_OFFLINE / DEVICE_NOT_ONLINE | تأكد من أن الكمبيوتر المقصود متصل بالإنترنت، وأن GWC Studio أو GWC for VS Code يعمل وسُجّل الدخول فيه إلى حساب GWC نفسه، ولا تنتقل بصمت إلى كمبيوتر آخر. |
ROOT_NOT_SHARED / PATH_PROTECTED | تأكد من أن المجلد مشارك في GWC Bridge على الكمبيوتر المقصود. يمكن لمالك الكمبيوتر مراجعة ذلك المجلد والتفويض المحددين؛ وتظل المسارات المحمية غير متاحة. |
SCOPE_NOT_GRANTED / APPROVAL_DENIED / CLIENT_ACCESS_DISABLED (تعمل القراءة، وتُرفض الكتابة أو الأوامر) | تحقق من الجانبين بصورة مستقلة: (1) ما إذا كانت ضوابط الإجراءات في مساحة عمل Enterprise/Edu أو مطالبات التأكيد في ChatGPT قد منعت الاستدعاء، و(2) ما إذا كانت صلاحية Change files أو Commands مفعّلة لذلك المجلد في GWC Studio / GWC for VS Code على الكمبيوتر. |
UPDATE_REQUIRED أو تتعطل الأدوات بعد تحديث GWC Bridge | حدّث مكوّن GWC المثبّت عبر قناته الرسمية المدعومة، ثم افتح صفحة تفاصيل GWC Bridge في إعدادات "Plugins" / "Apps" في ChatGPT واختر "Refresh" لجلب مخططات الأدوات المحدَّثة. |
RATE_LIMITED أو انتهاء مهلة تعديل ملف / تنفيذ أمر | انتظر قبل إعادة محاولة قراءة الحالة، وافحص أولًا حالة الملف أو العملية على الكمبيوتر؛ فانتهاء مهلة الشبكة لا يثبت أن الإجراء لم يُنفَّذ على الكمبيوتر. |
GWC_BRIDGE_PROTOCOL_ERROR (HTTP 500, -32603) — GWC Bridge could not complete this request. Check the connection and try again. | تحقق من الاتصال ونتيجة الإجراء السابق على الكمبيوتر قبل إعادة المحاولة. عند التواصل مع الدعم، سجّل الطابع الزمني واسم مساحة العمل واسم الأداة ورمز الخطأ ومعرّف الطلب غير الحساس دون كلمات مرور أو رموز أو محتويات ملفات خاصة. |
Internal server error / INTERNAL / temporarily_unavailable / HTTP 503 | اطلب من GWC التحقق من إعدادات الخدمة وتوفرها. يحتفظ المسار المعطّل افتراضيًا بخطأ بروتوكول عام؛ وتُعالج أخطاء الأدوات العادية والانقطاعات بصورة منفصلة. |
8. الخصوصية والأذونات
يتلقى ChatGPT المخرجات التي تُرجعها استدعاءات أدوات GWC Bridge المصرّح بها، مثل قوائم المجلدات ومحتويات الملفات المطلوبة ومخرجات الأوامر؛ ويدخل كلٌّ من content وstructuredContent اللذين تُرجعهما الأداة في سياق محادثة النموذج، لذلك لا تقل للمستخدمين إن محتويات الملفات لا تغادر الكمبيوتر أبدًا عندما يطلبون من ChatGPT قراءة الملفات أو تشغيل الأوامر. عندما يستدعي ChatGPT أداة، فإنه يرسل معاملات الأداة المستمدة من المحادثة إلى GWC Bridge وجهاز الكمبيوتر المتصل؛ احصر المجلدات المشتركة وصلاحيات الأوامر في GWC Studio أو GWC for VS Code فيما تحتاجه المهمة.
بالنسبة إلى ChatGPT Business وEnterprise وEdu، تنص OpenAI على أن بيانات مساحة العمل — بما في ذلك المعلومات التي يُوصل إليها عبر الإضافات والتطبيقات المتصلة — لا تُستخدم افتراضيًا لتدريب نماذج OpenAI، بينما تظل سياسات الاحتفاظ بالبيانات في مؤسستك وممارسات GWC في التعامل مع بيانات طلبات الترحيل المصادق عليها سارية. ربط GWC Bridge في ChatGPT يمنح التفويض لذلك الاتصال في ChatGPT فقط ولا يشارك محادثات ChatGPT مع أي عميل ذكاء اصطناعي آخر؛ وإذا ربط المستخدم مساعدًا آخر بشكل منفصل بجهاز الكمبيوتر والمجلد المشترك نفسيهما، فلن يتمكن ذلك المساعد إلا من قراءة التغييرات المكتوبة على القرص في ذلك المجلد المشترك.
9. المراجع الرسمية
تم التحقق من خطوات المزوّد في 2026-10-18، وأعيد التحقق منها في 2026-10-19، وتم التحقق المستقل من الحقائق في 2026-10-21 (Asia/Singapore). المراجع التالية هي المصادر الإنجليزية الرسمية. لا تزال إعدادات GWC الفعلية ونجاح الاستدعاء العكسي وتحديث الرموز بحاجة إلى تحقق.