انتقل إلى المحتوى
Nodary
ابدأ مجانًا

خادم MCP في Nodary

يشغّل Nodary خادم MCP بعيدًا، فيقرأ وكيل الذكاء الاصطناعي مساحة عملك ويكتب فيها كما يفعل زميل في الفريق: المستندات نفسها، والصلاحيات نفسها، وباسمك.

لمحة سريعة

العنوان
https://nodary.ai/api/mcp
النقل
Streamable HTTP (JSON-RPC عبر POST)
تسجيل الدخول
OAuth 2.1 مع تسجيل العميل الديناميكي وPKCE، أو مفتاح API
الوصول
مشمول في كل خطة؛ وفي الخطة المجانية ضمن حدودها
الاكتشاف
https://nodary.ai/.well-known/oauth-protected-resource/api/mcp · https://nodary.ai/.well-known/mcp.json

Claude Code: شغّل هذا الأمر في الطرفية (أضف --scope user لاستخدام Nodary في كل مشروع):

claude mcp add --transport http nodary https://nodary.ai/api/mcp

ما هو

بروتوكول سياق النموذج (Model Context Protocol، أو MCP) هو المعيار المفتوح الذي يستخدمه عملاء الذكاء الاصطناعي للعمل مع الأدوات الخارجية. ويمنح خادم Nodary الوكيل مساحة العمل نفسها التي يستخدمها فريقك: المشاريع، والمستندات وروابطها، وجداول البيانات، والصور، وجداول الترجمة، والحوارات، واللوحات.

لا يحصل الوكيل على نسخة. بل يقرأ ما هو موجود الآن، ويكتب حيث تطلب منه، وتحمل كل نتيجة رابطًا يستطيع أي شخص فتحه للتحقق من عمله.

تسجيل الدخول

يسجّل معظم العملاء الدخول عبر OAuth: أعطِ العميل عنوان الخادم فيفتح في متصفحك صفحة تسجيل الدخول والموافقة في Nodary. ويدعم Nodary بروتوكول OAuth 2.1 مع تسجيل العميل الديناميكي وPKCE، فلا معرّف عميل تنشئه ولا شيء تنسخه. وتدوم رموز الوصول ساعة واحدة، ويجددها العميل.

يمكن لاتصال واحد أن يصل إلى عدة مساحات عمل. إن كنت عضوًا في أكثر من مساحة، تعرضها صفحة الموافقة كلها محددة: يصل التطبيق عندئذ إلى مساحات العمل التي تتركها محددة، وإليها فقط. ويبقى خيار «وأيضًا مساحات العمل التي سأنضم إليها لاحقًا» معطّلًا ما لم تحدده. في اتصال كهذا تأخذ كل أداة workspace (معرّفها أو الـ slug أو اسمها): يجب أن يسمّيها كل استدعاء يغيّر شيئًا، ولا تعمل القراءة من دونها إلا حيث توجد معرّفاتها، وتبدأ كل نتيجة بمساحة العمل التي نُفّذت فيها. ويبقى مفتاح API مرتبطًا بمساحة عمل واحدة.

يمكن للعميل الذي لا يستطيع تسجيل الدخول استخدام مفتاح API بدلًا من ذلك: أنشئ مفتاحًا في ملفك الشخصي، ضمن API keys & MCP (يبدأ بـ gdc_)، وأرسله في الترويسة Authorization: Bearer gdc_… ويمكن حصر المفتاح في مشروع واحد.

من يمكنه استخدامه

خادم MCP مشمول في كل خطة، المجانية وPro وStudio وEnterprise، لكل عضو وبلا تكلفة إضافية.

في الخطة المجانية، يقرأ الوكيل ويكتب كما في خطة مدفوعة ما دامت مساحة العمل ضمن حدود الخطة: المشاريع 1، والمستندات والمجلدات 10، والأعضاء 2. وأي كتابة قد تتجاوز حدًا تُرفض مع ذكر الحد الذي بلغته وطريقة رفعه: ما دام بإمكان مساحة العمل الحصول على فترتها التجريبية، رابط لوحة التحكم حيث يبدأ المالك أو مسؤول الفترة التجريبية لـ Studio التي عدد أيامها 14 (مع MCP وبلا بطاقة)؛ وإلا فرابط صفحة الأسعار.

