ربط Minds بـ Gemini CLI: الإضافة وإعداد MCP
ثبّت إضافة Minds باستخدام gemini extensions install https://github.com/minds-ai-co/minds-mcp، أو أضف https://getminds.ai/mcp باستخدام gemini mcp add، ثم سجّل الدخول إلى Minds عبر OAuth. لـ Google Antigravity اتبع دليل Antigravity.
Minds هي المنصة المتكاملة للبحث التركيبي التجاري. مع Gemini CLI تجد جماهيرك (Audiences)، وتخطط لدراسة (Study)، وتراجع خطة البحث المقترحة، وتقرأ النتائج من الطرفية. يتواصل Gemini CLI مع خادم Minds MCP على العنوان https://getminds.ai/mcp، وتسجّل الدخول بحساب Minds الخاص بك عبر OAuth.
المتطلبات
- تثبيت Gemini CLI وتسجيل الدخول فيه بمفتاح Gemini API أو Vertex AI أو ترخيص Gemini Code Assist Standard أو Enterprise. منذ يونيو 2026 لم يعد Gemini CLI يخدم حسابات Google الشخصية، وتوجّه Google المستخدمين الأفراد إلى Antigravity CLI؛ راجع Minds في Google Antigravity.
- حساب Minds. إذا لم يكن لديك حساب، يمكنك التسجيل أثناء الاتصال الأول.
- متصفح على الجهاز نفسه لتسجيل الدخول عبر OAuth، أو مفتاح Minds API للبيئات التي لا يتوفر فيها متصفح.
أي خيار يناسبك؟
| الخيار | متى | تسجيل الدخول |
|---|---|---|
| إضافة Minds (موصى به) | تريد Minds مع تعليمات البحث الخاصة به في خطوة واحدة. مدرجة في معرض إضافات Gemini CLI. | OAuth بحساب Minds |
| خادم MCP | تدير خوادم MCP بنفسك، لكل مشروع أو لمستخدمك، أو تحتاج إلى مفتاح API. | OAuth أو مفتاح Minds API |
| Google Antigravity | تستخدم Antigravity 2.0 أو Antigravity IDE أو Antigravity CLI (agy). | OAuth أو مفتاح Minds API |
استخدم خيارًا واحدًا لكل إعداد. تسجّل الإضافة والإدخال اليدوي كلاهما خادمًا باسم minds، لذا احتفظ بواحد منهما فقط.
الخيار أ: تثبيت إضافة Minds
1. التثبيت
gemini extensions install https://github.com/minds-ai-co/minds-mcp
يعرض Gemini CLI ما تضيفه الإضافة: خادم MCP البعيد minds على https://getminds.ai/mcp وملف السياق GEMINI.md الذي يطلب من الوكيل توضيح سؤال البحث وتأكيد خطة الدراسة قبل بدء أي تشغيل. أكّد بالضغط على Y. إذا لم يكن المجلد الحالي موثوقًا بعد، يطلب منك Gemini CLI الوثوق به أولًا.
2. التحقق من التثبيت
gemini extensions list
تظهر minds-mcp مع خادم MCP minds. وإلى أن تسجّل الدخول، يعرض gemini mcp list الخادم على أنه غير متصل.
3. تسجيل الدخول إلى Minds
شغّل gemini. عند الاتصال الأول يفتح Gemini CLI صفحة تسجيل الدخول إلى Minds في المتصفح؛ سجّل الدخول واختر Allow. لبدء تسجيل الدخول بنفسك أو لإعادة تسجيل الدخول لاحقًا، شغّل /mcp auth minds داخل الجلسة. بعد ذلك يعرض /mcp list أن Minds متصل مع أدواته.
4. إبقاؤها محدّثة
gemini extensions update minds-mcp
الخيار ب: إضافة Minds كخادم MCP
أضف الخادم لمستخدمك حتى يكون متاحًا في كل مجلد:
gemini mcp add --scope user --transport http minds https://getminds.ai/mcp
بدون --scope user يكتب Gemini CLI الإدخال في .gemini/settings.json داخل المشروع الحالي. يمكنك أيضًا تعديل ~/.gemini/settings.json بنفسك. لاستخدام HTTP القابل للبث استخدم httpUrl؛ أما url فيختار نقل SSE الأقدم:
{
"mcpServers": {
"minds": { "httpUrl": "https://getminds.ai/mcp" }
}
}
شغّل gemini وسجّل الدخول كما في الخطوة 3 من الخيار أ.
OAuth أم مفتاح API؟
- OAuth (موصى به): تسجّل الدخول بحساب Minds الخاص بك. يسجّل Gemini CLI نفسه لدى Minds تلقائيًا، فلا تحتاج إلى معرّف عميل أو سر، ويربط كل شخص حسابه الخاص.
- مفتاح API: للبيئات التي لا يتوفر فيها متصفح، مثل مهمة CI أو حساب خدمة مشترك. أنشئ مفتاحًا من Settings → API Keys وأضفه كترويسة:
gemini mcp add --scope user --transport http --header "Authorization: Bearer minds_YOUR_API_KEY" minds https://getminds.ai/mcp
يُحفظ المفتاح كنص عادي في settings.json. أبقِ هذا الملف خارج نظام التحكم في الإصدارات وفضّل OAuth على الأجهزة الشخصية.
الخيار ج: Google Antigravity
لـ Antigravity إعداداته الخاصة: تُعرَّف الخوادم البعيدة باستخدام serverUrl في ~/.gemini/config/mcp_config.json أو .agents/mcp_config.json، ويتم تسجيل الدخول من Settings → Customizations → Authenticate. يغطي دليل Antigravity واجهات Antigravity الثلاث.
هل تنتقل من Gemini CLI إلى Antigravity CLI؟ يحوّل الأمر agy plugin import gemini إضافة Minds المثبتة إلى إضافة Antigravity بالخادم نفسه.
تطبيق Gemini وGemini Enterprise
توثّق Google أيضًا اتصالات MCP المخصصة في تطبيق Gemini (للحسابات الشخصية في الولايات المتحدة) وفي Gemini Enterprise. لا يمكن ربط Minds بهما بعد. استخدم Gemini CLI أو Google Antigravity إلى أن يدعم Minds هذه الموصّلات.
كيف يعمل Minds في Gemini CLI
- التخطيط أولًا: قبل تشغيل أي شيء يعرض الوكيل خطة البحث عليك للموافقة. لا تبدأ الدراسة (Study) إلا بعد تأكيدك.
- التشغيلات الطويلة تستمر على الخادم: تعمل الدراسات بشكل دائم على Minds وتستمر حتى لو أغلقت الطرفية. اسأل Gemini CLI عن حالتها لاحقًا.
- تعمّق في Minds: ترتبط النتائج بالدراسة في Minds، حيث تراجع الإجابات الفردية وتقارن الجماهير وتصدّر النتائج.
الأدوات التي يمكن لـ Gemini CLI استخدامها مدرجة في مرجع الأدوات. وتشرح نظرة عامة على MCP التكامل ككل.
استكشاف الأخطاء وإصلاحها
يظهر Minds على أنه غير متصل. شغّل /mcp auth minds في جلسة Gemini CLI وأكمل تسجيل الدخول في المتصفح.
لا تُفتح صفحة تسجيل الدخول. يستقبل Gemini CLI استدعاء OAuth الراجع على منفذ محلي، لذا يجب أن يعمل المتصفح على الجهاز نفسه. عبر SSH أو داخل حاوية، استخدم مفتاح API بدلًا من ذلك.
خادمان لـ Minds أو أدوات مكررة. الإضافة والإدخال اليدوي مفعّلان معًا. أزل أحدهما باستخدام gemini extensions uninstall minds-mcp أو gemini mcp remove minds.
"Not authorized" لدراسة أو جمهور يمكنك فتحه في Minds. Gemini CLI متصل بحساب Minds مختلف عن الحساب المالك للدراسة. شغّل /mcp auth minds مرة أخرى بالحساب الصحيح، أو شارك الدراسة مع الحساب المتصل.
لا تظهر أدوات Minds الجديدة. أعد تشغيل Gemini CLI ليعيد تحميل قائمة الأدوات، وشغّل gemini extensions update minds-mcp إذا كنت تستخدم الإضافة.
العملاء الآخرون مثل ChatGPT وClaude وCodex مدرجون في نظرة عامة على التكاملات.
عنوان خادم MCP
https://getminds.ai/mcp
