# إن كان يتحدَّث MCP، فهو يتحدَّث Maguyva.

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

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

التكامل ليس لكل أداة على حدة — إنه البروتوكول. Maguyva خادم MCP قياسي على عنوان URL واحد، فأيًّا كانت البيئة التي يعمل ضمنها وكيلك (Claude⁠ ⁠Code، أو Codex، أو Cursor، أو Gemini، أو Devin Desktop، أو Antigravity، أو Zed، أو Cline، أو أداة بنيتها بنفسك) يحصل على الخريطة القابلة للاستعلام نفسها عن مستودعك. افهرس مرة واحدة، وكل عميل تربطه يطرح الأسئلة المؤسَّسة نفسها.

> خادم MCP واحد. كل عميل. بلا إضافة لكل أداة، وبلا ارتهان.

## ما تقوم به كل طبقة

أربع قطع. لكل واحدة مهمتها.

### أي عميل MCP

23 عميل موثّق، منها Claude Code, Codex CLI, Gemini CLI, Cursor, Devin Desktop, Antigravity، أو وكيلك الخاص.

### MCP

المعيار المفتوح الذي يتحدثه كل واحد منها بالفعل.

### Maguyva

خادم MCP واحد. حقائق مستندة إلى المستودع، تُعاد مع مسار الملف ورقم السطر (file:line).

### مساحات عمل، لا مقاعد

