من الصفر إلى جاهز لاستدعاء الوكلاء

التسجيل الذاتي — التدفق المستضاف

أسرع طريق لا يحتاج سطر أوامر ولا مواصفة OpenAPI: سجّل برابط موقعك واستلم ملف Agentify (سطر JSON واحد تضعه على موقعك مرة واحدة إلى الأبد). الباقة المجانية تعطيك تقرير الجاهزية فورًا دون أي ملف؛ والنشر الفعلي يتبع هذا التسلسل — الدفع يأتي بعد التحقق، لا قبله:

وبعد الإطلاق تبقى مُدارًا: إعادة تحليل عند الطلب ضمن حصة باقتك عندما يتغير موقعك، وتحديث محتوى يومي مجاني (البحث لا يخدم بيانات قديمة أبدًا)، ونبضة تحقق يومية من ملفك، واكتشاف تلقائي للأدوات المعطوبة من حركة الوكلاء الفعلية — وكلها تُدار من لوحة التحكم.

تشاهد كل مرحلة مباشرةً على صفحة حالتك (يصلك الرابط مع مفتاح الوصول عند التسجيل)، وتراجع هناك المرشحات المستخرجة من النماذج، وتجمع مخرجاتك: نقطة اتصال MCP، ورمز التسجيل، وملفات الاكتشاف، وتقرير جاهزية مع سجل تدقيق كامل.

البداية السريعة — تشغيل العرض الكامل

يوفر المستودع حلقة عمل كاملة: متجر تجريبي، وطبقة مصادقة، وبوابة MCP، ووكيل مبرمج يختبر كل ذلك. يتطلب Node إصدار 18 فأعلى، ولا شيء آخر.

# clone, then from the repo root:
node scripts/e2e.js

# boots demo-site (:4100), auth (:4200), gateway (:4300),
# registers an agent, gets a token, and runs 14 end-to-end checks.
# Expected final line:
🎉 E2E PASSED

حوّل واجهتك البرمجية إلى أدوات وكيل

إذا كانت لديك مواصفة OpenAPI 3.x، فإن أداة التحويل تجمعها في ملف مانيفست وظيفي — وهو التمثيل الوسيط الموحّد الذي تخدمه البوابة.

node packages/transformer/src/cli.js your-openapi.json \
  --tenant your-business \
  --base-url https://api.your-site.com \
  --secret-ref YOUR_API_KEY_ENV \
  --out packages/gateway/tenants/your-business.manifest.json

قواعد التحويل: operationId ← اسم الأداة · GET ← صلاحية read، وعمليات التعديل ← صلاحية write · المعاملات وأجسام الطلبات ← مخطط inputSchema من نوع JSON-Schema مسطّح · x-requires-approval: true ← تفعيل الموافقة البشرية. كما تولّد أداة التحويل ملفات اكتشاف llms.txt وmcp.json لوضعها على موقعك.

المصادقة

لا تثق البوابة بأي طلب دون رمز Bearer، وتتحقق من كل رمز عبر طبقة المصادقة باستخدام فحص RFC 7662. تبدأ الوكلاء التدفق بالكامل تلقائيًا:

ربط وكيل

يتصل أي عميل يدعم MCP (Claude، ChatGPT، Copilot، Cursor) برابط:

{
  "mcpServers": {
    "your-business": {
      "url": "https://your-gateway/mcp/your-business",
      "transport": "http"
    }
  }
}

تطبّق البوابة النسخة عديمة الحالة من JSON-RPC عبر Streamable-HTTP — initialize، وtools/list، وtools/call، وping. البث عبر SSE واستئناف الجلسات على خارطة الطريق.

مرجع ملف المانيفست

{
  "manifestVersion": "1.0",
  "tenant": "your-business",
  "origin": {
    "baseUrl": "https://api.your-site.com",
    "allowedHosts": ["api.your-site.com"]   // SSRF allowlist
  },
  "auth": {
    "type": "apiKey",
    "header": "X-API-Key",
    "secretRef": "YOUR_API_KEY_ENV"       // injected server-side, never exposed
  },
  "tools": [{
    "name": "create_order",
    "description": "Create an order. Returns order id and total.",
    "scope": "write",
    "requiresApproval": true,
    "inputSchema": { /* JSON Schema */ },
    "request": { "method": "POST", "path": "/api/orders" }
  }]
}

تصنيف الأخطاء

تُعيَّن أخطاء التنفيذ إلى مفردات ثابتة حتى تستطيع الوكلاء (ولوحات التحكم لديك) الاستجابة برمجيًا: