اربط موقعك مع أي AI Agent

OrderGer بدعم 3 طرق ربط، عشان يشتغل مع كل أداة AI موجودة — قديمة، حديثة، MCP، OpenAPI، أو حتى manual.

اختر حسب الأداة

الأداة	الطريقة الموصى بها
Claude Desktop	🤖 MCP
Claude Code (CLI)	🤖 MCP
Cursor	🤖 MCP
Windsurf	🤖 MCP
Continue.dev	🤖 MCP
VS Code (Cline / Roo / GitHub Copilot Agent)	🤖 MCP
Lovable	🪄 Magic URL
Bolt.new	🪄 Magic URL
v0 (Vercel)	🪄 Magic URL
Replit Agent	🪄 Magic URL
Z.ai / GLM Coder	🪄 Magic URL أو OpenAPI
Manus	🪄 Magic URL أو OpenAPI
ChatGPT / GPTs	🪄 Magic URL أو OpenAPI Action
أي AI آخر	📋 Prompt أو OpenAPI

🤖 الطريقة 1: MCP Server

لو الأداة بتدعم Model Context Protocol، هاي أنظف وأسرع طريقة. الـ AI بستدعي 8 tools مباشرة:

• orderger_status · فحص الحساب
• orderger_generate_api_key · توليد مفتاح
• orderger_configure_webhook · ضبط webhook
• orderger_send_test_order · اختبار
• orderger_get_integration_snippet · توليد كود لمكدّسك
• orderger_get_woocommerce_plugin · WordPress
• orderger_tail_recent_logs · سجلات للتشخيص
• orderger_list_branches · قائمة الفروع

→ تعليمات MCP الكاملة

🪄 الطريقة 2: Magic Install URL

للأدوات اللي ما تدعم MCP. روح ع /connect، سجّل دخول، اختر مكدّسك، اضغط "ولّد رابط سحري". رح يعطيك URL لمرّة واحدة (صالح ساعة):

https://orderger-api.hamidalqwaysim.workers.dev/install/<TOKEN>?stack=<STACK>

الصق هاد الرابط في الـ AI agent (Lovable, Bolt, Replit, ChatGPT...). الـ AI بيـ fetch الرابط وبيستلم JSON كامل:

{
  "api_base": "https://orderger-api.hamidalqwaysim.workers.dev",
  "business": { "id": "biz_xxx", "name": "..." },
  "branches": [...],
  "api_key": "og_live_xxx",          // مفتاح حقيقي
  "branch_id": "branch_xxx",
  "webhook_secret": "...",            // سر عشوائي
  "snippet": "...",                   // كود تكامل لمكدّسك
  "instructions": [ "1. Save the api_key...", "2. ...", ... ],
  "docs": { "openapi": "...", "mcp_install": "..." }
}

الـ AI لازم يستخدم هاي البيانات لربط الموقع. اعمل الرسالة كاملة عبر زر "نسخ الرسالة للـ AI" في /connect.

📋 الطريقة 3: Prompt + OpenAPI + Manual

لو الأداة ما بتقبل MCP ولا fetch لـ URLs:

1. انسخ البرومت الجاهز من /docs/ai-prompt (بيحوي 3 طرق + شرح كامل)
2. أو خلّي الـ AI يقرأ OpenAPI spec: /openapi.json
3. أو سوّي ربط manual: ولّد مفتاح من Dashboard، الصقه في موقعك، اضبط webhook

اللي بصير بعد ما الـ AI يربط الموقع

1. الـ AI كاتب الكود وحاطّ المفتاح في .env
2. الموقع لما يستلم طلب جديد، بيبعتلك إياه على OrderGer
3. تطبيق OrderGer ع موبايلك بيرن بإنذار قوي
4. تقبل/ترفض من الموبايل → بيرجع webhook لموقعك
5. عند "تم التوصيل" بيخصم 0.05$ من رصيدك (5$ ترحيبي = 100 طلب)