حل مشكلات اتصال وكلاء الذكاء الاصطناعي

الوكيل لا يستطيع تسجيل الدخول

إذا عرض تطبيق الذكاء الاصطناعي خطأ في تسجيل الدخول، أو ظل يطلب منك الاتصال:

1. ابدأ الاتصال من جديد من تطبيق الذكاء الاصطناعي. في Claude Code، اكتب /mcp، واختر اتصال Metaintro، وسجّل الدخول مجددًا.

2. تأكد من تسجيل الدخول إلى حساب Metaintro الذي تريد أن يستخدمه الوكيل.

3. في صفحة Metaintro التي تُفتح، اختر سماح. إذا رأيت "انتهت صلاحية هذا الرابط"، فعُد إلى تطبيق الذكاء الاصطناعي وابدأ من جديد.

4. تحقّق من العنوان الذي أضفته. يجب أن يكون https://www.metaintro.com/api/mcp بالضبط، أو https://www.metaintro.com/api/mcp/org/<org-slug> لمؤسسة. يعرض قسم ابدأ الآن في إعدادات > الوكلاء، أو في علامة التبويب وكلاء الذكاء الاصطناعي الخاصون بي في إعدادات مؤسستك، العنوان الصحيح مع زر لنسخه.

إذا اتصلت بمفتاح شخصي، فقد يرى الوكيل: "Sign in through your AI client, or send a Metaintro personal API key…". يعني ذلك أن المفتاح مفقود أو مكتوب خطأً أو منتهي الصلاحية أو مفصول. تبقى المفاتيح صالحة 90 يومًا. في إعدادات > الوكلاء، افتح علامة التبويب تطبيقات أخرى ضمن ابدأ الآن، واختر إنشاء مفتاح API، ثم حدّث إعداد تطبيقك.

في Codex، شغّل codex mcp login metaintro. وفي Pi، شغّل pi mcp login metaintro. للمؤسسة، استخدم اسم اتصالها، مثل metaintro-<org-slug>. مع إضافة pi-mcp-adapter، سجّل الدخول بدلًا من ذلك داخل Pi باستخدام /mcp-auth metaintro. لمعرفة ما إذا كان التطبيق متصلًا، شغّل codex mcp list أو pi mcp list.

الوكيل يقرأ لكنه لا يستطيع إجراء تغييرات

إذا أبلغ الوكيل عن insufficient scope، أو قال إنه لا يستطيع إجراء تغييرات، فهو متصل بصلاحية قراءة فقط: تعرض قائمة الوكلاء الذين ربطتهم عبارة قراءة فقط بجانبه. افصله وأعد ربطه. مع مفتاح API، اختر القراءة والتنفيذ ضمن ما يُسمح له بفعله. وعند تسجيل الدخول عبر تطبيقك، تحقّق من أن صفحة Metaintro تذكر إجراء تغييرات نيابةً عنك قبل أن تختار سماح.

إذا كانت الرسالة "This credential cannot use the MCP server"، فقد أُنشئ المفتاح دون صلاحية الوكيل. اختر إنشاء مفتاح API في علامة التبويب تطبيقات أخرى في إعدادات > الوكلاء، أو سجّل الدخول مجددًا عبر تطبيق الذكاء الاصطناعي واسمح بالوصول.

"Organization keys name no person to act as"

لا يمكن استخدام مفاتيح API الخاصة بالمؤسسات (mi_org_…) مع وكلاء الذكاء الاصطناعي. يعمل الوكيل دائمًا باسم شخص واحد، حتى يُسجَّل كل تغيير باسم أحد ما. استخدم مفتاحًا شخصيًا من إعدادات > الوكلاء، أو سجّل الدخول عبر تطبيق الذكاء الاصطناعي.

"You aren't on this organization's staff"

اتصال المؤسسة (/api/mcp/org/<org-slug>) يعمل فقط للأشخاص الذين لديهم دور ضمن طاقم تلك المؤسسة. إذا رأيت هذه الرسالة:

• تحقّق من اسم المؤسسة في العنوان.

• اسأل أحد مسؤولي المؤسسة عمّا إذا كان لديك دور ضمن الطاقم. لا تظهر علامة التبويب وكلاء الذكاء الاصطناعي الخاصون بي في إعدادات المؤسسة إلا للطاقم.

• لبحثك الشخصي عن عمل، استخدم العنوان الشخصي https://www.metaintro.com/api/mcp.

"This connection only reaches…"

