ربط Gemini CLI باستوديوك

ما هو

Gemini CLI هو Gemini من Google ويعمل في طرفية الكمبيوتر. باستخدام موصل الذكاء الاصطناعي، يمكنه الاطلاع على بيانات استوديوك (المبيعات والعملاء والمواعيد والبيانات المالية) عندما تطرح عليه سؤالًا، وفقًا لصلاحيات المستخدم الذي يملك المفتاح. يقتصر دوره على الاطلاع، ولا يغيّر أي شيء في النظام.

متى تستخدمه

إذا كنت تستخدم Gemini في الطرفية وتريد الاستفسار عن نشاط الاستوديو دون فتح النظام.
إذا أردت مقارنة أرقام النظام بمهام أخرى ينفذها Gemini لك.

قبل أن تبدأ

جهّز عنوان الموصل، وانسخه وفقًا للمقال ربط أداة الذكاء الاصطناعي، ومفتاح API مع تفعيل خيار “السماح بالاستخدام كموصل ذكاء اصطناعي”. يجب تثبيت Gemini CLI على الكمبيوتر. يمكنك أيضًا تسجيل الدخول إلى النظام: إذا لم تستخدم ترويسة المفتاح، فاكتب /mcp auth heya في Gemini CLI وسجّل الدخول من الشاشة التي ستفتح.

خطوة بخطوة

الخطوة 1 — إضافة الموصل

في الطرفية، نفّذ الأمر أدناه، مع استبدال العنوان بالعنوان الذي نسخته من نسخ العنوان، واستبدال hk_... بمفتاحك:

gemini mcp add --transport http --header "Authorization: Bearer hk_..." heya https://seu-dominio/mcp

لاستخدامه في جميع مجلدات الكمبيوتر، أضف -s user. وإذا فضّلت تعديل ملف الإعدادات (~/.gemini/settings.json)، فاستخدم هذا المقطع:

{
  "mcpServers": {
    "heya": {
      "httpUrl": "https://seu-dominio/mcp",
      "headers": { "Authorization": "Bearer hk_..." }
    }
  }
}

استخدم httpUrl وليس url: في Gemini CLI، url هو تنسيق الاتصال القديم ولا يعمل مع الموصل.

الخطوة 2 — التحقق من الاتصال

افتح Gemini CLI واكتب /mcp. يجب أن يظهر الموصل heya بالحالة CONNECTED، مع الأدوات listar_areas وbuscar_ferramentas وexecutar_consulta.

الخطوة 3 — طرح سؤال

على سبيل المثال، اسأل: “ما المصروفات المستحقة هذا الأسبوع في الاستوديو؟”.

ماذا يحدث بعد ذلك

يعثر Gemini على الاستعلام المناسب لسؤالك، وينفّذه، ثم يعرض الأرقام من النظام.
يظهر استخدام المفتاح في علامة التبويب مفتاح API مع تحديث آخر استخدام.
لإلغاء إمكانية الوصول، ألغِ المفتاح في علامة التبويب مفتاح API: سيفقد Gemini إمكانية الوصول خلال 30 ثانية.

أخطاء شائعة وأسئلة

س: هل يعمل في Gemini على المتصفح (gemini.google.com)؟ ج: ليس بعد. يطلب Gemini على المتصفح تسجيل الدخول بطريقة خاصة به بدلًا من استخدام مفتاح API. استخدم Gemini CLI.

س: تظهر الحالة DISCONNECTED عند كتابة /mcp. ماذا أفعل؟ ج: تحقّق من استخدام httpUrl (وليس url)، ومن أن العنوان ينتهي بـ /mcp، ومن نسخ المفتاح كاملًا مع Bearer ومسافة بعده.

س: يقول Gemini إن المفتاح يحتاج إلى تفعيل خيار “السماح بالاستخدام كموصل ذكاء اصطناعي”. لماذا؟ ج: أُنشئ المفتاح دون تفعيل هذا الخيار. عدّل المفتاح في علامة التبويب مفتاح API، ثم فعّل السماح بالاستخدام كموصل ذكاء اصطناعي.

س: أصبح Gemini CLI لديّ Antigravity CLI. هل تنطبق عليه الخطوات؟ ج: استبدلت Google Gemini CLI بـ Antigravity CLI في بعض الحسابات. ابحث فيه عن خيار إضافة خادم MCP عبر HTTP مع ترويسة: العنوان والترويسة Authorization: Bearer hk_... هما نفسهما.

س: هل يمكنني حفظ المفتاح في ملف داخل المشروع؟ ج: تجنّب ذلك. غالبًا ما يُضاف ملف .gemini/settings.json في مجلد المشروع إلى نظام التحكم بالإصدارات، ما قد يكشف المفتاح. يُفضّل استخدام ملف المستخدم (~/.gemini/settings.json).