لمستخدمي Claude Desktop

‏Claude Desktop لا يرى مستودعك. امنحه واحدًا.

‏Claude Desktop هو المكان الذي يسأل فيه كثيرون عن كود لا يعدّلونه الآن: المراجعات، وتأهيل الموظفين الجدد، ومكالمات الحوادث. تفهرس Maguyva المستودع وتقدّمه عبر MCP، فتستشهد الإجابات بالملفات والأسطر بدل الذاكرة.

ابدأ مجانًا اقرأ دليل إعداد Claude Desktop

خطة Free: 3 مستودعات, حتى 50 ألف سطر مُفهرَس من المستودع، بلا بطاقة.

لا حاجة إلى نسخة محلية. اسأل الفهرس.

ما يجب معرفته عن Claude Desktop

أربع حقائق خاصة بـClaude Desktop.

‏// ملف الإعداد

claude_desktop_config.json

يفتحه المسار Settings → Developer → Edit Config. على macOS يوجد في ~/Library/Application Support/Claude/؛ وعلى Windows في %APPDATA%\Claude\.

‏// النقل

الجسر المحلي

يشغّل هذا الملف عمليات محلية، لذا يشغّل هذا الدليل @maguyva/mcp عبر npx. يجب تثبيت Node.js.

‏// المفتاح

إدخال env

يقرأ الجسر MAGUYVA_API_KEY من كتلة env الخاصة بالخادم في الملف نفسه.

‏// إعادة التشغيل

أغلق التطبيق، ثم أعد فتحه

يقرأ Claude Desktop الملف عند التشغيل. أغلق التطبيق بالكامل بعد التعديل؛ يبدأ الخادم عند التشغيل التالي.

تعليمات المشروع تحدد الإطار. استخدمها.

تحتفظ مشاريع Claude بالتعليمات والملفات التي تبدأ بها كل محادثة في المشروع. إنها المكان الصحيح لـ:

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

الملفات المرفوعة لقطة ثابتة. بعد يوم من رفعها يكون المستودع قد تغيّر.

حين لا يكفي الكود الملصوق

ثلاث طرق تنحرف بها محادثة عن الكود حين يغيب الكود.

‏// المقتطفات الملصوقة تتقادم

ملف لُصق في المحادثة الأسبوع الماضي يصف كود الأسبوع الماضي. يجيب Claude بثقة من النسخة التي أُعطيت له.

‏// المقتطف ليس النظام

نادرًا ما يجيب ملف واحد عن “ماذا يحدث حين يفشل هذا؟” فالمعالج وإعادة المحاولة والتنبيه تعيش عادة في ثلاث حزم مختلفة.

‏// لا نسخة محلية، لا grep

لا يملك Claude Desktop نسخة عمل من مستودعك. من دون أداة، تعتمد كل إجابة عن البنية على ما تذكّرت أن تلصقه.

Maguyva كخادم MCP في Claude Desktop

إدخال واحد في mcpServers يمنح Claude:

11 أداة على مستودعك المفهرس بحث دلالي وهيكلي (AST) وبالرسم البياني ونصي، إضافة إلى البحث عن الرموز والعناصر المعتمدة واسترجاع الملفات.
إجابات مع مسارات الملفات وأرقام الأسطر عبر أكثر من 285 لغة، لتتمكن من التحقق من كل ادعاء.
نتائج واعية بالفرع فيجيب Claude عن الفرع الذي تسمّيه، لا عن ملف رفعه أحدهم الشهر الماضي.

تعليمات المشروع تخبر Claude كيف يجيب.
Maguyva تمنح Claude الكود الذي يجيب انطلاقًا منه.

سيرا عمل

أسئلة كنت ستفتح IDE للإجابة عنها.

// workflow 01

اشرح مسار الكود أثناء المراجعة

claude> ماذا يحدث بعد أن يفشل خطاف ويب للدفع في فحص التوقيع؟

semantic_search("webhook signature verification failure")
  src/payments/webhooks.ts:64   verifySignature()
  src/payments/webhooks.ts:91   rejectAndAlert()

→ يجيب Claude مستشهدًا بالسطرين معًا.
[exit 0]

كل خطوة في الإجابة تشير إلى ملف وسطر يمكنك فتحهما.

// workflow 02

قدّر حجم التغيير قبل التخطيط له

claude> كم موضعًا يقرأ الحقل القديم plan_code؟

text_pattern_search("plan_code")
  14 تطابقًا في 9 ملفات
dependency_search("getPlanCode", dependents)
  6 مستدعين

→ يبدأ التقدير من عدد، لا من تخمين.
[exit 0]

مفيد في اجتماع تخطيط، حين لا يكون المستودع مفتوحًا لدى أحد.

الإعداد في Claude Desktop

ثلاث خطوات. خطة Free: 3 مستودعات, حتى 50 ألف سطر مُفهرَس من المستودع، بلا بطاقة.

// step 01

افهرس مستودعًا على maguyva.ai

اختر واحدًا تعرفه جيدًا، لتتمكَّن من التحقق من الإجابات.

// step 02

أضف Maguyva إلى claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "@maguyva/mcp"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

// step 03

استبدل العنصر النائب، وأعد التشغيل، واطرح سؤالًا واحدًا

استبدل mgv_xxxx بمفتاح API الخاص بك، وأغلق Claude Desktop بالكامل، ثم أعد فتحه. إن لم يظهر الخادم، فاقرأ mcp-server-maguyva.log في مجلد سجلات Claude (~/Library/Logs/Claude على macOS).