مساحة العمل التي تتجاوز الخطة المجانية بعد فترتها التجريبية ودون اشتراك تكون مقفلة إلى أن يتم الاشتراك: يُقطع الوكلاء فيها، حتى عن القراءة. الاتصال بتلك المساحة وحدها يتلقى quota_locked على كل طلب مع ما تم تجاوزه والمكان الذي يشترك فيه المالك؛ أما الاتصال بعدة مساحات عمل فلا يتلقى quota_locked (أو billing_locked بعد فشل دفعة) إلا على الاستدعاءات الموجهة إلى المساحة المقفلة، كخطأ أداة، ويواصل العمل في المساحات الأخرى.

الأسعار

ما الذي يستطيع الوكيل فعله

عدد الأدوات 92، وقد جمعناها هنا حسب المهمة التي تؤديها. وتُعلم كل أداة العميل هل تقرأ فقط، وهل يمكن لعملية كتابة أن تستبدل شيئًا موجودًا، ليتمكن العميل من سؤالك قبل أن يتصرف.

البحث والقراءة

المشاريع، والمستندات مع روابطها وسجلها، والتعليقات، وملاحظات المعرفة، وطرق العرض المحفوظة، وموجزات السياق. وتحمل النتائج روابط يمكن للأشخاص فتحها.

  • list_games
  • list_stars
  • search_documents
  • get_document
  • get_star
  • get_tree
  • list_templates
  • list_members
  • list_project_knowledge
  • get_project_knowledge
  • list_comments
  • get_canon
  • list_versions
  • get_version
  • diff_versions
  • list_deleted_stars
  • list_context_briefs
  • get_context_brief
  • list_saved_views
  • get_saved_view
  • list_favorites
  • get_workspace_usage
  • list_properties
  • get_file_url
  • describe_blocks
  • run_view
  • list_workspaces

الكتابة والتنظيم

إنشاء المستندات وتحريرها كتلةً كتلة، وترتيبها في مجلدات، وربطها، ووسمها، والتعليق، وتعيين الخصائص، وحسم التناقضات. ويمكن استعادة المستند المحذوف.

  • create_game
  • update_game
  • rename_workspace
  • create_starter_constellation
  • create_from_template
  • create_star
  • create_stars
  • write_document
  • append_document
  • edit_document
  • update_star
  • update_stars
  • delete_star
  • restore_star
  • create_cluster
  • move_to_cluster
  • link_stars
  • unlink_stars
  • set_tags
  • save_project_knowledge
  • add_comment
  • add_comments
  • resolve_comment
  • list_contradictions
  • report_contradiction
  • resolve_contradiction
  • save_context_brief
  • save_saved_view
  • set_favorite
  • define_properties
  • set_properties
  • restore_version
  • edit_comment
  • delete_comment
  • delete_project_knowledge
  • remove_context_brief
  • remove_saved_view
  • open_daily_note

المراجعة الفنية والصور

استيراد الصور، والنظر إليها مع الملاحظات التي رسمها الأشخاص عليها، واتخاذ القرار بشأن التسليمات وتدوين الملاحظات عليها ووسمها (كل قرار موقّع باسم صاحبه ووقته)، وتحويل لوحة إلهام إلى لوحة ألوان والتحقق من التزام صورة بها، وإعداد ورقة ملاحظات لمتعهّد خارجي.

  • add_image
  • start_upload
  • add_media
  • get_image
  • get_moodboard
  • render_board
  • edit_board
  • find_pictures
  • update_pictures
  • get_art_review
  • extract_palette
  • check_palette
  • feedback_sheet
  • restore_image_version
  • set_image_origin

جداول البيانات وموازنة اللعب

قراءة الجدول كقيم محسوبة مع الصيغة التي وراء كل خلية، وكتابة الخلايا حسب العنوان أو حسب الصف، وقراءة جدول الغنائم لفهم ما يعنيه للاعبين.

  • get_sheet
  • set_cells
  • analyze_drops

