Zum Hauptinhalt springen

Gemini CLI verbinden

Am 29. September 2026 anhand der Herstellerdokumentation überprüft, kein vollständiger Praxistest

Die folgenden Schritte basieren auf der Gemini-CLI-Dokumentation „MCP-Server mit Gemini CLI“. Wir haben uns selbst noch nicht aus Gemini CLI bei NameBeta angemeldet.

Voraussetzungen​

  • Gemini CLI.
  • Ein NameBeta-Konto. Sie können auch während der Einrichtung auf der Anmeldeseite eines erstellen.
  • Eine vorab registrierte Client-ID. Gemini CLI registriert sich bei einem OAuth-Server ausschließlich über Dynamic Client Registration, das NameBeta nicht anbietet. Client ID Metadata Documents werden in seiner Dokumentation nicht erwähnt. Die Maintainer haben die Anfrage zur CIMD-Unterstützung ohne Umsetzungspläne geschlossen. Fordern Sie wie unter Vorab registrierte Client-IDs beschrieben eine Client-ID an. Nennen Sie dabei Gemini CLI und die Weiterleitungs-URI http://localhost:7777/oauth/callback.

Server hinzufügen​

Gemini CLI liest MCP-Server aus settings.json:

DateiGeltungsbereich
~/.gemini/settings.jsonAlle Ihre Projekte
.gemini/settings.jsonDas aktuelle Projekt

Fügen Sie unter mcpServers einen Eintrag für namebeta mit der erhaltenen Client-ID hinzu:

{
"mcpServers": {
"namebeta": {
"httpUrl": "https://namebeta.com/api/mcp",
"oauth": {
"enabled": true,
"clientId": "<client ID>",
"redirectUri": "http://localhost:7777/oauth/callback"
}
}
}
}
  • httpUrl wählt den Transport Streamable HTTP aus; url würde SSE auswählen.
  • redirectUri legt den Port fest. Ohne diese Angabe wählt Gemini CLI einen zufälligen Port, der nicht zur registrierten Weiterleitungs-URI Ihrer Client-ID passt. Wenn Port 7777 auf Ihrem Rechner belegt ist, nennen Sie beim Anfordern der Client-ID einen anderen Port.

Anmelden​

  1. Starten Sie Gemini CLI und führen Sie /mcp auth namebeta aus. Ihr Browser öffnet die NameBeta-Anmeldeseite.
  2. Melden Sie sich an, erlauben Sie den Zugriff und kehren Sie zum Terminal zurück.

gemini mcp list sollte den Server jetzt als verbunden anzeigen:

✓ namebeta: https://namebeta.com/api/mcp (http) - Connected

Ausprobieren​

Unter welchen TLDs ist brewlab noch frei? Und welche der vergebenen stehen zum Verkauf?

Gemini CLI führt check_availability aus. Die Antwort sollte vergebene, zum Verkauf stehende und verfügbare Domains enthalten. Das Beispiel des Tools zeigt das Ergebnis vom 29. September 2026.

Verbindung trennen oder Konto wechseln​

  • gemini mcp remove namebeta entfernt den Server aus der Projektkonfiguration. Ergänzen Sie -s user, wenn Sie ihn in ~/.gemini/settings.json hinzugefügt haben.
  • Wenn Sie ein anderes NameBeta-Konto verwenden möchten, folgen Sie Konto wechseln und führen Sie anschließend erneut /mcp auth namebeta aus.

Verbindungsprobleme​

Führen Sie in Gemini CLI /mcp list aus, um den Serverfehler anzuzeigen, und lesen Sie anschließend Fehlerbehebung.