واجهة البرمجة العامة

ربط مساعد ذكاء اصطناعي (MCP)

أنشئ مفتاح واجهة بالنطاقات التي يحتاجها المساعد فقط، ثم أعطِ العميل العنوان https://api.mosaqo.app/v1/mcp مع هذا المفتاح كرمز bearer. يفعل المساعد تمامًا ما يسمح به المفتاح ولا شيء غيره، ويمكنك فصله في أي وقت من Bulk & API.

روجعت في 20 أغسطس 2026

الخطوات

1. افتح Bulk & API → API keys وأنشئ مفتاحًا. امنح أولًا نطاقات القراءة فقط؛ وستُصدر مفتاحًا ثانيًا بالكتابة حين ترى ما يفعله المساعد.
2. انسخ العنوان من لوحة AI assistants (MCP) في الشاشة نفسها.
3. في المساعد، أضف خادمًا بهذا العنوان وأرسل المفتاح في ترويسة Authorization: Bearer. معظم العملاء يقبلون كتلة JSON فيها url وheaders.
4. بعض الموصّلات تطلب تسجيل الدخول إلى Mosaqo بدل لصق مفتاح. هذا المسار يُظهر من يطلب، وأي مساحة عمل سيطالها، وماذا سيستطيع — قبل منح أي شيء. ولا يوافق إلا مالك أو مسؤول.
5. اسأل المساعد عما يستطيع. سيعدّد الأدوات التي يسمح بها مفتاحك، وهو أسرع تأكيد بأن الاتصال ضيّق كما أردت.

كيف تتحقق من النتيجة

اسأل عن شيء لا تعرفه إلا مساحة العمل هذه: كم رمزًا لديك، أو كيف يسير استبيان. إجابة بأسمائك وأرقامك الحقيقية تعني أن الاتصال يعمل؛ ورفض يذكر اسم نطاق يعني أن المفتاح أضيق من السؤال.

ما الذي يخطئ عادةً

• منح الكتابة لأول مفتاح. ابدأ بالقراءة فقط ووسّع حين تعرف ما يُفعل به.
• توقّع أن يقرأ ما كتبه الناس في استبيان. تلك الإجابات لا تُسلَّم لمفتاح ولا لمساعد — الدرجات والأعداد نعم، أما الجمل فتبقى في صندوق الوارد.
• توقّع أن يحذف رمزًا. لا يستطيع: إتلاف إعادة التوجيه خلف رمز مطبوع لا يُعكَس، لذلك تُعرَض عليه الأرشفة، وهي قابلة للعكس.
• نسيان اتصال. المساعد الموصول عبر تسجيل الدخول يحتفظ بالوصول حتى يُفصَل من Bulk & API، تمامًا كما يبقى المفتاح صالحًا حتى يُلغى.