البدء السريع

أسرع طريق من الصفر إلى إجابة مؤكدة: احصل على مفتاح، وافهرس مستودعًا واحدًا تعرفه مسبقًا، واربط عميلك، واطرح سؤالاً واحدًا تستطيع تقييم إجابته بنفسك.

ابدأ مجانًا — بلا حاجة إلى بطاقة ائتمان. مفتاح API الخاص بك (يبدأ بـmgv_) موجود في app.maguyva.ai.

اربط مستودع GitHub من البوابة ودعه يُفهرَس. اختر مستودعًا صغيرًا يمكنك التحقق منه بسرعة — فهذا يوضّح ما إذا كان Maguyva يربط إجابات النموذج بالكود الفعلي، بدلاً من محاولة فهرسة شركتك بأكملها في اليوم الأول.

بالنسبة لـClaude Code، ثبّت إضافة Maguyva من السوق — نفّذ كل أمر داخل Claude Code:

/plugin marketplace add maguyva/agent-plugins
/plugin install maguyva@maguyva

تُصادِق الإضافة باستخدام مفتاحك من متغير البيئة MAGUYVA_API_KEY. اضبطه في مفسّر الأوامر (shell) الخاص بك (يُنصح باستخدام direnv لكل مشروع، لأن المفاتيح مخصصة لكل مستودع):

export MAGUYVA_API_KEY=mgv_xxxx

تعمل ضمن فريق؟ اختر النطاق project في اللوحة التي يفتحها /plugin install maguyva@maguyva. يسجّل ذلك الإضافة في ملف .claude/settings.json الخاص بالمستودع، والذي تودعه في Git؛ ومع ذلك يشغّل كل زميل التثبيت مرة واحدة. لا تقبل أوامر /plugin داخل الجلسة الخيار --scope، لذا لأتمتة ذلك، شغّل صيغة shell من جذر المستودع:

claude plugin marketplace add maguyva/agent-plugins --scope project
claude plugin install maguyva@maguyva --scope project

يتصل معظم العملاء الآخرين (Cursor، وVS Code، وDevin Desktop، وZed، وأمثالها) بالخادم البعيد مباشرة — وجّهها نحو نقطة النهاية (endpoint) بترويسة Bearer، بلا حاجة لجسر. على سبيل المثال، ملف .cursor/mcp.json الخاص بـCursor:

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

يختلف الشكل قليلاً من عميل لآخر (يُدرَج VS Code تحت servers مع type: "http"، ويستخدم Antigravity serverUrl، ويستخدم Zed context_servers). يقرأ مثال Cursor هذا مفتاحك من متغير البيئة MAGUYVA_API_KEY الموضّح أعلاه؛ وإذا كان إعداد أحد العملاء يعرض العنصر النائب mgv_xxxx بدلًا من ذلك، فاستبدله بمفتاح API الخاص بك. ثم أعد تشغيل عميلك. الإعداد الدقيق لجميع العملاء الموثّقين البالغ عددهم 23 موجود في دليل التثبيت.

ابدأ بـ"ما المستودعات المتصلة لديّ؟" للتأكد من الاتصال، ثم اطرح سؤالاً حقيقيًا واحدًا عن مستودعك تعرف إجابته مسبقًا — شيئًا مثل "كيف تُعالَج المصادقة في قاعدة الكود هذه؟"

يجب أن تحصل على إجابات تتضمن مسارات الملفات وأرقام الأسطر. افتح الملفات المستشهد بها وتحقق من أن الإجابة تصمد أمام المستودع الفعلي. تلك الإجابة الواحدة المُقيَّمة تخبرك أكثر من أي قائمة ميزات — اجعل الأداة تكسب ثقتك قبل أن تنضم إلى حلقتك الافتراضية.

• دليل التثبيت — إعداد لكل عميل ضمن جميع العملاء الموثّقين البالغ عددهم 23
• كيف يعمل — ما الذي يحدث بين سؤالك والإجابة
• مرجع MCP API — كل أداة، معلمةً تلو الأخرى