🤖 OrderGer MCP Server

خلّي الذكاء الاصطناعي يربط موقع مطعمك بـ OrderGer من خلال محادثة عادية — بدون نسخ ولصق.

للأدوات يلي بتدعم MCP فقط: Claude Desktop، Claude Code، Cursor، Windsurf، Continue، VS Code MCP extensions.
لو بتستخدم Lovable / Bolt / Replit / Z.ai / Manus / ChatGPT، روح ع /connect لاستخدام الرابط السحري بدالها.

كيف يشتغل

OrderGer MCP server بيعمل local على جهازك بـ stdio وبخدم 8 tools للذكاء الاصطناعي:

Toolشو بيعمل
orderger_statusفحص الحساب + الفروع + الرصيد
orderger_list_branchesقائمة Branch IDs لازمة لهيدر X-OrderGer-Branch-ID
orderger_generate_api_keyتوليد مفتاح API (LIVE أو TEST/sandbox). يظهر مرة واحدة فقط
orderger_configure_webhookتسجيل webhook URL على موقع المستخدم + توليد signing secret
orderger_send_test_orderإرسال طلب تجريبي للتأكد من الاتصال (sandbox = صفر رسوم)
orderger_get_integration_snippetتوليد كود تكامل لـ 16 مكدّس (PHP, Laravel, Node, Next, Django, Go, .NET, ...)
orderger_get_woocommerce_pluginرابط تنزيل الـ plugin + خطوات التركيب
orderger_tail_recent_logsآخر سجلات API + webhook (للتشخيص)

التثبيت (بدون نشر على npm)

Claude Desktop

افتح ملف التهيئة:

macOS:   ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

والصق:

{
  "mcpServers": {
    "orderger": {
      "command": "npx",
      "args": ["-y", "https://orderger-api.hamidalqwaysim.workers.dev/static/orderger-mcp.tgz"],
      "env": {
        "ORDERGER_API_TOKEN": "<JWT من POST /auth/login>",
        "ORDERGER_API_BASE": "https://orderger-api.hamidalqwaysim.workers.dev"
      }
    }
  }
}

أعد تشغيل Claude Desktop. الأدوات الـ8 رح تظهر في القائمة.

Claude Code (CLI)

claude mcp add orderger -- npx -y https://orderger-api.hamidalqwaysim.workers.dev/static/orderger-mcp.tgz
claude mcp set-env orderger ORDERGER_API_TOKEN <YOUR_JWT>

Cursor

Settings → MCP → Add a Custom MCP Server — نفس الـ JSON أعلاه.

Windsurf

افتح ~/.codeium/windsurf/mcp_config.json والصق نفس الـ JSON.

Continue.dev

افتح ~/.continue/config.json والصق نفس الـ JSON تحت mcpServers.

كيف تحصل على JWT للـ ORDERGER_API_TOKEN

curl -X POST https://orderger-api.hamidalqwaysim.workers.dev/auth/login \
  -H "content-type: application/json" \
  -d '{"email":"YOU@example.com","password":"YOUR_PASSWORD"}'

الرد فيه token — هاد هو الـ JWT.

مثال محادثة

المستخدم: "اربط موقعي اللي بـ Laravel بـ OrderGer للفرع الرئيسي وابعت طلب تجريبي."

الـ AI (عبر MCP):
1. يستدعي orderger_status → يلاقي business + branch
2. يستدعي orderger_generate_api_key({ name: "Laravel site" }) → يحصل og_live_xxx…
3. يستدعي orderger_get_integration_snippet({ stack: "laravel" }) → يكتب app/Services/OrderGer.php
4. يستدعي orderger_configure_webhook({ url: "https://yoursite/orderger-webhook" }) → يحصل secret
5. يكتب route استقبال الـ webhook بـ Laravel مع تحقق التوقيع
6. يستدعي orderger_send_test_order(...) → يتأكد من وصول الإنذار
7. ينهي: "تم. ربطت موقعك، شغّلت طلب تجريبي، جاب الإنذار. كل شي شغّال."

أمان

جرّب MCP الآن OpenAPI Spec