لمستخدمي Warp

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

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

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

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

إدخال 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 بعد أن تفعّل ذلك.

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

# 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 تمنح الوكيل خريطة للكود.

سيرا عمل

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

// workflow 01

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

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 تكراري عبر المستودع ومخرجاته.

// workflow 02

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

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

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

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

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

الإعداد في Warp

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

// step 01

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

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

// step 02

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

~/.warp/.mcp.json

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

// step 03

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

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