- MCP (Model Context Protocol) ist ein offener Standard, mit dem KI-Apps Tools anderer Dienste aufrufen können, sodass ein Assistent aus deinen echten Shop-Daten antworten kann.
- ROASaurus Ask AI und der ROASaurus-MCP-Server teilen sich 24 schreibgeschützte Tools, von Gewinn, Attribution und Kundenwert bis zu Kosten, Leads, Abonnements, dem Marketing-Mix-Modell und Anomalien.
- Eine KI-App verbindet sich per OAuth-Anmeldung bei ROASaurus oder mit einem API-Schlüssel in einem Authorization-Header.
- Ein benannter Schlüssel nur mit dem Scope mcp kann nur lesen; der Orders-API-Schlüssel kann auch Bestellungen senden. Halte deshalb jeden Schlüssel geheim und widerrufe ihn, falls er in falsche Hände gerät.
- Die Zeiträume sind festgelegt (heute, gestern oder die letzten 7, 14, 30 oder 90 Tage), und Ask AI erlaubt standardmäßig 40 Fragen pro Nutzer und Tag.
Ein Shopify-MCP-Server verbindet deine Shop-Daten über das Model Context Protocol (MCP) mit einem KI-Assistenten. Du stellst eine Frage in normaler Sprache, etwa „Welche Kampagne hat letzten Monat den meisten Gewinn gebracht?“, und der Assistent antwortet aus den echten Zahlen deines Shops statt aus dem Gedächtnis. ROASaurus betreibt einen MCP-Server mit 24 schreibgeschützten Analyse-Tools, und dieselben Tools treiben Ask AI im Dashboard an.
Dieser Leitfaden erklärt, was MCP ist, warum es hilft, Analysefragen auf diese Weise zu stellen, wie Ask AI und der MCP-Server funktionieren, wie du einen Client verbindest, welche Fragen gut funktionieren und welche Datenschutz-, Sicherheits- und Grenzaspekte du kennen solltest.
Was ist MCP?
MCP ist ein Open-Source-Standard, um KI-Anwendungen mit externen Systemen zu verbinden. Eine KI-App wie Claude ist der Client. Ein Dienst, der Daten oder Aktionen anbietet, ist der Server. Der Server beschreibt seine Tools: Jedes Tool hat einen Namen, eine Beschreibung und ein Schema für seine Eingaben.
Wenn du eine Frage stellst, fragt der Client den Server, welche Tools es gibt (tools/list). Das Modell wählt das passende Tool aus, und der Client ruft es auf (tools/call). Das Ergebnis geht zurück an das Modell, das die Antwort schreibt. Du musst die Tool-Namen nicht kennen. Du stellst nur die Frage.
Auch Shopify betreibt MCP-Server. Sie konzentrieren sich auf Shopping-Agenten und Entwickler: Produktsuche, Warenkörbe, Checkout, Kundenkonten und Entwicklerdokumentation. Ein MCP-Server für Analysen beantwortet eine andere Art von Fragen: Gewinn nach Werbekosten, Attribution und Kundenwert, berechnet aus deinen Bestellungen, deinen Kosten und den Ausgaben in deinen Werbekonten.
Warum deine Shop-Daten in einem KI-Assistenten abfragen?
Die meisten Fragen zu einem Shop brauchen Zahlen aus mehreren Berichten. „Hat Meta letzten Monat Geld verdient?“ braucht Umsatz, Produktkosten, Versand, Gebühren und Werbeausgaben an einer Stelle. In einem Dashboard öffnest du den richtigen Bericht, stellst den Zeitraum ein und rechnest selbst. In einem KI-Assistenten, der mit deinen Daten verbunden ist, stellst du die Frage und bekommst die Antwort samt den Zahlen dahinter.
- Normale Sprache. Keine Filter, Berichtsgeneratoren oder Tabellenformeln.
- Folgefragen. Frage „Und bei TikTok?“ oder „Welche Kampagne hat das verursacht?“, ohne von vorn zu beginnen.
- Mehrere Berichte in einer Antwort. Gewinn, Attribution und Kundenwert lassen sich in einer Antwort kombinieren.
- Deine eigene Sprache. Ask AI antwortet in der Sprache, in der du schreibst.
- Neben deiner übrigen Arbeit. Über MCP sind die Zahlen deines Shops in der KI-App verfügbar, in der du ohnehin Updates oder Pläne schreibst.
Die Antwort ist nur so vollständig wie die Daten dahinter. Richte zuerst Server-Side-Tracking, deine Werbekonten und deine Produktkosten ein, damit die Tools Bestellungen, Ausgaben und Margen zum Arbeiten haben.
Wie funktionieren Ask AI und der ROASaurus-MCP-Server?
Ask AI ist eine Chat-Seite im ROASaurus-Dashboard. Sie läuft auf Claude, dem Modell von Anthropic. Der MCP-Server bietet dieselben 24 Tools einem KI-Client deiner Wahl an. In beiden Fällen lesen die Tools deine ROASaurus-Berichte und geben die Zahlen als JSON zurück. Das Modell schreibt die Antwort aus diesen Ergebnissen.
Jedes Analyse-Tool liest nur. Kein Tool kann deinen Shop, deine Kampagnen, deine Kosten oder deine Einstellungen ändern. Der MCP-Server kennzeichnet jedes davon als schreibgeschützt und weist den Client an, nur aus Tool-Ergebnissen zu antworten. Ein Schlüssel mit dem Scope actions:write erhält außerdem propose_action, das eine vorgeschlagene Anzeigenänderung in die Actions-Inbox legt; nichts ändert sich, bevor ein Inhaber oder Admin sie freigibt. Ask AI im Dashboard hat dieses Tool ebenfalls.
In Ask AI kann eine Frage bis zu 8 Runden von Tool-Aufrufen verbrauchen. Braucht eine Frage mehr, bittet dich der Assistent, genauer zu werden. Ask AI speichert deine Unterhaltung pro Nutzer und Shop und verwendet die letzten 12 Nachrichten als Kontext für eine Folgefrage. Du kannst die Unterhaltung jederzeit löschen.
Welche Fragen kannst du stellen?
Gute Fragen nennen eine Kennzahl und einen der unterstützten Zeiträume. Die Tabelle zeigt Beispielfragen, das Tool, das jede beantwortet, und worauf die Antwort basiert.
| Frage | Tool | Was die Antwort zeigt |
|---|---|---|
| Wie haben sich die letzten 7 Tage im Vergleich zu den 7 Tagen davor entwickelt? | profit_summary | Umsatz, Bestellungen, Werbeausgaben, MER, POAS und Gewinn, im Vergleich zum vorherigen Zeitraum gleicher Länge |
| Welche Kampagne hatte in den letzten 30 Tagen den besten POAS? | campaign_profit | Pro Kampagne: zugeschriebener Umsatz, Bruttogewinn, Werbeausgaben, Gewinn nach Werbekosten, ROAS, POAS und CAC |
| Welche Anzeigen haben einen hohen CPM und wenige Käufe? | ads_table | Ausgaben, Impressionen, Klicks, CTR und CPM neben getrackten Käufen, ROAS und CPA |
| Wie viele Monate braucht eine Kohorte, um ihren CAC wieder einzuspielen? | ltv_insights | Monatliche Kohorten, Payback-Monat des CAC und prognostizierter LTV |
| Welche Produkte bringen die meisten Wiederkäufer zurück? | products | Top-Produkte und der Anteil der Erstkäufer, die erneut bestellt haben |
| Liegen wir beim Umsatzziel dieses Monats im Plan? | goals_forecast | Ziele, bisherige Istwerte und die Prognose zum Monatsende |
| Was sollte ich diese Woche nachbestellen? | inventory | Lagerbestand, Verkaufsgeschwindigkeit, verbleibende Lagertage und Nachbestellstatus |
Hier ein durchgerechnetes Beispiel. Du fragst: „Hat Meta in den letzten 30 Tagen Geld verdient?“ Das Modell ruft campaign_profit mit dem Zeitraum 30 Tage und dem Standardmodell Last Click auf. Für einen Beispiel-Shop sieht die Meta-Zeile des Ergebnisses so aus:
| Zeile | Meta, letzte 30 Tage | So wird es berechnet |
|---|---|---|
| Zugeschriebener Umsatz | $24,000 | Umsatz der Bestellungen, die Meta-Klicks zugeschrieben werden |
| Bruttogewinn (im Ergebnis: contribution) | $13,440 | Umsatz minus Produktkosten, Versand, Zahlungsgebühren und Bearbeitung (56%) |
| Werbeausgaben | $8,000 | Aus dem Meta-Werbekonto synchronisiert |
| Gewinn nach Werbekosten | $5,440 | $13,440 − $8,000 |
| ROAS | 3.00 | $24,000 ÷ $8,000 |
| POAS | 1.68 | $13,440 ÷ $8,000 |
In Ask AI beginnt die Antwort mit „Ja“, nennt dann den Gewinn nach Werbekosten und den POAS und schlägt höchstens drei nächste Schritte vor. Wenn du eine andere Sicht möchtest, stelle eine Folgefrage wie „Und mit dem Modell Total Impact?“. Unsere Leitfäden zu POAS und Attributionsmodellen erklären diese Zahlen ausführlicher.
Wie verbindest du den ROASaurus-MCP-Server?
Der Server nutzt den Streamable-HTTP-Transport von MCP und liefert JSON-Antworten, ohne Server-Sent Events. KI-Apps wie Claude und ChatGPT melden sich per OAuth an: Du meldest dich bei ROASaurus an, wählst einen Shop und erlaubst die Verbindung. Clients, in denen du einen Request-Header setzen kannst, wie Claude Code, können stattdessen einen API-Schlüssel nutzen, wie in den Schritten unten.
- Einen API-Key erstellen
Öffne in ROASaurus Store settings › API & data und erstelle einen benannten Schlüssel mit dem Scope
mcp. Kopiere ihn: Er wird nur einmal angezeigt. Nur Inhaber und Admins können Schlüssel erstellen. - Oder den Orders-API-Schlüssel weiterverwenden
Du kannst auch den Schlüssel auf der Karte Orders API verwenden, zum Beispiel den, den das WooCommerce-Plugin nutzt. Dieser Schlüssel kann auch Bestellungen senden. Regenerate API key ersetzt ihn und trennt alles, was den alten verwendet.
- Den Store-Key notieren
Ein benannter Schlüssel kommt allein in den Header. Beim Orders-API-Schlüssel fügst du den Shop-Schlüssel hinzu: den Wert
X-Roasaurus-Keyauf derselben Karte, deren MCP-Abschnitt den vollständigen Header zeigt. - Den Server zu deinem MCP-Client hinzufügen
Gib den Endpoint und den unten gezeigten Authorization-Header ein. Der Client muss Streamable HTTP und benutzerdefinierte Request-Header unterstützen.
- Eine Testfrage stellen
Frage „Wie hoch war mein Umsatz gestern?“ und vergleiche die Zahl mit deinem Dashboard.
# Endpoint POST https://app.roasaurus.com/mcp Authorization: Bearer <named key with the mcp scope> # or, with the Orders API key Authorization: Bearer <store key>:<API key> # Claude Code claude mcp add --transport http roasaurus https://app.roasaurus.com/mcp \ --header "Authorization: Bearer <named key with the mcp scope>"
Du kannst den Store-Key auch in einem X-Roasaurus-Key-Header senden und als Bearer-Token nur den API-Schlüssel. Belasse in Claude Code den lokalen Standard-Scope. Ein Server mit Projekt-Scope wird in einer Datei .mcp.json gespeichert, die über die Versionsverwaltung geteilt wird, und damit würdest du deinen Schlüssel teilen.
Um dich stattdessen anzumelden, füge https://app.roasaurus.com/mcp in Claude oder ChatGPT als Custom Connector hinzu und melde dich an, wenn die App danach fragt. Nur Inhaber und Admins können eine Verbindung erlauben. Store settings › API & data listet jede verbundene App auf, wo du sie trennen kannst, und eine Verbindung endet auch, wenn diese Person den Workspace verlässt.
initialize · 2025-06-18Client und Server einigen sich auf die Protokollversiontools/list · 24 tools · readOnlyHint: trueDer Client erfährt, welche Tools es gibttools/call · campaign_profit · period 30Das Modell fragt 30 Tage Kampagnengewinn abresult · isError: falseJSON mit einer Zeile pro Kanal und Kampagne401 · Invalid store key or API key.Was ein falscher oder neu generierter Schlüssel zurückgibtIst es sicher? Datenschutz und Sicherheit
Da die Analyse-Tools nur lesen, kann eine KI-App über ROASaurus keine Kampagne pausieren, keine Kosten bearbeiten und keine Einstellung ändern; mit actions:write kann sie nur eine Anzeigenänderung vorschlagen, die ein Inhaber oder Admin freigeben muss. Die Tools akzeptieren außerdem nur feste Eingaben, etwa einen Zeitraum oder ein Attributionsmodell aus einer Liste. Dennoch erfordern einige Punkte Sorgfalt.
- Wohin die Daten gehen. Ask AI sendet deine Frage und aggregierte Shop-Kennzahlen an Anthropic, das Claude betreibt. Es sendet keine Kontaktdaten deiner Kunden. Über MCP gehen die Tool-Ergebnisse an den KI-Client, den du verbindest, nach dessen Bedingungen. Prüfe dessen Einstellungen zur Datenspeicherung und zum Training.
- Was die Tools zurückgeben. Summen pro Zeitraum, Kanal, Kampagne, Anzeige, Produkt, Kohorte und Segment. Sie geben keine Kundennamen, E-Mail-Adressen oder Telefonnummern zurück.
- Wer fragen kann. Jeder, der Zugriff auf die KI-App hat, in der du die Verbindung hinzufügst, kann den Shop abfragen. Füge sie deinem eigenen Konto hinzu, nicht einem gemeinsam genutzten.
- Andere Connectors. Die MCP-Spezifikation sagt, dass immer ein Mensch beteiligt sein sollte, der Tool-Aufrufe ablehnen kann, und dass Clients Tool-Annotationen als nicht vertrauenswürdig behandeln müssen, solange dem Server nicht vertraut wird. Hat deine KI-App auch Tools, die E-Mails senden oder Nachrichten posten, lass die Bestätigungsabfragen für diese Tools eingeschaltet.
Welche Grenzen gibt es?
- Feste Zeiträume. Heute, gestern oder die letzten 7, 14, 30 oder 90 Tage, in der Zeitzone des Shops. Ein benutzerdefinierter Zeitraum, etwa eine Woche im März, wird nicht unterstützt. Die Tools für Kundenwert und Kohorten nehmen keinen Zeitraum: Sie arbeiten mit deiner Bestellhistorie, mit bis zu 12 monatlichen Kohorten.
- Ein 7-Tage-Fenster für die Anzeigentabelle. Das Anzeigen-Tool nutzt ein Lookback-Fenster von 7 Tagen, unabhängig davon, welches Fenster du in den Store settings einstellst. Die Tools für Attribution und Kampagnengewinn verwenden, wie die Attributionsberichte im Dashboard, deine eigene Einstellung oder ein Lookback-Fenster, nach dem du fragst.
- Gekürzte Listen. Kampagnenlisten geben höchstens 25 Kampagnen zurück, die Anzeigentabelle die 30 Zeilen mit den höchsten Ausgaben und die Produktliste die Top 25 Produkte.
- Ein Shop pro Verbindung. Erstelle für mehrere Shops jeweils einen Schlüssel und eine Verbindung.
- Das Fragenlimit von Ask AI. Jeder Nutzer kann standardmäßig 40 Fragen pro Tag stellen, gezählt über die letzten 24 Stunden. Über MCP gelten stattdessen die eigenen Nutzungslimits deines KI-Clients.
- Antworten können falsch sein. Das Modell kann ein Ergebnis falsch lesen. Prüfe wichtige Zahlen in den Berichten, bevor du danach handelst, zum Beispiel in der Gewinnanalyse.
Quellen
- Model Context Protocol: What is the Model Context Protocol (MCP)?
- Model Context Protocol specification (2025-06-18): Tools
- Claude Code Docs: Connect Claude Code to tools via MCP
- Claude Docs: Authentication for connectors
- OpenAI: Building MCP servers for plugins and API integrations