دليل التثبيت

ثبّت إضافة Maguyva من سوق Claude Code:

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

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

يفتح /plugin install تفاصيل الإضافة، وفيها تختار نطاق التثبيت: أنت فقط (user)، أو كل من يعمل في هذا المستودع (project)، أو أنت فقط في هذا المستودع (local). لا تقبل هذه الأوامر داخل الجلسة الخيار --scope.

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

export MAGUYVA_API_KEY=mgv_xxxx

يُنصح باستخدام direnv (.envrc) لكل مشروع — المفاتيح مخصصة لكل مستودع، لذا تتوافق القيمة الخاصة بكل مشروع مع صلاحيات وصوله. يعمل التصدير العام لمفسّر الأوامر إن كان مفتاح واحد يغطي كل عملك.

للفرق، يمكنك بدلًا من ذلك تشغيل صيغة shell للأمرين من جذر المستودع، خارج Claude Code:

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

يسجّل النطاق project الإضافة في ملف .claude/settings.json الخاص بالمستودع، والذي تودعه في Git. يفعّل ذلك الإضافة لزملائك لكنه لا ينزّلها، لذا يشغّل كل زميل أمر التثبيت مرة واحدة.

claude mcp add --transport http maguyva https://maguyva.tools/mcp --header 'Authorization: Bearer ${MAGUYVA_API_KEY}'

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

استبدل mgv_xxxx بمفتاح API الخاص بك من app.maguyva.ai.

ما يضيفه Maguyva إلى Claude Code →

وثائق MCP لـ Claude Code →

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %AppData%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

أضِف إلى ملف إعداد Claude Desktop الخاص بك:

