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

Canonical source: https://maguyva.ai/ar/for-claude-desktop

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

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

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

## ما يجب معرفته عن 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 للإجابة عنها.

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

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

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

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

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

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

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

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

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

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

## الإعداد في Claude Desktop

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

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

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

### 02. أضف Maguyva إلى claude_desktop_config.json

`claude_desktop_config.json`

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

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

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

يشرح [دليل MCP للخوادم المحلية](https://modelcontextprotocol.io/docs/develop/connect-local-servers) ملف الإعداد وسجلاته بتفصيل أكبر.

## افهرس مستودعًا واحدًا تعرفه جيدًا.

اتصل بـClaude Desktop عبر MCP، ثم اطرح سؤالًا واحدًا يمكنك التحقق منه.