# ربط Cursor بـ Nodary

يستطيع وكيل Cursor قراءة المواصفات والقرارات والخطط التي يحفظها فريقك في Nodary أثناء كتابته الشيفرة، وتدوين ما يتعلمه، بصلاحياتك.

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

## قبل أن تبدأ

- تطبيق Cursor لسطح المكتب. عندما تحققنا لم تذكر صفحة أسعار Cursor الخطط التي تشمل خوادم MCP؛ وفي Enterprise يتحكم المسؤولون في الوصول إلى MCP، ويمكن للفريق الاحتفاظ بقائمة خوادم مسموح بها.
- حساب على Nodary. خادم MCP مشمول في كل الخطط، وفي الخطة المجانية ما دامت مساحة العمل ضمن حدودها: المشاريع 1، والمستندات والمجلدات 10، والأعضاء 2. لا يستهلك Cursor أي مذنّبات، فهو يعمل بنموذجه الخاص.

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

## إضافة Nodary إلى mcp.json

1. افتح ~/.cursor/mcp.json في مجلدك الرئيسي (Nodary في كل المشاريع) أو .cursor/mcp.json في مشروع (ذلك المشروع فقط) وأضف الخادم:

   ```
   {
     "mcpServers": {
       "nodary": {
         "url": "https://nodary.ai/api/mcp"
       }
     }
   }
   ```
2. افتح Customize في الشريط الجانبي لـ Cursor، وابحث عن nodary بين خوادم MCP، وفعّله، وسجّل الدخول حين يطلب Cursor ذلك: تُفتح صفحة الموافقة في Nodary في متصفحك.
3. وافق على الوصول. بعد ذلك يعرض Cursor أدوات Nodary على أنها متاحة.

**مشاركة الملف:** ملف .cursor/mcp.json المحفوظ في المستودع يمنح الفريق كله الخادم نفسه، ويظل كل شخص يسجّل الدخول بحسابه. لا تحفظ مفتاح واجهة برمجة في المستودع أبدًا.

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

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

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

## استخدام Nodary من الوكيل

اطلب من الوكيل بكلماتك. يستخدم Cursor أدوات Nodary حين يحتاجها طلبك، ويطلب موافقتك افتراضيًا قبل تشغيل أي منها. بعض الطلبات للبدء:

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

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

ضع مفتاحك في متغير البيئة NODARY_API_KEY وأرسله في ترويسة؛ يقرأ Cursor ${env:NODARY_API_KEY} من بيئتك:

```json
{
  "mcpServers": {
    "nodary": {
      "url": "https://nodary.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:NODARY_API_KEY}"
      }
    }
  }
}
```

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

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

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

- لا تظهر أدوات Nodary: افتح Customize وتأكد أن nodary مفعّل، ثم اقرأ الأخطاء في لوحة Output ضمن MCP Logs.
- لا يكتمل تسجيل الدخول: اتصل بمفتاح واجهة برمجة بدلًا من ذلك، كما في الأعلى.
- تلقّي الطلب الأول الرد 401 أمر طبيعي: فهو يخبر العميل بمكان تسجيل الدخول.
- quota_locked: تجاوزت مساحة العمل الخطة المجانية بعد فترتها التجريبية وهي مقفلة حتى يشترك المالك. بعد الاشتراك تعود للعمل فورًا.
- billing_locked: فشلت عملية دفع، لذا تبقى مساحة العمل مقفلة حتى يسوّيها المالك من إعدادات الفوترة لمساحة العمل. وتعود للعمل فور نجاح الدفع.
- workspace_suspended: علّق Nodary مساحة العمل، فلا يصل إليها شيء، ولا حتى الوكلاء. ويمكن للمالك الكتابة إلى support@nodary.ai.
- workspace_required: يصل الاتصال إلى عدة مساحات عمل، فحدّد المساحة التي يجري العمل فيها، أو أعد الاتصال وحدّد مساحة واحدة فقط.

## أسئلة

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

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

### هل يستطيع فريقي كله استخدام الإعداد نفسه؟

نعم. احفظ .cursor/mcp.json في المستودع بالعنوان وحده: يسجّل كل شخص الدخول بحسابه في Nodary، فيعمل Cursor بصلاحياته. احفظ المفاتيح في بيئة كل شخص، لا في المستودع.

### هل يرسل Cursor شيفرتي إلى Nodary؟

فقط ما يضعه وكيله في طلب إلى Nodary، مثل مستند يكتبه أو مقطع يبحث عنه. يحتفظ Nodary بما يُكتب في مساحة العمل، ولا شيء غيره.

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

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

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

في Nodary افتح الملف الشخصي، الأمان، التطبيقات المتصلة، واقطع الاتصال: يتوقف الوصول فورًا. وفي Cursor أوقف الخادم من Customize أو احذفه من mcp.json. ويُلغى المفتاح من الملف الشخصي، مفاتيح واجهة البرمجة وMCP، ويمكن للمالكين والمسؤولين إلغاء أي مفتاح في مساحة العمل من إعداداتها، في قسم MCP.

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

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

## اقرأ أيضًا

- [ربط Claude Code بـ Nodary](https://nodary.ai/ar/docs/mcp/claude-code): أمر واحد يضيف Nodary إلى Claude Code، ثم يسجّل /mcp دخولك.
- [ربط VS Code بـ Nodary](https://nodary.ai/ar/docs/mcp/vs-code): MCP: Add Server في VS Code، ثم تسجيل الدخول لـ GitHub Copilot.
- [خادم MCP في Nodary](https://nodary.ai/ar/docs/mcp): الخادم وتسجيل الدخول و98 أداة والأمان وكل العملاء في نظرة واحدة.
- [MCP server](https://nodary.ai/glossary/mcp-server) (بالإنجليزية): An MCP server is a program that offers tools, resources and prompts to AI applications over the Model Context Protocol.
- [AI agent](https://nodary.ai/glossary/ai-agent) (بالإنجليزية): An AI agent is a language model that pursues a goal in steps, calling tools, reading their results and deciding what to do next.

https://nodary.ai/ar/docs/mcp/cursor