# يعيش وكيل Warp في الطرفية. امنحه خريطة للمستودع.

Canonical source: https://maguyva.ai/ar/for-warp

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).

يشغّل وكيل Warp الأوامر ويقرأ ما تطبعه. تفهرس Maguyva المستودع كله وتقدّمه عبر MCP، فيسأل الوكيل أين يقع الكود بدل تشغيل grep وcat إلى أن يتطابق شيء ما.

> إدخال mcpServers واحد في ‎~/.warp/.mcp.json: رابط URL وترويسة Authorization.

## ما يجب معرفته عن Warp

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

### ~/.warp/.mcp.json

يشغّل Warp الخوادم في هذا الملف العام من تلقاء نفسه. ويمكنك أيضًا لصق ملف JSON نفسه في Settings → Agents → MCP servers → + Add.

### بعيد، عبر URL

يتصل إدخال `url` عبر Streamable HTTP أو SSE. لا شيء يعمل محليًا ولا حاجة إلى Node.js.

### ترويسة حرفية

يوضع المفتاح مباشرة في ترويسة `Authorization`. احفظه في الملف العام، لا في `.warp/.mcp.json` الخاص بمشروع تودعه في Git.

### لا تبدأ تلقائيًا أبدًا

يكتشف Warp ملف `.warp/.mcp.json` في المستودع المستنسخ، لكنه ينتظر أن تشغّل كل خادم بنفسك. ويمكنه أيضًا قراءة الخوادم من إعدادات Claude Code وCodex بعد أن تفعّل ذلك.

## قواعد المشروع اتفاق عمل. استخدمها.

```text
# AGENTS.md
- شغّل make test قبل أن تعدّ التغيير مكتملًا.
- استخدم السكربتات في bin/، لا أوامر مرتجلة.
```

يقرأ Warp قواعد المشروع من `AGENTS.md` (أو `WARP.md`، الذي تكون له الأولوية إن وُجد الاثنان) ويطبّق القواعد العامة في كل مكان. استخدمها من أجل:

- أوامر البناء والاختبار والنشر.
- الأعراف التي يخطئ فيها الوكيل باستمرار.
- الأوامر التي يجب ألا يشغّلها الوكيل أبدًا.

تخبر القواعد الوكيل كيف يعمل. لكنها لا تستطيع أن تخبره أيّ خدمة لا تزال تقرأ متغير البيئة الذي توشك على إزالته.

## حين لا يكفي grep في الطرفية

ثلاثة أشياء لا تتعلّمها جلسة الصدفة بتكلفة قليلة.

### ‏// المخرجات تمرّ سريعًا

كل grep وcat يشغّله الوكيل ينتهي في المحادثة. بحث يطبع مئتي سطر يستهلك السياق قبل أن يبدأ العمل الحقيقي.

### ‏// التطابق ليس مستدعيًا

لا يميّز grep الاستدعاء الحقيقي من تعليق أو fixture أو تابع بالاسم نفسه في صنف آخر.

### ‏// الصدفة تبدأ من الصفر

الجلسة الجديدة لا تعرف شيئًا عن المستودع. فهرس Maguyva مبنيّ مسبقًا، فيحصل السؤال الأول على إجابة مرتّبة.

## Maguyva كخادم MCP في Warp

إدخال mcpServers واحد يمنح وكيل Warp:

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

> يمنح Warp الوكيل *طرفية*.
> Maguyva تمنح الوكيل *خريطة للكود*.

## سيرا عمل

اسأل الخريطة أولًا، ثم شغّل الأوامر.

### 01. تتبّع سكربتًا فاشلًا إلى مصدره

```text
warp agent> يفشل deploy.sh: المتغير BUILD_ID غير مضبوط. أين يُضبط؟

text_pattern_search("BUILD_ID=")
  ci/env.sh:9   export BUILD_ID=...
  docs/deploy.md:31   ← نص

→ يحمّل الوكيل ci/env.sh ويعيد تشغيل النشر.
[exit 0]
```

بحث مفهرس واحد يغني عن grep تكراري عبر المستودع ومخرجاته.

### 02. افحص المستدعين قبل تغيير خطوة إقلاع

```text
warp agent> هل يمكننا التوقف عن تشغيل الترحيلات عند بدء التشغيل؟

dependency_search("runMigrations", dependents)
  3 مستدعين: server.ts, worker.ts, scripts/seed.ts

→ ينقل الوكيل الثلاثة إلى خطوة الإصدار.
[exit 0]
```

يصل المستدعون قبل التغيير، فلا يقلع العامل (worker) على مخطط قديم.

## الإعداد في Warp

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

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

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

### 02. أضف Maguyva إلى ‎~/.warp/.mcp.json

`~/.warp/.mcp.json`

```json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}
```

### 03. استبدل العنصر النائب واطرح سؤالًا واحدًا

استبدل `mgv_xxxx` بمفتاح API الخاص بك واحفظ. تحقق من أن الخادم يعمل تحت Settings → Agents → MCP servers، ثم اطرح سؤالًا واحدًا تعرف إجابته مسبقًا.

تشرح [وثائق MCP](https://docs.warp.dev/agents/capabilities/mcp/) الخاصة بـWarp الخوادم المعرّفة في ملفات والمشاركة والمصادقة.

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

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