Documentation menu

Gemini verbinden

Welche Schritte gelten, hängt davon ab, wie Sie Gemini nutzen: die Verbraucher-App (Spark), Gemini Enterprise über Ihre Organisation oder die Antigravity-CLI. Wählen Sie unten die passende Option.

Gemini-App (Spark)

  1. Gehen Sie zu gemini.google.com → Settings & help → Connected apps → Custom apps for Spark → Add a custom app.
  2. Fügen Sie https://mailinapp.com/api/mcp als Server-URL ein.
  3. Bestätigen Sie MailInApps Zustimmungsbildschirm, wenn Gemini ihn öffnet — melden Sie sich bei Bedarf an, wählen Sie das Konto, als das verbunden werden soll, falls Sie zu mehr als einem gehören, wählen Sie Ihre Scopes (siehe Scopes & Berechtigungen), und bestätigen Sie.

Das war's — nichts einzureichen oder zu überprüfen, genau wie beim Verbinden von Claude oder ChatGPT. Wenn Sie Custom apps for Spark nicht als Option sehen, liegt das an einer Zulassungsbeschränkung von Google, nicht an etwas auf Seiten von MailInApp: Google beschränkt benutzerdefinierte Spark-Apps derzeit auf in den USA ansässige, volljährige, persönliche Google-Konten, mit aktiviertem „Keep Activity“ und der Gemini-App auf Englisch eingestellt. Außerhalb dieser Einschränkungen erscheint die Option überhaupt nicht.

Gemini Enterprise (über Ihre Organisation)

Wenn Ihr Unternehmen Gemini Enterprise verwendet, können Sie MailInApp nicht selbst hinzufügen, wie Sie es in der Verbraucher-App tun würden — es ist standardmäßig hinter einer Organisationsrichtlinie deaktiviert, und das Aktivieren ist eine einmalige Einrichtung, die Ihr Workspace-Admin vornimmt, nicht Sie. Senden Sie Ihrem Admin diese Angaben:

  • Authorization-URL: https://mailinapp.com/oauth/authorize
  • Token-URL: https://mailinapp.com/oauth/token
  • Scopes: eine beliebige Kombination aus Scopes & Berechtigungen, durch Leerzeichen getrennt.
  • PKCE: aktiviert (S256).
  • Client-ID/-Secret: Schreiben Sie eine E-Mail an [email protected] mit der Redirect-URI, die Ihr Gemini-Enterprise-Tenant verwendet, und wir stellen eines aus, das Ihr Admin eintragen kann.

Sobald Ihr Admin dies eingerichtet hat, funktioniert das Verbinden und Nutzen von MailInApp über Gemini Enterprise genauso wie bei jedem anderen Assistenten — anmelden, Konto wählen, Scopes wählen, bestätigen.

Antigravity CLI

Wenn Sie Antigravity CLI (den Nachfolger von Gemini CLI) statt der Gemini-App verwenden, fügen Sie MailInApp zu dessen Konfigurationsdatei hinzu statt zu einem Einstellungsbildschirm. Fügen Sie einen Eintrag zu mcp_config.json (oder .agents/mcp_config.json) hinzu:

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

Antigravity CLI öffnet beim ersten Verbinden denselben OAuth-Zustimmungsbildschirm wie jeder andere Client.

Wenn eine Verbindung nicht mehr funktioniert

  • Keine Option „Add a custom app“ unter Connected Apps — das ist Googles eigene Zulassungsbeschränkung, nicht die von MailInApp: Sparks Custom-App-Funktion erfordert ein in den USA ansässiges, volljähriges, persönliches Google-Konto, aktiviertes „Keep Activity“ und die Gemini-App auf Englisch eingestellt. Die Option erscheint außerhalb dieser Einschränkungen überhaupt nicht, unabhängig von irgendetwas auf Seiten von MailInApp.
  • Enterprise-Verbindung von der Konfiguration Ihres Admins abgelehnt — die von MailInApp ausgestellte Client-ID/-Secret ist an genau die Redirect-URI gebunden, die Ihr Tenant bei der Einrichtung angegeben hat. Ändert sich diese URI, lassen Sie Ihren Admin eine E-Mail mit der neuen URI an [email protected] senden, statt den alten Client weiterzuverwenden.
  • Antigravity CLI meldet einen Verbindungsfehler — prüfen Sie, ob mcp_config.json gültiges JSON ist und das Feld url genau https://mailinapp.com/api/mcp lautet; ein fehlerhaftes mcpServers-Objekt ist die häufigste Ursache.
  • Sie haben das Team gewechselt, oder ein Teammitglied hat Ihren Zugriff widerrufen — wie bei jeder anderen Plattform wird ein Gemini-Connector-Token bei jedem Aufruf erneut gegen Ihre aktuelle Kontomitgliedschaft geprüft. Der Verlust des Zugriffs auf ein Unternehmen deaktiviert die Aufrufe dieser Verbindung sofort, ohne dass Sie auf Seiten von Gemini irgendetwas tun müssen.

Widerrufen

Unabhängig davon, über welche Gemini-Oberfläche Sie sich verbunden haben, listet Verbindungen im MailInApp-Dashboard (/dashboard/connections) sie neben jedem anderen Assistenten mit einem Ein-Klick-Widerrufen auf — das Token funktioniert beim nächsten Aufruf nicht mehr.