حل المشكلات

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

تكرار تسجيل الدخول أو «لم تسجل الدخول»

الرسالة: “You are not signed in. Reconnect to sign in again.”

الرمز مفقود أو منتهي الصلاحية أو يخص خادما آخر. أصلحه حسب العميل:

العميل	ما تفعله
Claude Code	شغّل /mcp، واختر خادم GoBanana، ثم Clear authentication، وسجل الدخول من جديد (أو Re-authenticate). من سطر الأوامر: claude mcp logout <name> ثم claude mcp login <name>
Claude.ai وDesktop	Customize (التخصيص)، ثم Connectors، ثم GoBanana: افصله أو احذفه، ثم Connect من جديد
Cursor	Customize، وابحث عن gobanana، وأوقفه ثم شغّله، ثم سجل الدخول من جديد. السجلات: لوحة Output، ثم MCP Logs
VS Code	شغّل MCP: List Servers، واختر gobanana، ثم Disable ثم Enable، أو Show Output للسجلات
Codex	codex mcp logout gobanana، ثم codex mcp login gobanana
mcp-remote	احذف ~/.mcp-auth وأعد تشغيل العميل

المتصفح يعيدك إلى تسجيل الدخول مرة بعد مرة. السبب عادة واحد من هذه:

• ملفات تعريف الارتباط من أطراف أخرى أو مانع إعلانات في المتصفح الذي يُفتح لتسجيل الدخول. اسمح بملفات تعريف الارتباط لنطاق GoBanana ولـ authkit.app، أو سجل الدخول من نافذة عادية (غير خاصة).
• رابط عودة قديم. أغلق كل علامات تبويب تسجيل الدخول في GoBanana، ثم ابدأ تسجيل الدخول من العميل من جديد.
• رابط خاطئ. يجب أن ينتهي العنوان بـ /api/mcp. النطاق وحده أو /mcp لن يعمل.
• فرق في الساعة. الرموز تعتمد على الوقت. إن كانت ساعة جهازك متأخرة أو متقدمة بدقائق، فاضبطها على التحديث التلقائي.

“You are signed in, but GoBanana could not load your email yet. Try again in a minute.” نجح تسجيل دخولك الأول، لكن جلب بريدك الإلكتروني لم يكتمل. انتظر دقيقة وشغّل ping مرة أخرى.

الأدوات غائبة

1. تأكد أن الخادم متصل في قائمة MCP في عميلك، لا مضاف فقط. الخادم الذي يحتاج إلى تسجيل الدخول لا يعرض أي أدوات.
2. تأكد أن الرابط هو https://gobanana.fun/api/mcp بالضبط.
3. تأكد أن الأدوات مفعلة في المحادثة: + ثم Connectors في Claude، ومنتقي الأدوات في وضع الوكيل في VS Code، وCustomize في Cursor، ومفاتيح MCPs في Windsurf.
4. إضافة Claude Code: شغّل /plugin، وافتح تبويب Installed وتأكد أن gobanana مفعلة (أو شغّل claude plugin list). قد يستخدم تثبيت قديم مفتاح الخادم banana، فأعد التثبيت بـ /plugin install gobanana@gobanana.
5. أدوات كثيرة جدا: بعض العملاء يضعون حدا لمجموع الأدوات من كل الخوادم (Cascade في Windsurf: 100). أوقف أدوات من خوادم أخرى.
6. أعد تشغيل العميل. بعض العملاء لا يقرؤون الإعدادات إلا عند البدء.

اللوحة لا تظهر داخل المحادثة

وحدها العملاء التي تدعم MCP Apps تعرض اللوحة في المحادثة (Claude.ai وClaude Desktop يدعمانها). أما Claude Code، الذي يعمل في الطرفية، فلا يعرضها داخل المحادثة أبدا. كل رد يتعلق بلوحة يتضمن رابطها على الويب: https://gobanana.fun/c/<id>. افتحه في متصفح مسجل الدخول بالحساب نفسه.

إن قال الرابط إن اللوحة غير موجودة، فأنت مسجل الدخول على الويب بحساب آخر. سجل الخروج من /ar/account ثم سجل الدخول بالبريد الذي يعرضه ping.

إن ظهرت اللوحة داخل المحادثة لكنها تبدو قديمة، فهي تتحدث وحدها كل بضع ثوان ما دامت في حالة تركيز. انقر داخلها، أو أعد فتحها بطلب «افتح اللوحة».

رسائل الحصة والخطة

