VS Code

اتصل بـ API AstroWay بـ VS Code عبر MCP. يقرأ التكوين Copilot Chat في وضع Agent.

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

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

الاتصال

أنشئ .vscode/mcp.json في جذر المشروع. لاحظ: في VS Code المفتاح هو servers (ليس mcpServers)، وكل خادم يحتاج إلى حقل type. أدخل أحد الكتل أدناه وأعد تشغيل VS Code بالكامل.

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

.vscode/mcp.json

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

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

.vscode/mcp.json

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

التحقق

في Copilot Chat (وضع Agent)، اكتب: “List Astroway tools” - أو اطلب استدعاء أداة مرجعية مجانية، على سبيل المثال الحصول على قائمة برج الدلو. إذا حصلت على نتيجة كرد، فالاتصال يعمل.

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

• 401 / مفتاح غير صالح: تأكد من أن المفتاح يحتوي على البادئة aw_live_* أو aw_test_* ولم يتم إلغاؤه. يمكنك التحقق في اللوحة.

• لا تظهر الأدوات: أعد تشغيل VS Code بالكامل وتحقق من مسار .vscode/mcp.json (المفتاح servers، الحقل type).

• أخطاء التحقق -32602 (لـ stdio): قم بتحديث الحزمة: npm i @astroway/mcp@latest. يتم إعادة إنشاء المخططات من المواصفات الحالية.

جميع العملاء - إعداد Agent.