mailinapp
Documentation menu

Connecter Gemini

Les étapes qui s'appliquent dépendent de la façon dont vous utilisez Gemini : l'application grand public (Spark), Gemini Enterprise via votre organisation, ou la CLI Antigravity. Choisissez ci-dessous celle qui vous correspond.

Application Gemini (Spark)

  1. Allez dans gemini.google.com → Settings & help → Connected apps → Custom apps for Spark → Add a custom app.
  2. Collez https://mailinapp.com/api/mcp comme URL de serveur.
  3. Approuvez l'écran de consentement de MailInApp lorsque Gemini l'ouvre — connectez-vous si nécessaire, choisissez le compte à connecter si vous en avez plusieurs, sélectionnez vos portées (voir Portées et autorisations), et approuvez.

C'est tout — rien à soumettre ni à faire examiner, comme pour connecter Claude ou ChatGPT. Si vous ne voyez pas Custom apps for Spark comme option, c'est une restriction d'admissibilité de Google plutôt que quelque chose du côté de MailInApp : Google limite actuellement les applications Spark personnalisées aux comptes Google personnels, basés aux États-Unis, de 18 ans et plus, avec « Keep Activity » activé et l'application Gemini réglée en anglais. Hors de ces conditions, l'option n'apparaît pas du tout.

Gemini Enterprise (via votre organisation)

Si votre entreprise utilise Gemini Enterprise, vous ne pouvez pas ajouter MailInApp vous-même comme dans l'application grand public — c'est désactivé par défaut derrière une politique d'organisation, et l'activer est une configuration ponctuelle que fait votre administrateur Workspace, pas vous. Envoyez ces informations à votre administrateur :

  • URL d'autorisation : https://mailinapp.com/oauth/authorize
  • URL de jeton : https://mailinapp.com/oauth/token
  • Portées : toute combinaison issue de Portées et autorisations, séparées par des espaces.
  • PKCE : activé (S256).
  • Identifiant client / secret : écrivez à [email protected] avec l'URI de redirection utilisée par votre locataire Gemini Enterprise, et nous en émettrons un que votre administrateur pourra saisir.

Une fois que votre administrateur a mis cela en place, se connecter et utiliser MailInApp via Gemini Enterprise fonctionne comme n'importe quel autre assistant — connectez-vous, choisissez votre compte, sélectionnez les portées, approuvez.

CLI Antigravity

Si vous utilisez la CLI Antigravity (la successeure de Gemini CLI) plutôt que l'application Gemini, ajoutez MailInApp à son fichier de configuration plutôt qu'à un écran de paramètres. Ajoutez une entrée à mcp_config.json (ou .agents/mcp_config.json) :

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

La CLI Antigravity ouvre le même écran de consentement OAuth que tout autre client lors de sa première connexion.

Si une connexion cesse de fonctionner

  • Pas d'option « Add a custom app » sous Connected Apps — c'est une restriction d'admissibilité propre à Google, pas à MailInApp : la fonctionnalité d'application personnalisée de Spark exige un compte Google personnel basé aux États-Unis, de 18 ans et plus, avec « Keep Activity » activé, et l'application Gemini réglée en anglais. L'option n'apparaîtra pas du tout hors de ces conditions, quoi que fasse MailInApp de son côté.
  • Connexion Enterprise rejetée par la configuration de votre administrateur — l'identifiant client/secret émis par MailInApp est lié exactement à l'URI de redirection fournie par votre locataire lors de la configuration. Si cette URI change, demandez à votre administrateur d'écrire à [email protected] avec la nouvelle plutôt que de réutiliser l'ancien client.
  • La CLI Antigravity signale une erreur de connexion — vérifiez que mcp_config.json est un JSON valide et que le champ url contient exactement https://mailinapp.com/api/mcp ; un objet mcpServers malformé est la cause la plus fréquente.
  • Vous avez changé d'équipe, ou un coéquipier a révoqué votre accès — comme sur toute autre plateforme, un jeton de connecteur Gemini est revalidé par rapport à votre appartenance de compte actuelle à chaque appel, donc perdre l'accès à une entreprise désactive immédiatement les appels de cette connexion, sans que vous ayez besoin de faire quoi que ce soit du côté de Gemini.

Révocation

Quelle que soit la surface Gemini par laquelle vous vous êtes connecté, Connexions dans le tableau de bord MailInApp (/dashboard/connections) le liste avec chaque autre assistant, avec un bouton Révoquer en un clic — le jeton cesse de fonctionner dès son prochain appel.