ربط Gemini

تعتمد الخطوات المنطبقة على طريقة استخدامك لـ Gemini: تطبيق المستهلكين (Spark)، أو Gemini Enterprise عبر مؤسستك، أو Antigravity CLI. اختر ما يناسبك أدناه.

تطبيق Gemini (Spark)

1. انتقل إلى gemini.google.com → Settings & help → Connected apps → Custom apps for Spark → Add a custom app.
2. الصق https://mailinapp.com/api/mcp رابطًا للخادم.
3. وافق على شاشة الموافقة الخاصة بـ MailInApp حين يفتحها Gemini — سجّل الدخول إن لزم الأمر، واختر الحساب الذي تريد الربط باسمه إن كنت تنتمي إلى أكثر من حساب، واختر نطاقاتك (راجع النطاقات والصلاحيات)، ثم وافق.

هذا كل شيء — لا شيء يُرسل للمراجعة، تمامًا كربط Claude أو ChatGPT. وإن لم ترَ خيار Custom apps for Spark، فهذا شرط أهلية من Google لا شيء من جهة MailInApp: إذ تقصر Google حاليًا تطبيقات Spark المخصّصة على حسابات Google الشخصية في الولايات المتحدة لمن هم فوق 18 عامًا، مع تفعيل «Keep Activity» وضبط تطبيق Gemini على الإنجليزية. وخارج هذه القيود لا يظهر الخيار إطلاقًا.

Gemini Enterprise (عبر مؤسستك)

إن كانت شركتك تستخدم Gemini Enterprise، فلا يمكنك إضافة MailInApp بنفسك كما تفعل في تطبيق المستهلكين — فهو معطّل افتراضيًا خلف سياسة مؤسسية، وتفعيله إعداد لمرة واحدة يجريه مسؤول Workspace لديك، لا أنت. أرسل إلى المسؤول هذه التفاصيل:

• رابط التفويض: https://mailinapp.com/oauth/authorize
• رابط الرموز: https://mailinapp.com/oauth/token
• النطاقات: أي تركيبة من النطاقات والصلاحيات، مفصولة بمسافات.
• PKCE: مفعّل (S256).
• معرّف العميل / سرّه: راسل [email protected] مع رابط إعادة التوجيه (redirect URI) الذي يستخدمه مستأجر Gemini Enterprise لديك، وسنصدر واحدًا ليُدخله المسؤول.

بمجرد أن يُعدّ المسؤول ذلك، يعمل ربط MailInApp واستخدامه عبر Gemini Enterprise كأي مساعد آخر — سجّل الدخول، واختر حسابك، واختر النطاقات، ثم وافق.

Antigravity CLI

إن كنت تستخدم Antigravity CLI (خليفة Gemini CLI) بدلًا من تطبيق Gemini، فأضف MailInApp إلى ملف الإعداد الخاص به بدلًا من شاشة إعدادات. أضف إدخالًا إلى mcp_config.json (أو .agents/mcp_config.json):

{
  "mcpServers": {
    "mailinapp": {
      "url": "https://mailinapp.com/api/mcp"
    }
  }
}

يفتح Antigravity CLI شاشة موافقة OAuth نفسها التي يفتحها كل عميل آخر في أول مرة يتصل فيها.

إن توقف الاتصال عن العمل

• لا يوجد خيار «Add a custom app» ضمن Connected Apps — هذا شرط أهلية خاص بـ Google، لا بـ MailInApp: إذ تتطلب ميزة التطبيقات المخصّصة في Spark حساب Google شخصيًا في الولايات المتحدة لمن هم فوق 18 عامًا، مع تفعيل «Keep Activity»، وضبط تطبيق Gemini على الإنجليزية. ولن يظهر الخيار إطلاقًا خارج هذه القيود، بغض النظر عن أي شيء من جهة MailInApp.
• رفض إعداد المسؤول للاتصال المؤسسي — معرّف العميل/السرّ الذي أصدره MailInApp مرتبط برابط إعادة التوجيه نفسه تمامًا الذي قدّمه مستأجرك عند الإعداد. فإن تغيّر ذلك الرابط، فاطلب من المسؤول مراسلة [email protected] بالرابط الجديد بدلًا من إعادة استخدام العميل القديم.
• يُبلغ Antigravity CLI عن خطأ في الاتصال — تحقّق من أن mcp_config.json ملف JSON صالح وأن حقل url يساوي https://mailinapp.com/api/mcp تمامًا؛ فكائن mcpServers المشوّه هو السبب الأكثر شيوعًا.
• غيّرت فريقك، أو ألغى زميل وصولك — كما في كل منصة أخرى، يُعاد التحقق من رمز موصّل Gemini مقابل عضويتك الحيّة في الحساب مع كل استدعاء، لذا فإن فقدان الوصول إلى شركة يعطّل استدعاءات ذلك الاتصال فورًا، دون أن تحتاج إلى فعل أي شيء من جهة Gemini.

الإلغاء

أيًّا كانت واجهة Gemini التي ربطت عبرها، تعرضها الاتصالات في لوحة تحكم MailInApp (/dashboard/connections) إلى جانب كل مساعد آخر مع زر إلغاء بنقرة واحدة — فيتوقف الرمز عن العمل عند استدعائه التالي.