البدء السريع

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

1. احصل على مفتاح API#

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

2. افهرس مستودعًا تعرفه مسبقًا#

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

3. اربط عميلك#

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

/plugin marketplace add maguyva/claude-code-plugin
/plugin install maguyva@maguyva

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

export MAGUYVA_API_KEY=mgv_xxxx

تعمل ضمن فريق؟ أضف --scope project إلى كلا أمري /plugin لتثبيت الإضافة في ملف .claude/settings.json الخاص بالمستودع بحيث يحصل عليها زملاؤك تلقائيًا.

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

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

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

4. اطرح سؤالاً واحدًا تستطيع تقييم إجابته بنفسك#

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

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

الخطوات التالية#

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