Windsurf

قم بتوصيل API AstroWay إلى Windsurf عبر MCP. الخادم يستخدم المساعد Cascade.

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

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

الاتصال

قم بتحرير ~/.codeium/windsurf/mcp_config.json; وهو متاح أيضًا عبر Settings → Cascade → MCP. انتبه: للخادم البعيد يستخدم Windsurf المفتاح serverUrl (ليس url). الصق أحد الكتل أدناه وأعد تشغيل Windsurf.

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

~/.codeium/windsurf/mcp_config.json

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

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

~/.codeium/windsurf/mcp_config.json

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

التحقق

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

استكشاف الأخطاء وإصلاحها

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

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