Cursor

قم بتوصيل API AstroWay إلى Cursor عبر MCP. يتوفر كلا النقلين: hosted (HTTP) و حزمة stdio المحلية.

المتطلبات المسبقة

احصل على مفتاح API من لوحة التحكم. للاختبار المجاني استخدم مفتاح sandbox aw_test_* - فهو لا يخصم رصيد.

الاتصال

قم بتحرير ~/.cursor/mcp.json (أو ملف المشروع .cursor/mcp.json); متاح أيضًا عبر Settings → MCP. الصق أحد الكتل أدناه و أعد تشغيل Cursor.

Hosted (HTTP): بدون تثبيت، المصادقة عبر Bearer‑token:

~/.cursor/mcp.json

{
"mcpServers": {
  "astroway": {
    "url": "https://mcp.astroway.info/mcp",
    "headers": { "Authorization": "Bearer aw_live_YOUR_KEY" }
  }
}
}

Stdio (npx): عملية فرعية محلية، المصادقة عبر متغير بيئي، يعمل دون اتصال:

~/.cursor/mcp.json

{
"mcpServers": {
  "astroway": {
    "command": "npx",
    "args": ["-y", "@astroway/mcp"],
    "env": { "ASTROWAY_API_KEY": "aw_live_YOUR_KEY" }
  }
}
}

التحقق

اكتب للوكيل في الدردشة: «قائمة أدوات Astroway» - أو اطلب تشغيل أداة reference مجانية، مثل الحصول على قائمة علامات الأبراج. إذا تلقيت نتيجة في الرد، فإن الاتصال يعمل.

استكشاف الأخطاء

• 401 / invalid key: تأكد أن المفتاح يبدأ بـ aw_live_* أو aw_test_* وغير مُسحب. يمكنك التحقق من ذلك في لوحة التحكم.
• الأدوات لا تظهر: أعد تشغيل Cursor بالكامل وتحقق من مسار ~/.cursor/mcp.json (للمشروع - .cursor/mcp.json).
• أخطاء التحقق -32602 (لـ stdio): حدّث الحزمة: npm i @astroway/mcp@latest. يتم إعادة توليد المخططات من المواصفات الحالية.

جميع العملاء - إعدادات الوكيل.