# ربط VS Code بـ Nodary

يستطيع وكيل GitHub Copilot في VS Code قراءة مواصفات فريقك وقراراته في Nodary والكتابة فيها، بصلاحياتك.

تم التحقق منه وفق توثيق كل مزوّد في 22 أكتوبر 2026.

## قبل أن تبدأ

- VS Code مع GitHub Copilot. في Copilot Free وPro وPro+ وMax لا تحكم أي سياسة مؤسسية خوادم MCP.
- في Copilot Business وEnterprise يجب تفعيل سياسة المؤسسة MCP servers in Copilot، وهي معطّلة افتراضيًا. وقد تقيّد قائمة الخوادم المسموح بها في الشركة ما يمكنك إضافته.
- حساب على Nodary. خادم MCP مشمول في كل الخطط، وفي الخطة المجانية ما دامت مساحة العمل ضمن حدودها: المشاريع 1، والمستندات والمجلدات 10، والأعضاء 2. لا يستهلك Copilot أي مذنّبات، فهو يعمل بنموذجه الخاص.

ليست لديك مساحة عمل بعد؟ أنشئ واحدة، ثم عد إلى هنا للاتصال. [أنشئ مساحة عمل مجانية](https://nodary.ai/sign-up)

## إضافة Nodary

1. افتح لوحة الأوامر (Ctrl+Shift+P، أو Cmd+Shift+P على Mac) وشغّل MCP: Add Server.
2. اختر HTTP (HTTP or Server-Sent Events) وأدخل عنوان الخادم:

   ```
   https://nodary.ai/api/mcp
   ```
3. أدخل nodary معرّفًا للخادم.
4. اختر Global، ثم Copilot Global، لاستخدام Nodary في كل مساحات العمل. يكتبه VS Code في ~/.copilot/mcp-config.json:

   ```
   {
     "mcpServers": {
       "nodary": {
         "type": "http",
         "url": "https://nodary.ai/api/mcp",
         "tools": [
           "*"
         ]
       }
     }
   }
   ```
5. حين يبدأ الخادم، اقبل طلبات الثقة وتسجيل الدخول: تُفتح صفحة الموافقة في Nodary في متصفحك.

**الإعدادات القديمة:** ما زال VS Code يقرأ .vscode/mcp.json وملف mcp.json في ملفك الشخصي، وهما يستخدمان servers بدل mcpServers، ويعلّمهما على أنهما مهملان.

## تسجيل الدخول واختيار مساحات العمل

تعرض صفحة الموافقة في Nodary التطبيق الذي يطلب الوصول والعنوان الذي سيُعاد إليه. سجّل الدخول إن لزم، ثم اختر مساحات العمل التي يمكن لـ Copilot الوصول إليها: إن كانت لديك مساحة واحدة فاخترها، وإن كانت لديك عدة مساحات فلن تكون أيّ منها محددة مسبقًا، فحدّد كل مساحة يمكن لـ Copilot استخدامها. وإن مضى على تسجيل دخولك أكثر من 10 دقائق، يطلب منك Nodary كلمة المرور مجددًا. وافق، وسيعيدك المتصفح إلى Copilot.

بعد ذلك يتصرف Copilot باسمك: يرى ويغيّر فقط ما يسمح به دورك، في مساحات العمل التي حددتها. يستمر وصوله 60 دقيقة في كل مرة، ويجدّده Copilot تلقائيًا.

## استخدام Nodary في Copilot Chat

في Copilot Chat تأكد أن أدوات Nodary مفعّلة (Configure Tools، أو Chat: Open Customizations ثم Tools)، ثم اطلب بكلماتك. بعض الطلبات للبدء:

- اقرأ مستند تصميم واجهة البرمجة في Nodary وتحقق من نقطة النهاية هذه وفقًا له.
- اكتب سجل قرار للانتقال إلى Postgres، وضعه في مجلد البنية، واربطه بالمواصفات.
- ما المستندات في مشروع Backend التي ما زالت مسودات، ومن المسؤول عنها؟

## باستخدام مفتاح واجهة برمجة

أضف الترويسة إلى ~/.copilot/mcp-config.json، وهو ملف في مجلدك الرئيسي لا يُحفظ في المستودع أبدًا:

```json
{
  "mcpServers": {
    "nodary": {
      "type": "http",
      "url": "https://nodary.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer gdc_..."
      },
      "tools": [
        "*"
      ]
    }
  }
}
```

**نص صريح:** لا يقرأ VS Code من هذا الملف متغيرات يُطلب إدخالها من المستخدم، لذا يبقى المفتاح مكتوبًا فيه كما هو. اجعل صلاحية المفتاح 30 أو 90 يومًا، وألغِه من Nodary إن فُقد الحاسوب.

أنشئ المفتاح في Nodary من الملف الشخصي، مفاتيح واجهة البرمجة وMCP. يبدأ المفتاح بـ gdc_، ويظهر مرة واحدة، ويعمل بصلاحياتك، ويمكن قصره على مشروع واحد، وتنتهي صلاحيته بعد 30 أو 90 أو 365 يومًا، أو لا تنتهي أبدًا، حسب اختيارك.

![قسم مفاتيح واجهة البرمجة وMCP في ملف شخصي على Nodary: عنوان خادم MCP للصقه في عميل ذكاء اصطناعي، ومفتاح وكيل مع نطاقه.](https://nodary.ai/marketing/mcp-connect.webp)

## إن لم يعمل شيء ما

- يذكر VS Code أن قيدًا مؤسسيًا يمنع الخادم: اسأل المسؤول عن سياسة MCP servers in Copilot وقائمة الخوادم المسموح بها في الشركة.
- لا يظهر تسجيل الدخول: شغّل MCP: List Servers، وأعد تشغيل nodary، واقبل الطلبات. وإن لم يكتمل تسجيل الدخول بعد ذلك فاستخدم مفتاح واجهة برمجة.
- تلقّي الطلب الأول الرد 401 أمر طبيعي: فهو يخبر العميل بمكان تسجيل الدخول.
- quota_locked: تجاوزت مساحة العمل الخطة المجانية بعد فترتها التجريبية وهي مقفلة حتى يشترك المالك. بعد الاشتراك تعود للعمل فورًا.
- billing_locked: فشلت عملية دفع، لذا تبقى مساحة العمل مقفلة حتى يسوّيها المالك من إعدادات الفوترة لمساحة العمل. وتعود للعمل فور نجاح الدفع.
- workspace_suspended: علّق Nodary مساحة العمل، فلا يصل إليها شيء، ولا حتى الوكلاء. ويمكن للمالك الكتابة إلى support@nodary.ai.
- workspace_required: يصل الاتصال إلى عدة مساحات عمل، فحدّد المساحة التي يجري العمل فيها، أو أعد الاتصال وحدّد مساحة واحدة فقط.

## أسئلة

### هل لربط Copilot أي تكلفة؟

ليس من جهة Nodary. خادم MCP مشمول في كل الخطط، بما فيها الخطة المجانية ضمن حدودها، ولا يستهلك Copilot أي مذنّبات: فالمذنّبات تحتسب استخدام Studio AI وحده. أما إمكان إضافة الخادم فتحدده خطتك في Copilot.

### يقول Copilot Business إن خوادم MCP معطّلة. ماذا أفعل؟

يفعّل مسؤول المؤسسة أو الشركة سياسة MCP servers in Copilot، المعطّلة افتراضيًا. ولا تخضع لها Copilot Free وPro وPro+ وMax.

### هل أحتاج إلى تثبيت Node.js أو أي شيء آخر؟

لا. Nodary خادم بعيد: يتواصل معه VS Code عبر HTTPS، ولا يعمل شيء على جهازك.

### هل يمكن لـ Copilot حذف مستنداتي أو الكتابة فوقها؟

فقط حيث يسمح دورك، ويمكن التراجع عن أي تغيير: كل جلسة تحرير مدتها عشر دقائق على الأكثر تشكّل نسخة واحدة، وكذلك كل كتابة من وكيل. يحتفظ المستند بأحدث 50 نسخة من الأشخاص وأحدث 50 نسخة من الوكلاء (نسخ الوكلاء لا تُزيح أبدًا نسخ الأشخاص)، تقارن بينها وتستعيدها، والمستند المحذوف يمكن استعادته خلال 30 يومًا. أما روابط المشاركة والوصول والأعضاء والأدوار والمفاتيح والفوترة وحذف المشاريع فتبقى قرارات بشرية: لا يستطيع أي وكيل اتخاذها.

### كيف أقطع الاتصال؟

في Nodary افتح الملف الشخصي، الأمان، التطبيقات المتصلة، واقطع الاتصال: يتوقف الوصول فورًا. وفي VS Code احذف nodary من ~/.copilot/mcp-config.json أو أوقفه من MCP: List Servers. ويُلغى المفتاح من الملف الشخصي، مفاتيح واجهة البرمجة وMCP، ويمكن للمالكين والمسؤولين إلغاء أي مفتاح في مساحة العمل من إعداداتها، في قسم MCP.

### هل يستخدم Nodary مستنداتي لتدريب الذكاء الاصطناعي؟

لا. لا يستخدم Nodary محتوى مساحات العمل لتدريب نماذج الذكاء الاصطناعي. أما ما يفعله Copilot بما يقرؤه فتحكمه شروط الجهة المطوّرة له.

## اقرأ أيضًا

- [ربط Cursor بـ Nodary](https://nodary.ai/ar/docs/mcp/cursor): أضف Nodary إلى ملف mcp.json في Cursor، ثم سجّل الدخول من Cursor.
- [ربط Claude Code بـ Nodary](https://nodary.ai/ar/docs/mcp/claude-code): أمر واحد يضيف Nodary إلى Claude Code، ثم يسجّل /mcp دخولك.
- [خادم MCP في Nodary](https://nodary.ai/ar/docs/mcp): الخادم وتسجيل الدخول و98 أداة والأمان وكل العملاء في نظرة واحدة.
- [MCP (Model Context Protocol)](https://nodary.ai/glossary/model-context-protocol) (بالإنجليزية): The Model Context Protocol (MCP) is an open standard that connects AI applications to outside tools and data through one common interface.
- [OAuth](https://nodary.ai/glossary/oauth) (بالإنجليزية): OAuth is a standard that lets an app act for you in another service, with access you approve, without ever seeing your password.

https://nodary.ai/ar/docs/mcp/vs-code