البدء مع خادم MCP

oneguard-mcp خادم MCP يضع أداة OneGuard في سطر الأوامر أمام وكيل ذكاء اصطناعي. اطلب من وكيلك مزامنة أسرار مشروع، أو تدوير كلمة مرور قاعدة بيانات، أو التحقق من آخر من غيّر سرًا الأسبوع الماضي — دون لصق أي شيء حساس في محادثة.

يستدعي الخادم الملف الثنائي oneguard المثبَّت لديك أصلًا. لا خلفية جديدة، ولا تسجيل دخول إضافي: كل ما تقدر عليه الأداة، يعرضه هذا الخادم.

المتطلبات

• Node.js 18 أو أحدث
• أداة OneGuard بإصدار 1.2.0 أو أحدث — راجع تثبيت الأداة
• مفتاح API من OneGuard

لا توجد تبعيات npm لتثبيتها. بروتوكول MCP منفَّذ مباشرة، لذا يجلب npx حزمة صغيرة واحدة ويشغّلها.

اربطه

Claude Code

claude mcp add oneguard -s user \
  --env ONEGUARD_API_KEY=og_your_key \
  -- npx -y oneguard-mcp

Claude Desktop أو Cursor

في claude_desktop_config.json أو mcp.json:

{
  "mcpServers": {
    "oneguard": {
      "command": "npx",
      "args": ["-y", "oneguard-mcp"],
      "env": {
        "ONEGUARD_API_KEY": "og_your_key"
      }
    }
  }
}

ثم اسأل وكيلك "ما حالة اتصالي بـ OneGuard؟" — يجب أن يذكر معرّف مؤسستك وهل يستطيع المفتاح الكتابة.

الإعداد

| المتغيّر | الافتراضي | الغرض | | --- | --- | --- | | ONEGUARD_API_KEY | — | يهيّئ الجلسة عند أول استدعاء لأداة | | ONEGUARD_CLI_PATH | oneguard | المسار المطلق للملف الثنائي، حين لا يكون على PATH | | ONEGUARD_MCP_HOME | ~/.oneguard-mcp | مخزن بيانات اعتماد معزول لجلسة الوكيل | | ONEGUARD_MCP_READONLY | false | القيمة 1 تخفي كل أداة تغيّر أي شيء | | ONEGUARD_MCP_TIMEOUT_MS | 60000 | مهلة كل أمر |

محلي وبعيد

هذا خادم محلي: يتحدّث MCP عبر stdio ويعمل على جهازك، بجانب الأداة والملفات التي يكتبها. هذا ما يتيح له وضع ملف .env مفكوك التشفير على قرصك دون أن تعبر تلك القيم الشبكة مرة أخرى.

استخدام OneGuard من claude.ai على الويب، أو من ChatGPT، يحتاج خادم HTTP بعيدًا مع OAuth — عمل مختلف تمامًا، وليس ما تقدّمه هذه الحزمة.