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

خادم MCP في Nodary

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

لمحة سريعة

العنوان
https://nodary.ai/api/mcp
النقل
Streamable HTTP (JSON-RPC عبر POST)
تسجيل الدخول
OAuth 2.1 مع تسجيل العميل الديناميكي وPKCE، أو مفتاح API
الوصول
إضافة MCP في خطة مدفوعة: ‏30 € لكل عضو أو ‏200 € لمساحة العمل بأكملها، شهريًا
الاكتشاف
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، فلا معرّف عميل تنشئه ولا شيء تنسخه. وتدوم رموز الوصول ساعة واحدة، ويجددها العميل.

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

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

خادم MCP إضافة إلى خطة مدفوعة (Pro أو Studio أو Enterprise): ‏30 € لكل عضو شهريًا، أو ‏200 € شهريًا لمساحة العمل بأكملها.

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

الأسعار

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

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

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

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

  • 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

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

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

  • create_game
  • update_game
  • 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

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

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

  • 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: فهو يخبر العميل أين يسجّل الدخول.
  • إذا قال استدعاء أداة إن إضافة MCP مطلوبة، فهذا يعني أن المالك لم يفعّلها لك بعد.
  • إذا تعذّر على العميل إكمال تسجيل الدخول، فاربطه بمفتاح API بدلًا من ذلك.