الوكلاء لا يدفعون ثمن مقاعد. [عرض التسعير](https://maguyva.ai/ar/pricing)

## ‏MCP هو التكامل. اعتمده معيارًا.

البروتوكول المفتوح هو القرار الصحيح، لا حلًّا مؤقتًا. البناء على [MCP](https://modelcontextprotocol.io/docs/getting-started/intro) بدلًا من إضافة لكل أداة هو بالضبط ما يجنّبك إعادة التكامل في كل مرة يصدر فيها وكيل أفضل. إنه المكان الصحيح لـ:

- كتلة إعداد خادم واحدة تعمل مع أي عميل متوافق.
- أدوات وموارد قابلة للنقل عبر المحرِّرات وواجهات سطر الأوامر والوكلاء.
- حد أمني يمكن لفريق الأمان لديك مراجعته مرة واحدة، لا لكل بائع على حدة.
- حرية تبديل العملاء بلا إعادة بناء مكدَّس السياق لديك.

واصل فعل ذلك. التوحيد القياسي على MCP هو الخطوة الصحيحة.

لكن البروتوكول أنبوب. ينقل السؤال والجواب — لكنه لا *يعرف* قاعدة الكود لديك. لا بدّ من وجود شيء في الطرف الآخر يرسم فعليًا خريطة رموزك ومواقع استدعائك وتبعياتك.

## أين يتوقّف السياق الخاص بكل أداة عن التوسّع

أربعة أنماط فشل لا يمكن لملف قواعد وكيل واحد إصلاحها.

### ‏// كل أداة تبدأ التهيئة من الصفر

اختر وكيلًا جديدًا وسيبدأ أعمى على مستودعك من جديد. تُعيد لصق الملفات نفسها، وتُعيد تثبيت السياق نفسه، وتُعيد كتابة القواعد نفسها. العمل لا ينتقل لأنه لم يكن يومًا طبقة مشتركة.

### ‏// ملفات القواعد لا تنتقل

‏`CLAUDE.md`، و`.cursor/rules`، و`AGENTS.md` — كل واحد خاص بأداة، ولا واحد منها فهرس قابل للاستعلام عن كودك. بدِّل العملاء وستبقى الخريطة التي بنيتها يدويًا خلفك.

### ‏// الارتهان للتكامل ضريبة

ربط سياق عميق لقاعدة الكود بإضافة بائع واحد يعني أنك في اليوم الذي تجرِّب فيه وكيلًا مختلفًا، ستعيد بناءه. كلما كان سياقك أفضل، كلفك المغادرة أكثر.

### ‏// البروتوكول أنبوب، لا خريطة

‏MCP ينقل الأدوات والسياق بين العميل والخادم. إنه لا يعرف رموزك، أو مواقع استدعائك، أو الرسم البياني لتبعياتك. لا بدّ من وجود شيء في الطرف الآخر يجيب فعليًا عن السؤال.

## Maguyva هو الطبقة في الطرف الآخر من البروتوكول

ليست وكيلًا آخر. إنها خادم سياق المستودع الذي يمكن لأي عميل MCP استدعاءه:

- **نقطة نهاية واحدة، لكل عميل**: تخدم `https://maguyva.tools/mcp` ذاتها Claude Code, Codex CLI, Gemini CLI, Cursor, Devin Desktop, Antigravity، أو سكربتًا كتبته هذا الصباح.
- **دلالي + AST + بياني + نصي**: ابحث بالمعنى، أو البنية، أو التبعية، أو النص الحرفي. كل نتيجة تُعيد مسار ملف ورقم سطر، أيًا كان العميل الذي سأل.
- **واعٍ بالفروع، وعابر للحزم**: يرى Maguyva إصدار الكود الذي يعدّله الوكيل، عبر كل حزمة في المستودع الموحّد (monorepo).
- **بلا ارتباط بمزود**: بدّل الوكلاء متى شئت؛ طبقة السياق لا تتحرك. تسعير حسب مساحة العمل، لا لكل مقعد — افهرس مستودعًا واحدًا أو 50.

> عميلك يتحدَّث MCP.
> Maguyva هو من يجيب *حين يسأل عن كودك.*

## ثلاثة تدفقات عمل، متطابقة من كل عميل

عابر للحزم، وعابر للغات. العميل يتغيَّر؛ الإجابة المؤسَّسة لا تتغيَّر.

### 01. إيجاد تدفق المصادقة عبر الحزم، من أي وكيل

```text
agent> أين تحدث المصادقة في هذا المستودع الموحّد؟

graph::query("authentication flow")
  packages/web/src/auth/session.ts:42       طبقة وسيطة
  packages/api/src/auth/jwt.ts:88           التحقق من الرمز
  packages/shared/src/auth/types.ts:12      AuthContext
  packages/admin/src/auth/admin-only.ts:31  فحص صلاحيات RBAC

→ 4 نقاط دخول عبر 4 حزم، مرتَّبة حسب كثافة مواقع الاستدعاء.
[exit 0]
```

‏Claude⁠ ⁠Code، أو Cursor، أو سكربت خاص بك — لا يهم أي عميل أرسل الاستعلام. تعود الملفات الأربعة نفسها بالترتيب نفسه، مؤسَّسة على الرسم البياني الفعلي.

### 02. إيجاد التنفيذ الحقيقي، لا البديل الوهمي

```text
agent> كيف تتعامل normalizePhoneNumber مع E.164؟

semantic::query("normalize phone E.164")
  packages/shared/util/phone.ts:88     normalizePhoneNumber()  ← التنفيذ الحقيقي
  packages/api/test/phone.spec.ts:14   jest.mock(...)          ← بديل وهمي
[exit 0]
```

الأسماء تكذب. المحاكيات تحجب الكود الحقيقي. يُرتِّب Maguyva التنفيذ الحقيقي فوق محاكي الاختبار — بالطريقة نفسها لكل عميل يسأل.

### 03. تحقّق من نطاق التأثير قبل إعادة الهيكلة

```text
agent> ما الذي يستدعي QueueDispatcher.publish عبر المستودع الموحّد؟

graph::callers(QueueDispatcher.publish)
  3 في packages/billing/*
  1 في packages/audit/*
  1 في packages/notifications/*
  1 في services/python-worker/*  ← عابر للغات عبر واجهة gRPC ‏(stub)
[exit 0]
```

عابر للحزم، وعابر للغات في مستودع متعدد اللغات، تظهر مواقع الاستدعاء ضمن السياق. بدِّل الوكلاء غدًا وسيبقى نطاق التأثير موجودًا، لأنه يعيش في الخادم، لا في العميل.

## الإعداد مع أي عميل MCP

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

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

اختر مستودعًا تعرفه جيدًا حتى تستطيع التحقق من الإجابات. تغطي خطة Free 3 مستودعات, حتى 50 ألف سطر مُفهرَس من المستودع.

### 02. أضف Maguyva كخادم MCP في أي عميل تستخدمه

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

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

ابدأ بمستودع واحد وسؤال واحد يمكن التحقق منه، مثل «ما الذي يستدعي `formatInvoice` عبر الحزم؟» إذا طابقت الإجابة ما كنت لتقوله، فسيحصل كل عميل آخر توجِّهه إليه على النتيجة المؤسَّسة نفسها.

تعليمات خاصة بكل عميل (Claude⁠ ⁠Code، Codex، Cursor، Gemini، Devin Desktop، Antigravity، والمزيد) موجودة في [وثائق توافق Maguyva](https://maguyva.ai/ar/docs/compatibility).

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

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

## المصادر

- [MCP: مقدمة رسمية](https://modelcontextprotocol.io/docs/getting-started/intro)
- [MCP: أمثلة على العملاء](https://modelcontextprotocol.io/clients)
- [Maguyva: التوافق والعملاء](https://maguyva.ai/ar/docs/compatibility)
- [Maguyva: البنية التقنية والأمان](https://maguyva.ai/ar/stack)
- [Maguyva: الأسعار (مساحة العمل، لا لكل مقعد)](https://maguyva.ai/ar/pricing)