> For the complete documentation index, see [llms.txt](https://docs.codegiganten.de/plugin-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.codegiganten.de/plugin-documentation/apps/marketing-aktionen-banner-popups-and-listing-storer/ki-und-mcp.md).

# KI und MCP

Aktionen per KI anlegen – mit Shopware Copilot, Claude, ChatGPT und anderen MCP-Clients

Du kannst Marketing-Aktionen auch von einer KI einrichten lassen, zum Beispiel so:

> „Stell mir eine Black-Friday-Aktion ein: Countdown-Banner mit dem Code BF30, dazu ein Newsletter-Popup und ein Störer in der Kategorie Sale.“

Die KI schreibt die Texte passend zur Aktion, legt alles an und zeigt dir vorher, was sie ändern würde. Möglich macht das der MCP-Server, den Shopware selbst mitbringt. Das Plugin stellt dort eigene Werkzeuge bereit.

### Voraussetzungen

* Eine Shopware-Version mit MCP-Server. Das Plugin erkennt selbst, ob er vorhanden ist. In älteren Versionen bleibt die Funktion einfach aus, alles andere funktioniert normal.
* Ein KI-Client mit MCP-Unterstützung, zum Beispiel Shopware Copilot, Claude oder ChatGPT.
* Ein Zugang zur Admin API, also eine Integration oder ein Benutzerschlüssel, mit den Rechten für Marketing-Aktionen.

{% hint style="info" %}
Mit dem Shopware Copilot läuft die KI über Shopware selbst. Du brauchst dann keinen eigenen KI-Zugang, es gelten die Anfragen aus deinem Shopware-Konto.
{% endhint %}

### Verbinden

Der MCP-Server deines Shops liegt unter `https://dein-shop.de/api/_mcp`. Damit der KI-Client die Werkzeuge des Plugins sofort sieht, hängst du die Werkzeuggruppe an:

```
https://dein-shop.de/api/_mcp?toolsets=cogi-marketing
```

Den Access Key und den Secret Access Key deiner Integration gibst du dem Client als Header `sw-access-key` und `sw-secret-access-key` mit.

### Was die KI kann

| Werkzeug                           | Was es tut                                                 |
| ---------------------------------- | ---------------------------------------------------------- |
| `cogi-marketing-actions-list`      | Aktionen auflisten, auf Wunsch nur die laufenden           |
| `cogi-marketing-action-get`        | Eine Aktion mit Banner, Popup und Störer lesen             |
| `cogi-marketing-action-upsert`     | Eine Aktion anlegen oder ändern                            |
| `cogi-marketing-action-set-active` | Banner, Popup oder Störer einer Aktion an- und ausschalten |
| `cogi-marketing-fillers-list`      | Auffüll-Störer auflisten                                   |
| `cogi-marketing-filler-upsert`     | Einen Auffüll-Störer anlegen oder ändern                   |

Dazu kommt der Leitfaden `cogi-marketing-guide`. Er erklärt der KI, wie das Plugin funktioniert und wie gute Banner, Popups und Störer aussehen.

### Sicherheitsnetz

* **Erst Vorschau, dann speichern.** Jedes schreibende Werkzeug läuft zuerst als Probelauf und zeigt das Ergebnis, ohne etwas zu speichern. Erst danach speichert die KI wirklich.
* **Neue Aktionen sind Entwürfe.** Banner, Popup und Störer bleiben aus, bis du sie freigibst.
* **Es gelten die Shopware-Rechte.** Die KI kann nur, was der verwendete Zugang darf. Freies HTML in Popups braucht auch hier die eigene Berechtigung.

### Bilder

Die KI kann Bilder für Störer, Auffüll-Störer und Popup-Hintergründe mitliefern: als Link, etwa von einem Bildgenerator, oder als Bilddatei (JPG, PNG oder WebP bis 2 MB). Das Bild landet in der Medienverwaltung, sobald die KI wirklich speichert.

| Platz                          | Empfohlenes Format                                                       |
| ------------------------------ | ------------------------------------------------------------------------ |
| Listing-Störer, Auffüll-Störer | Hochformat wie eine Produktkarte samt Text, oft etwa 3:5 (600 × 1000 px) |
| Popup, Inhalt über dem Bild    | Querformat, etwa 1200 × 800 px, ruhiges Motiv                            |
| Popup, Bild links              | Hochformat, etwa 600 × 800 px                                            |

{% hint style="warning" %}
Die Werkzeuge des Plugins erzeugen selbst keine Bilder. Ob deine KI Bilder generieren kann, hängt vom Client ab. Ein Bild hochzuladen braucht das Shopware-Recht zum Anlegen von Medien. Bildadressen im eigenen Netzwerk lehnt Shopware ab.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.codegiganten.de/plugin-documentation/apps/marketing-aktionen-banner-popups-and-listing-storer/ki-und-mcp.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
