Codex CLI

اتصل بواجهة API AstroWay إلى Codex CLI عبر MCP. يستخدم Codex حزمة stdio محلية، مُعدّة في ملف TOML.

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

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

الاتصال

حرّر ~/.codex/config.toml. أضف الكتلة أدناه وأعد تشغيل Codex CLI. المصادقة عبر متغيّر بيئي، تعمل دون اتصال:

~/.codex/config.toml

[mcp_servers.astroway]
command = "npx"
args = ["-y", "@astroway/mcp"]
env = { ASTROWAY_API_KEY = "aw_live_YOUR_KEY" }

التحقق

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

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

• 401 / invalid key: تأكد أن المفتاح يبدأ بـ aw_live_* أو aw_test_* وغير مُسحب. يمكنك التحقق من ذلك في لوحة التحكم.
• الأدوات لا تظهر: أعد تشغيل Codex CLI بالكامل وتحقق من مسار ~/.codex/config.toml.
• أخطاء التحقق -32602: حدّث الحزمة: npm i @astroway/mcp@latest. تُعاد توليد المخططات من المواصفات الحالية.

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