# Gemini CLI | Benutzerhandbuch | Shotomatic

> Füge Shotomatic als lokalen MCP-Server zu Gemini CLI hinzu, prüfe, ob es funktioniert, und behebe häufige Probleme bei der Einrichtung.

- Typ: Öffentliche Webseite
- Kanonische Seite: [https://www.shotomatic.com/de/guide/ai-agents/clients/gemini-cli](https://www.shotomatic.com/de/guide/ai-agents/clients/gemini-cli)
- Markdown-Seite: [https://www.shotomatic.com/de/guide/ai-agents/clients/gemini-cli.md](https://www.shotomatic.com/de/guide/ai-agents/clients/gemini-cli.md)

Benutzerhandbuch durchsuchen

Auf dieser Seite

1.  [Bevor du anfängst](#bevor-du-anfängst)
2.  [Shotomatic zu Gemini CLI hinzufügen](#shotomatic-zu-gemini-cli-hinzufügen)
3.  [Einmal zulassen](#einmal-zulassen)
4.  [Prüfen, ob es funktioniert](#prüfen-ob-es-funktioniert)
5.  [Wenn das Werkzeug fehlt](#wenn-das-werkzeug-fehlt)

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](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md)). 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 `shotomatic` mit `npx`. Es gibt keinen API-Schlüssel.
-   Erlaube auf dem Mac **Bildschirmaufnahme** und, für Tastendrücke, **Bedienungshilfen**. Siehe [macOS-Berechtigungen](https://www.shotomatic.com/de/guide/get-started/macos-permissions).

## Shotomatic zu Gemini CLI hinzufügen

Füge dies in `~/.gemini/settings.json` ein (oder in `.gemini/settings.json` in einem Projekt):

```json
{
  "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](https://www.shotomatic.com/de/guide/ai-agents/approvals-and-confirmations).

## 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 `npx` oder Node nicht.** Siehe [die Fehlerliste für alle Clients](https://www.shotomatic.com/de/guide/ai-agents/other-agents#fehlerbehebung).

Probier als Nächstes eine Anfrage aus [Was Agenten tun können](https://www.shotomatic.com/de/guide/ai-agents/what-agents-can-do) oder sieh dir alle Werkzeuge in der [Werkzeugreferenz](https://www.shotomatic.com/de/guide/ai-agents/tools) an.

## Auf dieser Seite

1.  [Bevor du anfängst](#bevor-du-anfängst)
2.  [Shotomatic zu Gemini CLI hinzufügen](#shotomatic-zu-gemini-cli-hinzufügen)
3.  [Einmal zulassen](#einmal-zulassen)
4.  [Prüfen, ob es funktioniert](#prüfen-ob-es-funktioniert)
5.  [Wenn das Werkzeug fehlt](#wenn-das-werkzeug-fehlt)

## Über diese Fassung

Diese Markdown-Seite wird aus der öffentlich erreichbaren, serverseitig gerenderten Shotomatic-Seite erzeugt. Interaktive Bedienelemente und die Seitennavigation sind nicht enthalten. Verwende zum Zitieren oder Teilen die kanonische Seite.
