Claude Desktop

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

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

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

الاتصال

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

Hosted (HTTP): بدون حزمنا، المصادقة عبر Bearer-token. تكوين Claude Desktop يشغّل فقط الأوامر المحلية ويتخطى السجل مع url نفسه، لذا يتم توصيل الخادم hosted عبر الجسر mcp-remote:

claude_desktop_config.json

{
"mcpServers": {
  "astroway": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "https://mcp.astroway.info/mcp", "--header", "Authorization:${AUTH_HEADER}"],
    "env": { "AUTH_HEADER": "Bearer aw_live_YOUR_KEY" }
  }
}
}

المفتاح يُوضع في env وليس في args، لأن Claude Desktop على Windows يقسم الوسيط عند الفراغ بعد Bearer. لتحميل موضوع واحد بدلاً من كامل الدليل، استبدل /mcp بخادم نطاق، مثل /mcp/core أو /mcp/vedic.

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

claude_desktop_config.json

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

التحقق

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

حل المشكلات

• 401 / invalid key: تأكد أن المفتاح يبدأ بـ aw_live_* أو aw_test_* ولم يتم سحبه. يمكنك التحقق في لوحة التحكم.
• “Some MCP servers couldn’t be loaded”: في السجل url بدلاً من command. استخدم الكتلة مع mcp-remote أعلاه.
• الأدوات لا تظهر: أعد تشغيل Claude Desktop بالكامل (اخرج، وليس مجرد إغلاق النافذة) وتحقق من مسار claude_desktop_config.json.
• أخطاء التحقق -32602 (لـ stdio): حدّث الحزمة: npm i @astroway/mcp@latest. يتم إعادة توليد المخططات من المواصفات الحالية.

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