{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "@maguyva/mcp"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

استبدل mgv_xxxx بمفتاح API الخاص بك من app.maguyva.ai.

لا يشغّل claude_desktop_config.json إلا الخوادم المحلية، لذا يستخدم هذا الإعداد جسر @maguyva/mcp (يتطلب Node.js / npx). ويمكن لـClaude Desktop أيضًا الوصول إلى Maguyva كموصّل مخصص (Customize → Connectors) مع ترويسة طلب authorization، لكن ترويسات الطلب في مرحلة تجريبية لعدد محدود من المؤسسات.

ما يضيفه Maguyva إلى Claude Desktop →

وثائق MCP لـ Claude Desktop →

macOS: ~/.cursor/mcp.json
Windows: %UserProfile%\.cursor\mcp.json
Linux: ~/.cursor/mcp.json

أضِف إلى .cursor/mcp.json في جذر مشروعك:

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

يقرأ هذا الإعداد مفتاحك من متغير البيئة MAGUYVA_API_KEY. اضبطه على مفتاح API الخاص بك من app.maguyva.ai في البيئة التي يبدأ منها عميلك.

ما يضيفه Maguyva إلى Cursor →

وثائق MCP لـ Cursor →

أضف إلى ‎.vscode/mcp.json في مشروعك، أو إلى mcp.json في ملف تعريفك (شغّل MCP: Open User Configuration):

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

يقرأ هذا الإعداد مفتاحك من متغير البيئة MAGUYVA_API_KEY. اضبطه على مفتاح API الخاص بك من app.maguyva.ai في البيئة التي يبدأ منها عميلك.

هذه صيغة VS Code (المفتاح servers). يحلّ VS Code المرجع MAGUYVA_API_KEY من البيئة التي يبدأ منها. يفضّل مسار Add Server الآن الملف المحمول ‎.mcp.json (المفتاح mcpServers) الذي يقرأه GitHub Copilot CLI أيضًا؛ وهذا الملف لا يدعم متغيرات الإدخال أو ملفات البيئة في VS Code.

ما يضيفه Maguyva إلى VS Code / GitHub Copilot →

وثائق MCP لـ VS Code / GitHub Copilot →

macOS: ~/.config/devin/mcp_config.json
Windows: %APPDATA%\devin\mcp_config.json
Linux: ~/.config/devin/mcp_config.json

أصبح Windsurf الآن Devin Desktop. أضف إلى ملف إعدادات MCP الخاص به:

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

يقرأ هذا الإعداد مفتاحك من متغير البيئة MAGUYVA_API_KEY. اضبطه على مفتاح API الخاص بك من app.maguyva.ai في البيئة التي يبدأ منها عميلك.

يقرأ Devin Local، الوكيل الافتراضي، هذا الملف بدءًا من الإصدار 3.6؛ أما الإصدارات الأقدم فكانت تحفظ الخوادم في ملف الإعدادات الرئيسي وتنقلها إلى هنا عند بدء التشغيل. ويقرأ وكيل Cascade القديم، الذي لا تبدأ به المحادثات الجديدة، الملف نفسه. يحلّ Devin Desktop المرجع MAGUYVA_API_KEY من البيئة التي يبدأ منها.

ما يضيفه Maguyva إلى Devin Desktop (Windsurf) →

وثائق MCP لـ Devin Desktop (Windsurf) →

macOS: ~/.codex/config.toml
Windows: %UserProfile%\.codex\config.toml
Linux: ~/.codex/config.toml

أضِف إلى إعداد Codex CLI الخاص بك (~/.codex/config.toml):

[mcp_servers.maguyva]
url = "https://maguyva.tools/mcp"
bearer_token_env_var = "MAGUYVA_API_KEY"

يقرأ هذا الإعداد مفتاحك من متغير البيئة MAGUYVA_API_KEY. اضبطه على مفتاح API الخاص بك من app.maguyva.ai في البيئة التي يبدأ منها عميلك.

ما يضيفه Maguyva إلى Codex →

وثائق MCP لـ Codex →

أضِف إلى ~/.copilot/mcp-config.json:

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

copilot mcp add --transport http --header "Authorization: Bearer mgv_xxxx" maguyva https://maguyva.tools/mcp

استبدل mgv_xxxx بمفتاح API الخاص بك من app.maguyva.ai.

ما يضيفه Maguyva إلى GitHub Copilot CLI →

وثائق MCP لـ GitHub Copilot CLI →

macOS: ~/.gemini/settings.json
Windows: %UserProfile%\.gemini\settings.json
Linux: ~/.gemini/settings.json

أضِف إلى إعدادات Gemini CLI الخاصة بك (~/.gemini/settings.json):

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

يقرأ هذا الإعداد مفتاحك من متغير البيئة MAGUYVA_API_KEY. اضبطه على مفتاح API الخاص بك من app.maguyva.ai في البيئة التي يبدأ منها عميلك.

ما يضيفه Maguyva إلى Gemini CLI →

وثائق MCP لـ Gemini CLI →

macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Windows: %AppData%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

أضِف إلى إعدادات MCP الخاصة بـCline:

{
  "mcpServers": {
    "maguyva": {
      "type": "streamableHttp",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

استبدل mgv_xxxx بمفتاح API الخاص بك من app.maguyva.ai.

ما يضيفه Maguyva إلى Cline →

وثائق MCP لـ Cline →

macOS: ~/.config/goose/config.yaml
Windows: %APPDATA%\Block\goose\config\config.yaml
Linux: ~/.config/goose/config.yaml

أضِف إلى إعداد Goose الخاص بك:

extensions:
  maguyva:
    name: maguyva
    type: streamable_http
    uri: https://maguyva.tools/mcp
    enabled: true
    headers:
      Authorization: Bearer mgv_xxxx
    timeout: 300

استبدل mgv_xxxx بمفتاح API الخاص بك من app.maguyva.ai.

ما يضيفه Maguyva إلى Goose →

وثائق MCP لـ Goose →

في LM Studio، افتح علامة التبويب Program في الشريط الجانبي الأيمن، واختر Install → Edit mcp.json، ثم أضف:

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

استبدل mgv_xxxx بمفتاح API الخاص بك من app.maguyva.ai.

وثائق MCP لـ LM Studio →

احفظ باسم ‎.continue/mcpServers/maguyva.yaml في مساحة عملك (أو أضف إدخال mcpServers إلى ‎~/.continue/config.yaml)، ثم اضبط MAGUYVA_API_KEY في ‎~/.continue/.env:

name: Maguyva
version: 0.0.1
schema: v1
mcpServers:
  - name: maguyva
    type: streamable-http
    url: https://maguyva.tools/mcp
    requestOptions:
      headers:
        Authorization: Bearer ${{ secrets.MAGUYVA_API_KEY }}

يقرأ هذا الإعداد مفتاحك من متغير البيئة MAGUYVA_API_KEY. اضبطه على مفتاح API الخاص بك من app.maguyva.ai في البيئة التي يبدأ منها عميلك.

يستخدم Continue خوادم MCP في وضع الوكيل فقط. ويبحث عن السرّ في ‎~/.continue/.env، ثم في ‎.continue/.env و‎.env في مساحة العمل، ثم في بيئة العملية.

ما يضيفه Maguyva إلى Continue →

وثائق MCP لـ Continue →

macOS: ~/.kiro/settings/mcp.json
Windows: %USERPROFILE%\.kiro\settings\mcp.json
Linux: ~/.kiro/settings/mcp.json

أضف إلى إعدادات MCP في Kiro CLI ‏(‎~/.kiro/settings/mcp.json، أو ‎.kiro/settings/mcp.json في مشروع):

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

استبدل mgv_xxxx بمفتاح API الخاص بك من app.maguyva.ai.

حلّ Kiro CLI محلّ Amazon Q Developer CLI. عند تثبيته ينسخ خوادمك مرة واحدة من ‎~/.aws/amazonq/mcp.json إلى ‎~/.kiro/settings/mcp.json، ويتقدّم ملف ‎.kiro/settings/mcp.json الخاص بالمشروع على ملف المستخدم.

وثائق MCP لـ Kiro CLI (Amazon Q Developer CLI) →

الصق في Settings | Tools | AI Assistant | Model Context Protocol (MCP) → Add، كإعداد JSON:

{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "@maguyva/mcp"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

استبدل mgv_xxxx بمفتاح API الخاص بك من app.maguyva.ai.

يستخدم هذا الإعداد الجسر @maguyva/mcp (يتطلب Node.js / npx). لم يُتحقق في هذا الدليل من إعداد اتصال بعيد باستخدام الدعم المدمج في هذا العميل؛ وهذا لا يعني أن العميل يفتقر إلى دعم مدمج للاتصال البعيد. يعمل Maguyva بالكامل عن بُعد — وحده الجسر يعمل محليًا.

وثائق MCP لـ PyCharm →

macOS: ~/.config/zed/settings.json
Windows: %AppData%\Zed\settings.json
Linux: ~/.config/zed/settings.json

أضِف إلى إعدادات Zed الخاصة بك (~/.config/zed/settings.json):

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

استبدل mgv_xxxx بمفتاح API الخاص بك من app.maguyva.ai.

ما يضيفه Maguyva إلى Zed →

وثائق MCP لـ Zed →

فعّل Enable Project MCP في Settings → MCP، ثم أضف إلى ‎.trae/mcp.json في جذر مشروعك:

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

استبدل mgv_xxxx بمفتاح API الخاص بك من app.maguyva.ai.

وثائق MCP لـ Trae →

أضِف إلى opencode.json في جذر مشروعك:

{
  "mcp": {
    "maguyva": {
      "type": "remote",
      "url": "https://maguyva.tools/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:MAGUYVA_API_KEY}"
      }
    }
  }
}

يقرأ هذا الإعداد مفتاحك من متغير البيئة MAGUYVA_API_KEY. اضبطه على مفتاح API الخاص بك من app.maguyva.ai في البيئة التي يبدأ منها عميلك.

ما يضيفه Maguyva إلى OpenCode →

وثائق MCP لـ OpenCode →

macOS: ~/.boltai/mcp.json

أضِف إلى إعداد MCP الخاص بـBoltAI:

{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "@maguyva/mcp"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

استبدل mgv_xxxx بمفتاح API الخاص بك من app.maguyva.ai.

يستخدم هذا الإعداد الجسر @maguyva/mcp (يتطلب Node.js / npx). لم يُتحقق في هذا الدليل من إعداد اتصال بعيد باستخدام الدعم المدمج في هذا العميل؛ وهذا لا يعني أن العميل يفتقر إلى دعم مدمج للاتصال البعيد. يعمل Maguyva بالكامل عن بُعد — وحده الجسر يعمل محليًا.

وثائق MCP لـ BoltAI →

أضف إلى librechat.yaml واضبط MAGUYVA_API_KEY في بيئة خادم LibreChat:

mcpServers:
  maguyva:
    type: streamable-http
    url: https://maguyva.tools/mcp
    headers:
      Authorization: Bearer ${MAGUYVA_API_KEY}
    requiresOAuth: false

يقرأ هذا الإعداد مفتاحك من متغير البيئة MAGUYVA_API_KEY. اضبطه على مفتاح API الخاص بك من app.maguyva.ai في البيئة التي يبدأ منها عميلك.

وثائق MCP لـ LibreChat →

macOS: ~/.gemini/config/mcp_config.json
Windows: %UserProfile%\.gemini\config\mcp_config.json
Linux: ~/.gemini/config/mcp_config.json

أضِف إلى إعداد MCP الخاص بـAntigravity:

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

استبدل mgv_xxxx بمفتاح API الخاص بك من app.maguyva.ai.

ما يضيفه Maguyva إلى Antigravity →

وثائق MCP لـ Antigravity →

لا يحمّل Claude Cowork الخوادم من claude_desktop_config.json؛ بل يصل إلى الخوادم البعيدة كموصّلات مخصصة. في Customize → Connectors، أضف موصّلًا مخصصًا بالرابط https://maguyva.tools/mcp، واختر No sign-in، وأضف ترويسة طلب authorization قيمتها Bearer متبوعة بمفتاح API الخاص بك. ترويسات الطلب في مرحلة تجريبية لعدد محدود من المؤسسات؛ إن لم يكن في النافذة قسم Request headers، فلا يستطيع Cowork المصادقة مع Maguyva بعد. اطّلع على الوثائق →

يدعم ChatGPT خوادم MCP البعيدة في خطط Business وEnterprise وEdu عبر Settings → Apps → Create. يلزم توفر نقطة نهاية HTTPS بعيدة — لا يدعم ChatGPT الخوادم المحلية عبر stdio. راجع دليل MCP الخاص بـOpenAI للإعداد. اطّلع على الوثائق →

أضف إلى ‎~/.warp/.mcp.json (أو ‎.warp/.mcp.json في مشروع)، أو الصقه في Settings → Agents → MCP servers → + Add:

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

استبدل mgv_xxxx بمفتاح API الخاص بك من app.maguyva.ai.

ما يضيفه Maguyva إلى Warp →

وثائق MCP لـ Warp →