Cline

اربط AstroWay API بـ Cline عبر MCP. بالنسبة إلى Cline، فإن stdio هو وسيلة النقل الأكثر موثوقية.

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

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

الربط

افتح Cline → MCP Servers → Configure لتعديل cline_mcp_settings.json. الصق إحدى الكتل أدناه ثم أعد تشغيل Cline.

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

cline_mcp_settings.json

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

Hosted (HTTP): إذا كان إصدار Cline لديك يدعم الخوادم البعيدة:

cline_mcp_settings.json

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

التحقق

اكتب لـ Cline في الدردشة: “اعرض أدوات Astroway”، أو اطلب منه استدعاء أداة مرجعية مجانية، مثل الحصول على قائمة الأبراج. إذا وصلت نتيجة، فالاتصال يعمل.

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

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

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