Claude Desktop

اتصل بـ API AstroWay بـ Claude Desktop عبر MCP. كلا النقلين متاحان: المضيف (HTTP) والحزمة المحلية stdio.

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

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

الاتصال

افتح الإعدادات → المطور → تعديل التكوين - سيظهر لك Claude Desktop مسار ملف claude_desktop_config.json. الصق أحد الكتل أدناه وأعد تشغيل Claude Desktop.

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

claude_desktop_config.json

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

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

claude_desktop_config.json

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

التحقق

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

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

• 401 / مفتاح غير صالح: تأكد من أن المفتاح يحتوي على البادئة aw_live_* أو aw_test_* ولم يتم إلغاؤه. يمكنك التحقق في لوحة التحكم.
• لا تظهر الأدوات: أعد تشغيل Claude Desktop بالكامل (اخرج، فقط لا تغلق النافذة) وتحقق من مسار claude_desktop_config.json.
• أخطاء التحقق -32602 (لـ stdio): قم بتحديث الحزمة: npm i @astroway/mcp@latest. يتم إعادة إنشاء المخططات من المواصفات الحالية.

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