# الوكلاء وواجهة API الوكيل مساعد ذكاء اصطناعي ينجز العمل في LetsFindWhy نيابةً عنك: Claude Code، أو روتين Claude مجدول، أو مساعد محرر، أو أي أداة أخرى تتحدث بروتوكول سياق النموذج (MCP). امنحه مفتاح API ليتمكن من إعداد المشاريع وكتابة أدلة النقاش ودعوة المستجيبين وقراءة النصوص المفرّغة والرؤى من الدردشة، بالصلاحيات التي تملكها أنت تماماً. كل ما يستطيع الوكيل فعله يمكنك فعله بنفسك أيضاً عبر استدعاءات HTTP عادية إلى واجهة REST API. وكلاهما يستخدم المفتاح نفسه. ## كيفية إنشاء مفتاح API 1. افتح [الإعدادات](https://letsfindwhy.com/settings) وابحث عن بطاقة **مفاتيح API**. 2. أنشئ مفتاحاً وامنحه اسماً يوضح أي وكيل سيحمله، مثل «Claude Code على حاسوبي المحمول». فمفتاح لكل وكيل يسهّل إلغاء أحدها دون المساس بالبقية. 3. انسخ المفتاح فوراً. يبدأ بـ mtg_ ويُعرض مرة واحدة فقط؛ وإذا فقدته فاحذفه وأنشئ مفتاحاً آخر. المفتاح ملكك أنت، لا ملك مؤسسة. والوكيل الذي يحمله يرى كل مؤسسة تنتمي إليها، بالدور الذي تشغله فيها، ويُسجَّل كل ما يفعله على أنه من فعلك. تعامل مع المفتاح كأنه كلمة مرور وألغِه فور توقفك عن استخدام الوكيل. الربط الذي يتم بتسجيل الدخول له المدى نفسه الذي للمفتاح، ومثل المفتاح يبقى قائماً بعد تسجيل الخروج وتغيير كلمة المرور. أما فصله فخطوة مستقلة موصوفة أدناه. ## كيفية ربط claude.ai يتصل claude.ai عبر عنوان URL وتسجيل دخول، دون أي مفتاح تلصقه. والربط الذي يتم في claude.ai يشمل أيضاً Claude Desktop وتطبيقات Claude للهواتف. 1. في claude.ai، افتح **الإعدادات**، ثم **الموصّلات**، واختر **إضافة موصّل مخصص**. 2. أدخل `https://letsfindwhy.com/api/mcp` كعنوان URL، تماماً كما هو مكتوب ودون شرطة مائلة في نهايته، واترك معرّف العميل والسر فارغين. 3. اختر **الاتصال**. تطلب منك LetsFindWhy تسجيل الدخول إن لم تكن قد سجّلته بعد، ثم تعرض ما يمكن للربط فعله؛ اختر **السماح**. لإنهاء ربط، افتح [الإعدادات](https://letsfindwhy.com/settings) في LetsFindWhy واختر **فصل** في بطاقة **الوكلاء المتصلون**. هذه هي الطريقة الوحيدة لإلغائه: إزالة الموصّل في Claude تمنع Claude من استخدامه، لكن الموصّل الذي يُضاف مجدداً لاحقاً يسجّل الدخول مباشرة من جديد. أزله من المكانين كي يتوقف Claude عن مطالبتك بتسجيل الدخول مرة أخرى. ## كيفية ربط Claude Code يمكن لـ Claude Code تسجيل الدخول بالطريقة نفسها. شغّل هذا مرة واحدة، ثم اكتب `/mcp` في Claude Code واختر **Authenticate**؛ تُفتح نافذة متصفح لتسجيل الدخول. وهذا ربط مستقل عن الربط الذي يحمله claude.ai، ويظهر منفصلاً في الإعدادات. ``` claude mcp add --transport http letsfindwhy https://letsfindwhy.com/api/mcp ``` للنصوص البرمجية أو الاستخدام دون واجهة أو أي عميل يتيح لك ضبط ترويسة الطلب، الصق مفتاحاً بدلاً من ذلك: ``` claude mcp add --transport http letsfindwhy https://letsfindwhy.com/api/mcp --header "Authorization: Bearer mtg_..." ``` يعرض Claude Code بعدها أداةً لكل ما يمكنك فعله في LetsFindWhy، مسمّاة بما تفعله: create_project وcreate_discussion_guide_with_questions وinvite_recruited_respondents_to_session وget_session_transcript وغيرها. اطلب ما تريد بكلمات عادية وسيختار الأدوات. يعمل Cursor والنصوص البرمجية وسائر العملاء التي تتيح ضبط ترويسة الطلب بالطريقة نفسها. أما أدلة الموصّلات في claude.ai وClaude Desktop فلا تستطيع إرسال ترويسة؛ بل تتصل عبر عنوان URL وتسجيل دخول كما هو موصوف أعلاه. ## ما يستطيع الوكيل فعله وما لا يستطيعه يعمل الوكيل بصفتك. فهو يُعدّ البحث ويقرؤه؛ ولا يدير المقابلات ولا يدير فريقك. **يستطيع:** - إنشاء المؤسسات والمشاريع والعمليات وأدلة النقاش واستبيانات الفرز وتحديثها. - إدارة الاستقطاب: فتح روابط التسجيل وإغلاقها، وإضافة المستجيبين يدوياً، ودعوتهم إلى الجلسات. - إعداد الجلسات مسبقاً: إنشاؤها، وتغيير إعداداتها، وتعيين دليل، وتعديل أسئلته. - قراءة النتائج: التسجيلات، والنصوص المفرّغة، والإجابات، ورؤى الذكاء الاصطناعي، والاستخدام. **لا يستطيع:** - التدخل في مقابلة جارية. فالبدء والإنهاء وقبول الأشخاص وإزالتهم واستدعاء المُدير الذكي أو صرفه تبقى بيد من في الغرفة. - تغيير أعضاء مؤسستك: لا يستطيع تغيير الأدوار، ولا إزالة الأعضاء، ولا نقل الملكية، ولا المغادرة، ولا حذف المؤسسة. - حذف التسجيلات. فحذف التسجيل يحذف نصه المفرّغ أيضاً، لذا يبقى ذلك قراراً تتخذه في التطبيق. وُضع الحد حيث هو لأن الوكيل يقرأ ما قاله المستجيبون، وقد يقول مستجيب شيئاً مصمَّماً لتوجيهه. ومهما قرأ، فلا يستطيع إقصاءك من مؤسستك ولا محو بحثك. حذف مشروع أو جلسة أو عملية أو دليل أو استبيان فرز مسموح به. ويمكن استعادة المشاريع والجلسات خلال 30 يوماً، وسيطلب منك وكيلك التأكيد قبل أي حذف. ## كيفية استدعاء واجهة REST API مباشرةً كل أداة في الأساس نقطة نهاية REST. أرسل مفتاحك بصيغة `Authorization: Bearer mtg_...` وتصفّح المرجع الكامل، بكل نقطة نهاية ومعاملاتها، على [/api/docs](https://letsfindwhy.com/api/docs) بعد تسجيل الدخول. المفاتيح محدودة بدفعات قصيرة: 60 استدعاءً في الثانية الواحدة عبر واجهة REST API، ونحو 30 عبر MCP، حيث يتحقق كل استدعاء أداة من المفتاح مرتين. ولا يبلغ أي وكيل يفكّر أياً من الحدين. والاستدعاء الذي يتجاوزهما يتلقى استجابة 429 توضح مدة الانتظار.