التوطين والحوار

عرض تقدّم كل لغة في جدول الترجمة، وكتابة الترجمات حسب المفتاح، والتحقق من حوار متفرّع يُصدَّر كسكربت Yarn Spinner.

  • get_localization
  • set_translations
  • check_dialogue

الإنتاج

تحديد تواريخ الاستحقاق، وطلب المراجعات وتقديمها، ومعرفة ما تغيّر مؤخرًا، وهل ستُبلَغ المرحلة الرئيسية في موعدها.

  • get_progress
  • recent_changes
  • set_due_date
  • set_due_dates
  • request_review
  • submit_review

الموجّهات والموارد

طلبات جاهزة يمكن للعميل عرضها كأوامر:

  • weekly-summary: ما الذي تغيّر هذا الأسبوع في مساحة العمل أو في مشروع واحد: ما كُتب، وما تقرّر، وما رُوجع، وما يزال مفتوحًا.
  • art-review: أين وصلت المراجعة الفنية: الصور التي تنتظر قرارًا، وتلك التي تبتعد عن لوحة الألوان، وما الذي ينبغي تقريره بعد ذلك.
  • playtest-to-tasks: يحوّل ملاحظات اختبار اللعب إلى مهام، كلٌّ منها مرتبطة بمستند التصميم الذي تخصّه.
  • balance-review: يقرأ جدول غنائم أو منحنى تقدّم، ويوضح ما يعنيه للاعبين وما يبدو غير سليم.

موارد يمكن للعميل إرفاقها دون استدعاء أداة:

  • nodary://star/{id}: مستند، بصيغة Markdown
  • nodary://project/{id}: هيكل مشروع

الأمان

  • يتصرف الوكيل بصفته الشخص الذي ربطه: لا يرى ولا يغيّر إلا ما يستطيعه ذلك الشخص، والمفتاح المحصور في مشروع يبقى داخل ذلك المشروع.
  • في الاتصال بعدة مساحات عمل لا يُحَل أي شيء عبرها: يُبحث عن المعرّفات والعناوين في مساحة العمل التي يسمّيها الاستدعاء فقط، ويُرفض معرّف من مساحة أخرى قبل تنفيذ أي شيء، وتسمّي كل نتيجة مساحة عملها.
  • تحتفظ المستندات بسجل إصداراتها، ويمكن استعادة المستند المحذوف.
  • تقبل أدوات الكتابة مفتاح عدم تكرار (idempotency key): الاستدعاء الذي يُعاد بعد انقطاع الاتصال يُرجع النتيجة الأولى بدل أن يكتب مرتين.
  • يرسل كل اتصال 120 طلبًا في الدقيقة على الأكثر؛ ولا يوجد حد يومي للكتابة.
  • تُوقَّع قرارات المراجعة الفنية باسم الشخص الذي اتخذها وبوقت اتخاذها.
  • يُبلغ Nodary كل وكيل بأن نص المستندات والتعليقات محتوى يُعمل عليه، لا تعليمات يجب اتباعها. أما كيف يتصرف الوكيل بناءً على ذلك فأمر يعود إلى الوكيل نفسه.

اربط عميلك

استخدم العنوان https://nodary.ai/api/mcp. وقد جرى التحقق من كل عميل أدناه وفق وثائقه الخاصة في 1 أكتوبر 2026.

Claude (claude.ai وClaude Desktop)

  1. افتح Customize، ثم Connectors، واختر Add custom connector.
  2. أدخل https://nodary.ai/api/mcp. وعندما يسألك Claude عن طريقة التسجيل، اختر Register automatically.
  3. اختر Connect، ثم سجّل الدخول إلى Nodary ووافق على الوصول.

الموصلات المخصصة متاحة في خطط Free وPro وMax وTeam وEnterprise؛ ويمكن لحساب Free إضافة موصل واحد. وفي Team وEnterprise، يضيف المالك الموصل للمؤسسة أولًا.

