Claude Desktop

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

المتطلبات الأساسية

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

الإضافة بنقرة واحدة

1. قم بتنزيل astroway.mcpb.
2. افتح الملف. سيظهر Claude Desktop مربع حوار للتثبيت.
3. أدخل مفتاح API، اختر مجموعات الأدوات (الافتراضي هو المخطوطات الميلادية، والممرات، والتقدمات، والعودة، والمقارنة، والتقويم) وفعّل الإضافة.

لا حاجة لتعديل التكوين. الإضافة هي حزمة npm @astroway/mcp مع تبعياتها، مبنية من نفس الإصدار. امسح حقل المجموعات لتحميل جميع 700+ أداة.

الاتصال يدوياً

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

المستضاف (HTTP): بدون حزمتنا، والتحكم عبر رمز حامل (Bearer token). تكوين Claude Desktop يعمل فقط الأوامر المحلية ويهمل السجل مع url نفسه، لذلك يتم الاتصال بخادم المستضاف عبر جسر 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): عملية فرعية محلية، والتحكم عبر متغير البيئة، يعمل دون اتصال بالإنترنت:

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_* ولم يتم إلغاؤه. يمكنك التحقق في لوحة التحكم.
• “تعذر تحميل بعض خوادم MCP”: في السجل url بدلاً من command. استخدم الكتلة مع mcp-remote أعلاه.
• لا تظهر الأدوات: أعد تشغيل Claude Desktop بالكامل (اخرج فقط ولا تغلق النافذة) و تحقق من مسار claude_desktop_config.json.
• أخطاء التحقق -32602 (لـ stdio): قم بتحديث الحزمة: npm i @astroway/mcp@latest. يتم إعادة إنشاء المخططات من المواصفات الحالية.

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