Minds mit Gemini CLI verbinden: Extension und MCP-Einrichtung

Minds ist die End-to-End-Plattform für kommerzielle synthetische Forschung. Mit Gemini CLI findest du deine Audiences, planst eine Study, prüfst den vorgeschlagenen Forschungsplan und liest Ergebnisse direkt im Terminal. Gemini CLI spricht dafür mit dem Minds-MCP-Server unter https://getminds.ai/mcp; du meldest dich per OAuth mit deinem Minds-Konto an.

Voraussetzungen

• Gemini CLI ist installiert und mit einem Gemini-API-Key, Vertex AI oder einer Lizenz für Gemini Code Assist Standard oder Enterprise angemeldet. Seit Juni 2026 bedient Gemini CLI keine privaten Google-Konten mehr; Google verweist Einzelnutzer auf die Antigravity CLI, siehe Minds in Google Antigravity.
• Ein Minds-Konto. Falls du noch keins hast, kannst du dich bei der ersten Verbindung registrieren.
• Ein Browser auf demselben Rechner für die OAuth-Anmeldung, oder ein Minds-API-Key für Umgebungen ohne Browser.

Welche Option passt?

Nutze pro Einrichtung nur eine Option. Extension und manueller Eintrag registrieren beide einen Server namens minds; behalte also nur einen davon.

Option A: Minds-Extension installieren

1. Installieren

gemini extensions install https://github.com/minds-ai-co/minds-mcp

Gemini CLI zeigt, was die Extension hinzufügt: den Remote-MCP-Server minds unter https://getminds.ai/mcp und die Kontextdatei GEMINI.md. Sie weist den Agenten an, die Forschungsfrage zu klären und einen Studienplan bestätigen zu lassen, bevor ein Lauf startet. Bestätige mit Y. Ist der aktuelle Ordner noch nicht vertrauenswürdig, fragt Gemini CLI zuerst danach.

2. Installation prüfen

gemini extensions list

minds-mcp erscheint mit dem MCP-Server minds. Bis du dich anmeldest, zeigt gemini mcp list den Server als getrennt an.

3. Bei Minds anmelden

Starte gemini. Beim ersten Verbinden öffnet Gemini CLI die Minds-Anmeldeseite im Browser; melde dich an und wähle Allow. Um die Anmeldung selbst zu starten oder dich später erneut anzumelden, führe in der Sitzung /mcp auth minds aus. /mcp list zeigt Minds danach als verbunden, mit seinen Werkzeugen.

4. Aktuell halten

gemini extensions update minds-mcp

Option B: Minds als MCP-Server hinzufügen

Füge den Server für deinen Benutzer hinzu, damit er in jedem Ordner verfügbar ist:

gemini mcp add --scope user --transport http minds https://getminds.ai/mcp

Ohne --scope user schreibt Gemini CLI den Eintrag in .gemini/settings.json des aktuellen Projekts. Du kannst ~/.gemini/settings.json auch selbst bearbeiten. Für Streamable HTTP verwendest du httpUrl; url wählt den älteren SSE-Transport:

{
  "mcpServers": {
    "minds": { "httpUrl": "https://getminds.ai/mcp" }
  }
}

Starte gemini und melde dich an wie in Schritt 3 von Option A.

OAuth oder API-Key?

• OAuth (empfohlen): Du meldest dich mit deinem Minds-Konto an. Gemini CLI registriert sich automatisch bei Minds, du brauchst also weder Client-ID noch Secret, und jede Person verbindet ihr eigenes Konto.
• API-Key: für Umgebungen ohne Browser, etwa einen CI-Job oder ein gemeinsames Dienstkonto. Erstelle einen Key unter Settings → API Keys und füge ihn als Header hinzu:

gemini mcp add --scope user --transport http --header "Authorization: Bearer minds_YOUR_API_KEY" minds https://getminds.ai/mcp

Der Key steht im Klartext in settings.json. Halte diese Datei aus der Versionsverwaltung heraus und nutze auf persönlichen Rechnern lieber OAuth.

Option C: Google Antigravity

Antigravity hat eine eigene Konfiguration: Remote-Server werden mit serverUrl in ~/.gemini/config/mcp_config.json oder .agents/mcp_config.json eingetragen, und die Anmeldung läuft über Settings → Customizations → Authenticate. Die Antigravity-Anleitung deckt alle drei Antigravity-Oberflächen ab.

Wechselst du von Gemini CLI zur Antigravity CLI? agy plugin import gemini wandelt die installierte Minds-Extension in ein Antigravity-Plugin mit demselben Server um.

Gemini-App und Gemini Enterprise

Google dokumentiert eigene MCP-Verbindungen auch in der Gemini-App (private Konten in den USA) und in Gemini Enterprise. Dort lässt sich Minds noch nicht verbinden. Nutze Gemini CLI oder Google Antigravity, bis Minds diese Connectoren unterstützt.

So arbeitet Minds in Gemini CLI

• Erst planen: Bevor etwas läuft, legt dir der Agent den Forschungsplan zur Freigabe vor. Eine Study startet erst nach deiner Bestätigung.
• Lange Läufe gehen auf dem Server weiter: Studies laufen dauerhaft bei Minds und laufen weiter, wenn du das Terminal schließt. Frag Gemini CLI später nach dem Status.
• Tiefer in Minds: Ergebnisse verlinken auf die Study in Minds, wo du einzelne Antworten prüfst, Audiences vergleichst und Ergebnisse exportierst.

Welche Werkzeuge Gemini CLI nutzen kann, steht in der Werkzeugreferenz. Die MCP-Übersicht erklärt die Integration als Ganzes.

Fehlerbehebung

Minds wird als getrennt angezeigt. Führe in einer Gemini-CLI-Sitzung /mcp auth minds aus und schließe die Anmeldung im Browser ab.

Die Anmeldeseite öffnet sich nicht. Gemini CLI empfängt den OAuth-Callback auf einem lokalen Port, der Browser muss also auf demselben Rechner laufen. Über SSH oder in einem Container nutzt du stattdessen einen API-Key.

Zwei Minds-Server oder doppelte Werkzeuge. Extension und manueller Eintrag sind beide aktiv. Entferne einen davon mit gemini extensions uninstall minds-mcp oder gemini mcp remove minds.

„Not authorized“ für eine Study oder Audience, die du in Minds öffnen kannst. Gemini CLI ist mit einem anderen Minds-Konto verbunden als dem, dem die Study gehört. Führe /mcp auth minds erneut mit dem richtigen Konto aus oder teile die Study mit dem verbundenen Konto.

Neue Minds-Werkzeuge erscheinen nicht. Starte Gemini CLI neu, damit die Werkzeugliste neu geladen wird, und führe gemini extensions update minds-mcp aus, wenn du die Extension nutzt.

Weitere Clients wie ChatGPT, Claude und Codex findest du in der Integrationsübersicht.

MCP-Server-URL

https://getminds.ai/mcp

Vollständige MCP-Dokumentation ansehen