ChatGPT

  1. في Settings، ضمن Security and login، فعّل Developer mode.
  2. أنشئ تطبيقًا لخادم MCP بعيد بالعنوان https://nodary.ai/api/mcp مع تسجيل الدخول عبر OAuth.
  3. سجّل الدخول إلى Nodary ووافق على الوصول. ستظهر الأدوات بعد ذلك في Developer mode داخل مربع الكتابة.

يتوفر Developer mode على الويب لحسابات Plus وPro وBusiness وEnterprise وEducation؛ وفي Business وEnterprise، قد يلزم أن يسمح به أحد المسؤولين. ويتصل ChatGPT عبر OAuth فقط، لا بمفتاح API.

Claude Code

  1. شغّل هذا الأمر في الطرفية (أضف --scope user لاستخدام Nodary في كل مشروع):
    claude mcp add --transport http nodary https://nodary.ai/api/mcp
  2. في Claude Code، اكتب /mcp، واختر nodary، ثم سجّل الدخول من المتصفح.

باستخدام مفتاح API بدلًا من ذلك

claude mcp add --transport http nodary https://nodary.ai/api/mcp \
  --header "Authorization: Bearer gdc_..."

Cursor

  1. أضف Nodary إلى ~/.cursor/mcp.json (لكل المشاريع) أو إلى .cursor/mcp.json (لمشروع واحد):
    {
  "mcpServers": {
    "nodary": {
      "url": "https://nodary.ai/api/mcp"
    }
  }
}
  2. يعرض Cursor تسجيل الدخول عندما يطلبه الخادم أول مرة.

باستخدام مفتاح API بدلًا من ذلك

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

VS Code (GitHub Copilot)

  1. أضف Nodary إلى .vscode/mcp.json في مساحة عملك، أو شغّل الأمر MCP: Add Server:
    {
  "servers": {
    "nodary": {
      "type": "http",
      "url": "https://nodary.ai/api/mcp"
    }
  }
}
  2. شغّل الخادم؛ وسيفتح VS Code صفحة تسجيل الدخول إلى Nodary.

في Copilot Business وEnterprise، يجب أن يسمح المسؤول بخوادم MCP أولًا.

باستخدام مفتاح API بدلًا من ذلك

{
  "inputs": [
    {
      "type": "promptString",
      "id": "nodary-key",
      "description": "Nodary API key",
      "password": true
    }
  ],
  "servers": {
    "nodary": {
      "type": "http",
      "url": "https://nodary.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:nodary-key}"
      }
    }
  }
}

Devin Desktop (المعروف سابقًا باسم Windsurf)

  1. أضف الخادم وسجّل الدخول من الطرفية:
    devin mcp add -s user nodary https://nodary.ai/api/mcp
devin mcp login nodary
  2. أو أضفه إلى ~/.config/devin/mcp_config.json (على Windows: %APPDATA%\devin\mcp_config.json):
    {
  "mcpServers": {
    "nodary": {
      "url": "https://nodary.ai/api/mcp",
      "transport": "http"
    }
  }
}

إذا لم يعمل شيء ما

  • من المتوقع أن يُجاب الطلب الأول بالرمز 401 مع عنوان resource_metadata: فهو يخبر العميل أين يسجّل الدخول.
  • إذا رُفض طلب بـ quota_locked، فهذا يعني أن مساحة العمل تتجاوز الخطة المجانية بعد فترتها التجريبية ومقفلة إلى أن يتم الاشتراك: فور اشتراك المالك، يعمل الوكيل من جديد. وفي الاتصال بعدة مساحات عمل، لا تُرفض إلا الاستدعاءات الموجهة إلى تلك المساحة.
  • يسرد الاستدعاء المرفوض بـ workspace_required (أو workspace_not_found) مساحات العمل التي يصل إليها الاتصال: مرّر إحداها في workspace. للوصول إلى مساحة عمل غير موجودة في القائمة، أعد ربط التطبيق وحددها.
  • إذا تعذّر على العميل إكمال تسجيل الدخول، فاربطه بمفتاح API بدلًا من ذلك.