Gemini CLI
Füge Shotomatic als lokalen MCP-Server zu Gemini CLI hinzu, prüfe, ob es funktioniert, und behebe häufige Probleme bei der Einrichtung.
Aktualisiert am 16. November 2026
Auf dieser Seite
Gemini CLI kann Shotomatic über den lokalen MCP-Server von Shotomatic nutzen. Diese Schritte folgen der Dokumentation von Gemini CLI (MCP servers with Gemini CLI). Shotomatic ist mit Claude Code und Codex getestet, nicht mit Gemini CLI. Passt ein Menü oder eine Datei nicht mehr, schau in die Dokumentation von Gemini CLI.
Bevor du anfängst
- Öffne in Shotomatic Einstellungen > KI-Agenten und schalte Zugriff für KI-Agenten erlauben ein.
- Installiere Node 18.3 oder neuer. Der Client startet ein kleines Brückenpaket namens
shotomaticmitnpx. Es gibt keinen API-Schlüssel. - Erlaube auf dem Mac Bildschirmaufnahme und, für Tastendrücke, Bedienungshilfen. Siehe macOS-Berechtigungen.
Shotomatic zu Gemini CLI hinzufügen
Füge dies in ~/.gemini/settings.json ein (oder in .gemini/settings.json in einem Projekt):
{
"mcpServers": {
"shotomatic": {
"command": "npx",
"args": ["-y", "shotomatic", "mcp"]
}
}
}
Lass trust auf dem Standardwert (false), damit Gemini CLI vor jedem Werkzeugaufruf weiter nachfragt.
Kann der Client unter Windows npx nicht starten, trage cmd als Befehl und /c, npx, -y, shotomatic, mcp als Argumente ein.
Einmal zulassen
Wenn sich Gemini CLI zum ersten Mal verbindet, zeigt Shotomatic eine Zulassungskarte mit dem Namen, den der Client meldet. Wähle Erlauben. Bis dahin kann der Agent nur den Status von Shotomatic lesen. Siehe Zulassungen und Bestätigungen.
Prüfen, ob es funktioniert
Führe gemini mcp list in einer Shell aus oder /mcp in einer Sitzung. Bitte dann:
„Prüfe den Status von Shotomatic und sag mir, was du damit tun kannst.“
Bei einer funktionierenden Einrichtung nennt der Agent die Shotomatic-Version, ob auf dem Mac Bildschirmaufnahme und Bedienungshilfen erlaubt sind, deine Version und die heute noch verfügbaren kostenlosen Screenshots, ob der Browser für Websites installiert ist und welche Aufnahmen bereits laufen.
Laut Dokumentation von Gemini CLI werden Bilder in MCP-Werkzeugergebnissen unterstützt, der Agent sieht also die Vorschauen und Bilder, die er anfordert.
Wenn das Werkzeug fehlt
- Der Server erscheint als getrennt. Stdio-Server erscheinen nur als verbunden, wenn der aktuelle Ordner als vertrauenswürdig gilt.
- „MCP access is turned off.“ Schalte unter Einstellungen > KI-Agenten Zugriff für KI-Agenten erlauben ein und starte den Client neu.
- Es erscheint keine Zulassungskarte. Öffne Shotomatic und suche die Karte. Auf dem Mac hüpft das Dock-Symbol, wenn sie erscheint.
- Der Client findet
npxoder Node nicht. Siehe die Fehlerliste für alle Clients.
Probier als Nächstes eine Anfrage aus Was Agenten tun können oder sieh dir alle Werkzeuge in der Werkzeugreferenz an.