# OpenCode | Benutzerhandbuch | Shotomatic

> Füge Shotomatic als lokalen MCP-Server zu OpenCode 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/opencode](https://www.shotomatic.com/de/guide/ai-agents/clients/opencode)
- Markdown-Seite: [https://www.shotomatic.com/de/guide/ai-agents/clients/opencode.md](https://www.shotomatic.com/de/guide/ai-agents/clients/opencode.md)

Benutzerhandbuch durchsuchen

Auf dieser Seite

1.  [Bevor du anfängst](#bevor-du-anfängst)
2.  [Shotomatic zu OpenCode hinzufügen](#shotomatic-zu-opencode-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)

OpenCode kann Shotomatic über den lokalen MCP-Server von Shotomatic nutzen. Diese Schritte folgen der Dokumentation von OpenCode ([OpenCode MCP servers](https://opencode.ai/docs/mcp-servers/)). Shotomatic ist mit Claude Code und Codex getestet, nicht mit OpenCode. Passt ein Menü oder eine Datei nicht mehr, schau in die Dokumentation von OpenCode.

## 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 OpenCode hinzufügen

Führe dies in dem Projekt aus, das den Server verwenden soll, und ergänze `--global`, damit er überall verfügbar ist:

```sh
opencode mcp add shotomatic -- npx -y shotomatic mcp
```

Um die Konfiguration nach der aktuellen Dokumentation (V2) von Hand zu bearbeiten, füge dies in `opencode.jsonc` ein. Das V1-Format sieht anders aus. Nimm den CLI-Befehl, wenn du nicht sicher bist, welche Version du hast.

```json
{
  "mcp": {
    "servers": {
      "shotomatic": {
        "type": "local",
        "command": ["npx", "-y", "shotomatic", "mcp"]
      }
    }
  }
}
```

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 OpenCode 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 `opencode mcp list` aus. 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.

Shotomatic liefert Vorschauen als Bilder in Werkzeugergebnissen. Die Dokumentation von OpenCode sagt nicht, ob diese Bilder beim Modell ankommen, der Agent erhält also womöglich nur Text.

## Wenn das Werkzeug fehlt

-   **Der Server fehlt in einem anderen Projekt.** Füge ihn mit `--global` erneut hinzu.
-   **„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 OpenCode hinzufügen](#shotomatic-zu-opencode-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.