تبدأ الرسالة بـ	معناها	ما تفعله
“You have used your 30 free searches this month.”	استُهلكت حصة البحث المجانية	رقِّ خطتك، أو انتظر أول الشهر (UTC). الثني والتقييم وFrankenstein تبقى متاحة
“You have used your 3 free canvases.”	حد اللوحات المجانية	أضف إلى لوحة موجودة، أو احذف واحدة («احذف أقدم لوحة لي في GoBanana»، وسيطلب منك الوكيل التأكيد بالاسم)
“This canvas has reached the 40 item limit”	امتلأت اللوحة في الخطة المجانية	احذف بعض العناصر، أو ابدأ لوحة جديدة، أو رقِّ خطتك
“These formats need Pro:”	صيغ تصدير Pro في الخطة المجانية	الملفات المجانية في الطلب نفسه تُصدَّر رغم ذلك. استخدم BUILD-PROMPT.md وDIRECTION.md
“The parts library holds up to 80 parts.”	امتلأت مكتبة الأجزاء	احذف أجزاء من تبويب Parts في الدرج، أو أعد استخدام أجزاء موجودة

تعرض المهارات الرسالة مرة واحدة ثم تتوقف. إن ظل وكيل بلا مهارات يعيد المحاولة، فاطلب منه التوقف، فالمحاولات ستلقى الجواب نفسه. خلال الفترة التجريبية، تنطبق حدود Pro على الجميع.

شبكات الشركات والبروكسي

يحتاج GoBanana إلى الوصول إلى ثلاثة أشياء على الإنترنت من جهازك:

المضيف	السبب
gobanana.fun	نقطة اتصال MCP واللوحة والوثائق
*.authkit.app وapi.workos.com	تسجيل الدخول
مضيفو صور المراجع	تُحمَّل الصور من مصدرها: i.pinimg.com وcdn.dribbble.com وmir-s3-cdn-cf.behance.net وassets.awwwards.com ومضيفو المعارض

• فحص TLS: إن كان البروكسي يعيد توقيع HTTPS، فالعملاء المبنية على Node (Claude Code وCodex وmcp-remote) تحتاج إلى شهادة الجذر الخاصة بشركتك. اضبط NODE_EXTRA_CA_CERTS=/path/to/company-ca.pem قبل تشغيل العميل.
• بروكسي HTTP: اضبط HTTPS_PROXY (وNO_PROXY للمضيفين المحليين) في بيئة العميل. يحترمه Claude Code ومعظم أدوات Node.
• مضيفو صور محجوبون: تعرض اللوحة بطاقة رابط (العنوان والموقع والرابط) بدل الصورة. وكل ما عدا ذلك يعمل.
• workers.dev محجوب: بعض الشبكات تحجب النطاق workers.dev كله. اطلب من فريق تقنية المعلومات السماح بـ gobanana.fun. لا يوجد عنوان آخر حتى الآن.

رسائل أخرى

الرسالة	الحل
“That canvas was not found. Call open_canvas to create one, or check the canvasId.”	معرف خاطئ أو لوحة تخص حسابا آخر. طلب «اعرض لوحاتي في GoBanana» يعرض لوحاتك
“The canvas changed while saving. Try again.”	وصل تغييران في اللحظة نفسها. أعد الطلب نفسه
“Something went wrong on our side. Try again in a minute.”	انقطاع قصير. انتظر وأعد المحاولة مرة واحدة
“Search failed. Try again in a minute.”	مزود البحث لم يجب. أعد المحاولة مرة واحدة، ولا تُحتسب من حصتك
“That direction was not found. Directions are saved only when bend_brief gets a canvasId.”	لم يُحفظ الثني. اثنِ الموجز من جديد مع canvasId، أو ابحث بنص الاتجاه في query
“That section was not found on this canvas. Call get_canvas to see section ids.”	sectionId قديم. اقرأ اللوحة مرة واحدة واستخدم معرفا حاليا
“Nothing was deleted. Ask the user to confirm, then call again with confirm: true.”	تحتاج delete_canvas إلى موافقتك الصريحة

الصور ولوحات الألوان

• صورة مرجع لا تُحمَّل. الصورة تُحمَّل من مصدرها. إن حذفها المصدر، أو منع الربط المباشر، أو حجبت شبكتك المضيف، فيعرض العنصر بطاقة رابط. افتح رابط المصدر.
• اختفى مرجع. الأرجح أنه أزيل بطلب من مالكه. راجع الخصوصية والإزالة والمصادر.
• تخطت لوحة الألوان بعض الصور. تسرد extract_palette كل عنصر تخطته مع السبب: مضيف غير موجود في قائمة السماح، أو صورة كبيرة جدا، أو صيغة لا تقرؤها بعد (مثل WebP)، أو انتهاء المهلة. اختر عناصر أخرى وشغّلها مرة أخرى.

البحث وجد نتائج قليلة

راجع الأسئلة الشائعة: لماذا وجد البحث نتائج قليلة؟.

ما زالت المشكلة قائمة

شغّل ping وسجّل الرسالة بنصها، واسم عميلك وإصداره، والوقت. أرسلها عبر وسيلة التواصل في صفحة الخصوصية.