يعمل اتصال كل مؤسسة داخل تلك المؤسسة فقط. إذا حاول الوكيل العمل مع مؤسسة مختلفة، يُرفض طلبه. أضف اتصالًا منفصلًا من علامة التبويب وكلاء الذكاء الاصطناعي الخاصون بي في إعدادات المؤسسة الأخرى.

الوكيل لا يجد أدوات مدير الحالات

الاتصال الشخصي يصل إلى بحثك عن عمل فقط. للعمل مع أعضاء مؤسسة، اتصل بعنوان تلك المؤسسة. راجع استخدام وكلاء الذكاء الاصطناعي بصفتك مدير حالات.

"Too many calls from this key. Try again in N seconds."

للحفاظ على سرعة Metaintro للجميع، لكل اتصال حدود في الدقيقة للقراءة والتغييرات وطلبات Cabinet ومحادثات المساعد. انتظر عدد الثواني المعروض، ثم حاول مجددًا. إذا تكرر ذلك، فاطلب من وكيلك تقديم طلبات أقل عددًا وأكبر حجمًا.

عادةً ما تزول رسالة "Too many requests" أو "Metaintro is temporarily unavailable" خلال دقيقة.

إجراء ينتظر الموافقة

إذا قال الوكيل إن إجراءً ينتظر الموافقة، فهو ليس عالقًا. وافق عليه أو ارفضه ضمن بانتظار موافقتك في إعدادات > الوكلاء، أو في علامة التبويب وكلاء الذكاء الاصطناعي الخاصون بي في إعدادات مؤسستك إذا جاء عبر اتصال تلك المؤسسة. تنتهي صلاحية الطلبات بعد 7 أيام. راجع الموافقة على ما يفعله وكيل الذكاء الاصطناعي.

فشل إجراء بعد موافقتك عليه

إذا رأيت "تمت الموافقة، لكن الإجراء فشل"، فاطلب من وكيلك التحقق من الطلب. يمكنه قراءة السبب باستخدام أداة حالة الطلب (get_action_request). من الأسباب الشائعة:

• تغيّر السجل في هذه الأثناء. اطلب من الوكيل قراءته مجددًا وإعادة المحاولة.

• فُصل الوكيل قبل موافقتك، فلم يُنفَّذ شيء.

• لم تعد لديك صلاحية الوصول إلى ما يحتاجه الإجراء.

الوكيل يقول إن سجلًا قد تغيّر

تتحقق بعض التغييرات من أن لدى الوكيل أحدث نسخة من السجل. إذا عدّله شخص آخر أولًا، يُرفض التغيير حتى لا يُكتب فوق أي شيء. اطلب من الوكيل قراءة السجل مجددًا وإعادة المحاولة.

فصل وكيل أو إعادة ربطه

1. انتقل إلى إعدادات > الوكلاء، أو علامة التبويب وكلاء الذكاء الاصطناعي الخاصون بي في إعدادات مؤسستك.

2. ابحث عن الوكيل ضمن الوكلاء الذين ربطتهم واختر زر الحذف (سلة المهملات) الخاص به.

3. أكّد باختيار فصل.

يتوقف عن العمل فورًا، في كل مكان. لاستخدامه مجددًا، اربطه من جديد من تطبيق الذكاء الاصطناعي.

لوكلاء الذكاء الاصطناعي: تحقّق من الاتصال

اتبع هذه الخطوات بالترتيب:

1. استدعِ whoami. إذا نجح، فالاتصال سليم. لاحظ نوع الاتصال وإعداد الموافقة.

2. إذا ظهر خطأ في تسجيل الدخول، فاطلب من الشخص تسجيل الدخول مجددًا (/mcp في Claude Code، وcodex mcp login metaintro في Codex، وpi mcp login metaintro في Pi (أو /mcp-auth metaintro داخل Pi مع إضافة pi-mcp-adapter)). وتأكد من أن العنوان هو https://www.metaintro.com/api/mcp تمامًا.

3. إذا رُفض تغيير بسبب insufficient scope، فالاتصال قراءة فقط. أخبر الشخص ولا تُعِد المحاولة.

4. إذا طُلب منك المحاولة مجددًا بعد عدد من الثواني، فانتظر تلك المدة قبل الاستدعاء التالي.

5. إذا رُفض تغيير لأن السجل تغيّر، فاقرأه مجددًا وأعد المحاولة بالإصدار الجديد.

هل ما زلت تواجه مشكلة؟

تواصل معنا وأرفق رسالة الخطأ. إن تضمنت معرّف طلب (request ID)، فأرفقه أيضًا؛ فهو يساعدنا على معرفة ما حدث.