ربط Claude Code بـ Nodary

قبل أن تبدأ

• Claude Code مع تسجيل الدخول بحساب Pro أو Max أو Team أو Enterprise أو Console، أو باستخدامه عبر مزوّد سحابي مثل Amazon Bedrock. الخطة المجانية في claude.ai لا تشمل Claude Code.
• حساب على Nodary. خادم MCP مشمول في كل الخطط، وفي الخطة المجانية ما دامت مساحة العمل ضمن حدودها: المشاريع 1، والمستندات والمجلدات 10، والأعضاء 2. لا يستهلك Claude Code أي مذنّبات، فهو يعمل بنموذجه الخاص.

إضافة Nodary

1. شغّل هذا الأمر في الطرفية:

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

   نسخ
2. لاستخدام Nodary في كل مشاريعك، أضفه إلى نطاق المستخدم بدلًا من ذلك:

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

   نسخ
3. في Claude Code اكتب /mcp، واختر nodary، وسجّل الدخول: تُفتح صفحة الموافقة في Nodary في متصفحك. إن لم تُفتح فانسخ العنوان الذي يعرضه Claude Code، أو شغّل:

   claude mcp login nodary

   نسخ

النطاقات: النطاق local، وهو الافتراضي، يُبقي Nodary لك في هذا المشروع؛ وuser لك في كل المشاريع؛ وproject يكتب ملف .mcp.json في جذر المشروع ليتشاركه الفريق كله.

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

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

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

استخدام Nodary من الطرفية

اطلب بكلماتك. يستدعي Claude Code أدوات Nodary حين يحتاجها طلبك، ويسأل قبل استخدامها ما لم تكن قد سمحت بها. بعض الطلبات للبدء:

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

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

أرسل مفتاحك في ترويسة:

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

لمشاركة الخادم في .mcp.json دون مشاركة مفتاح، اقرأ المفتاح من متغير بيئة: يستبدل Claude Code القيمة ${NODARY_API_KEY} في ترويسات الخادم.

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

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

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

• لا يتحقق claude mcp add من المفتاح: يظهر المفتاح الخاطئ في /mcp كخادم فشل اتصاله.
• لتسجيل الدخول من جديد اختر Clear authentication في قائمة /mcp، أو شغّل claude mcp logout nodary، ثم سجّل الدخول.
• يعود مستند طويل مقطوعًا: ينبّه Claude Code حين تتجاوز مخرجات الأداة 10000 رمز، ويتوقف عند 25000 افتراضيًا. ارفع الحد بمتغير البيئة MAX_MCP_OUTPUT_TOKENS، أو اطلب قسمًا واحدًا.
• لا يكتمل تسجيل الدخول: اتصل بمفتاح واجهة برمجة بدلًا من ذلك، كما في الأعلى.
• تلقّي الطلب الأول الرد 401 أمر طبيعي: فهو يخبر العميل بمكان تسجيل الدخول.
• quota_locked: تجاوزت مساحة العمل الخطة المجانية بعد فترتها التجريبية وهي مقفلة حتى يشترك المالك. بعد الاشتراك تعود للعمل فورًا.
• billing_locked: فشلت عملية دفع، لذا تبقى مساحة العمل مقفلة حتى يسوّيها المالك من إعدادات الفوترة لمساحة العمل. وتعود للعمل فور نجاح الدفع.
• workspace_suspended: علّق Nodary مساحة العمل، فلا يصل إليها شيء، ولا حتى الوكلاء. ويمكن للمالك الكتابة إلى support@nodary.ai.
• workspace_required: يصل الاتصال إلى عدة مساحات عمل، فحدّد المساحة التي يجري العمل فيها، أو أعد الاتصال وحدّد مساحة واحدة فقط.

أسئلة

اقرأ أيضًا