MCP-Server & API-Schlüssel

Der Shop-MCP-Server stellt eine strukturierte Schnittstelle für KI-Assistenten wie Claude bereit. Über diese Verbindung können Sie per natürlichsprachlicher Anfrage Produkte suchen und bearbeiten, Bestellungen abrufen, Blog-Beiträge erstellen und vieles mehr — ohne den Admin-Bereich zu öffnen.

Was ist der MCP-Server?

MCP (Model Context Protocol) ist ein offenes Protokoll, über das KI-Modelle direkt mit externen Diensten kommunizieren. Der Shop-MCP-Server übersetzt diese Anfragen in sichere Datenbankzugriffe und gibt strukturierte Antworten zurück.

Typische Anwendungsfälle:

„Zeige mir alle Produkte ohne Meta-Beschreibung"
„Setze den Preis aller Produkte in Kategorie 5 auf 299 €"
„Erstelle einen Blog-Beitrag über die neue Holzpflegeserie"
„Welche Bestellungen sind heute eingegangen?"

Voraussetzungen

Zugang zu Claude Code (CLI) oder einem anderen MCP-fähigen Client mit HTTP-Unterstützung
Ein API-Schlüssel mit den passenden Berechtigungen (siehe unten)
Die öffentliche Domain Ihres Shops (für die HTTP-Verbindung)

API-Schlüssel erstellen

Melden Sie sich im Admin-Bereich an.
Navigieren Sie zu Einstellungen → API-Schlüssel.
Klicken Sie auf Neuen Schlüssel erstellen.
Geben Sie einen beschreibenden Namen ein (z. B. „Claude Code – Produktpflege").
Wählen Sie die Berechtigungsstufe (siehe unten).
Klicken Sie auf Erstellen und kopieren Sie den angezeigten Schlüssel sofort — er wird nur einmal angezeigt.

Berechtigungsstufen

Stufe	Lesen	Schreiben	Empfehlung
read	Ja	Nein	Analyse, Berichte, Übersichten
write	Nein	Ja	Nur für automatisierte Schreibvorgänge
read_write	Ja	Ja	Produktpflege, SEO-Optimierung

Sicherheitshinweis: Erstellen Sie für jede Anwendung einen eigenen Schlüssel. Speichern Sie Schlüssel niemals in öffentlichem Code. Löschen Sie Schlüssel sofort, wenn sie nicht mehr benötigt werden.

Claude Code verbinden

Primäre Methode: HTTP-Verbindung (empfohlen)

Der einfachste Weg ist die direkte HTTP-Verbindung über die öffentliche Shop-URL. Diese Methode funktioniert von jedem Rechner aus — benötigt keinen Serverzugriff und keine lokale Installation des Shop-Quellcodes.

Fügen Sie den MCP-Server in Ihre Claude Code Konfiguration ein (.claude/mcp_servers.json oder über claude mcp add):

{
  "mcpServers": {
    "mein-shop": {
      "type": "url",
      "url": "https://ihr-shop.de/api2/mcp",
      "headers": {
        "Authorization": "Bearer Ihr-API-Schlüssel"
      }
    }
  }
}

Ersetzen Sie:

https://ihr-shop.de — die Domain Ihres Shops
Ihr-API-Schlüssel — der soeben erstellte API-Schlüssel

Nach dem Neustart von Claude Code stehen alle Tools direkt in der Konversation zur Verfügung.

Entwickler / Self-Hosted (Alternative)

Nur erforderlich wenn: Sie den Shop-Quellcode lokal vorliegen haben und Claude Code auf demselben Rechner läuft wie das Shop-Verzeichnis. Für den normalen Einsatz nutzen Sie die HTTP-Verbindung oben.

Fügen Sie den MCP-Server in Ihre Claude Code Konfiguration ein:

{
  "mcpServers": {
    "mein-shop": {
      "command": "tsx",
      "args": ["/absoluter/pfad/zum/shop/scripts/start-mcp-server.ts", "TENANT_ID"],
      "env": {
        "MCP_API_KEY": "Ihr-API-Schlüssel"
      }
    }
  }
}

Ersetzen Sie:

/absoluter/pfad/zum/shop — absoluter Pfad zum Shop-Verzeichnis auf Ihrem Rechner
TENANT_ID — Ihre Tenant-ID (z. B. bodenseemoebel oder bodensee-zirbenbett)

Die Tenant-ID finden Sie im Admin-Bereich unter Einstellungen → Shop-Informationen.

Staging-Datenbank per MCP ansprechen {#staging-datenbank-per-mcp-ansprechen}

Wenn Sie eine Staging-Umgebung eingerichtet haben, können Sie MCP-Tools gezielt gegen die Staging-Datenbank ausführen — ohne die Produktionsdaten zu verändern. So kann ein KI-Agent Änderungen vorbereiten, die Sie anschließend manuell prüfen und per Klick veröffentlichen.

Staging-API-Schlüssel einrichten

Den Staging-API-Schlüssel finden Sie unter Admin → Einstellungen → Staging → Staging-API-Schlüssel. Klicken Sie auf Anzeigen und dann auf Kopieren.

Konfigurieren Sie einen zweiten MCP-Server-Eintrag mit diesem Schlüssel:

{
  "mcpServers": {
    "mein-shop": {
      "type": "url",
      "url": "https://ihr-shop.de/api2/mcp",
      "headers": {
        "Authorization": "Bearer Ihr-normaler-API-Schlüssel"
      }
    },
    "mein-shop-staging": {
      "type": "url",
      "url": "https://ihr-shop.de/api2/mcp",
      "headers": {
        "Authorization": "Bearer Ihr-Staging-API-Schlüssel"
      }
    }
  }
}

Verwenden Sie mein-shop-staging für alle Änderungen, die zuerst in Staging landen sollen, und mein-shop für direkte Produktionszugriffe.

isStaging in Tool-Antworten

Wenn ein Tool-Aufruf über den Staging-Schlüssel erfolgt, enthalten alle Antworten das Feld:

{
  "isStaging": true,
  ...
}

Dieses Feld signalisiert dem Agenten, dass er mit der Staging-Datenbank kommuniziert — nicht mit der Produktion. Ein gut konfigurierter Agent sollte dieses Feld prüfen und den Nutzer darauf hinweisen, bevor er Änderungen vornimmt.

Empfohlener Workflow mit KI-Agent

Agent nutzt mein-shop-staging → macht Änderungen in Staging
Sie öffnen Admin → Einstellungen → Staging → Änderungen überprüfen und prüfen den Diff
Bei Zufriedenheit: Zur Produktion veröffentlichen — alles geht live
Optional: Staging verwerfen oder für weitere Änderungen behalten

Der Staging-API-Schlüssel bleibt auch nach dem Verwerfen und Neuerstellen von Staging erhalten — Sie müssen die MCP-Konfiguration nicht ändern.

Verfügbare Tools nach Bereich

Produkte

Tool	Beschreibung	Berechtigung
`list_products`	Produkte auflisten und filtern	read
`get_product`	Vollständige Produktdaten abrufen	read
`update_product`	Einzelnes Produkt aktualisieren	write
`bulk_update_products`	Feld bei vielen Produkten auf einmal setzen	write
`generate_product_description`	Textbaustein-Template rendern	read / write
`list_textblocks`	Verfügbare Textbausteine anzeigen	read
`get_available_placeholders`	Template-Platzhalter auflisten	read

Kategorien

Tool	Beschreibung	Berechtigung
`list_categories`	Kategoriebaum mit Produktzahlen	read
`get_category`	Kategorie-Detail inkl. Pfad und SEO	read
`update_category`	SEO-Metadaten einer Kategorie bearbeiten	write

Bestellungen

Tool	Beschreibung	Berechtigung
`list_orders`	Bestellungen auflisten und filtern	read
`get_order`	Vollständige Bestellung abrufen	read
`update_order_status`	Bestellstatus ändern	write
`bulk_update_order_status`	Mehrere Bestellungen auf einmal aktualisieren	write

Lagerbestand

Tool	Beschreibung	Berechtigung
`get_inventory`	Lagerbestand pro Lager abrufen	read
`list_low_stock`	Produkte unter Mindestbestand anzeigen	read
`adjust_stock`	Lagerbestand korrigieren	write

KI-Optimierung

Tool	Beschreibung	Berechtigung
`optimize_product_for_ai_shopping`	KI-Optimierungsbericht erstellen	read / write
`get_image_alt_suggestions`	Alt-Text-Vorschläge generieren	read
`apply_image_alt_suggestions`	Alt-Text-Vorschläge speichern	write

Kunden

Tool	Beschreibung	Berechtigung
`list_customers`	Kundenliste mit Suchfilter	read
`get_customer`	Vollständiges Kundenprofil abrufen	read

Blog

Tool	Beschreibung	Berechtigung
`list_blog_posts`	Blog-Beiträge auflisten	read
`get_blog_post`	Beitrag vollständig abrufen	read
`create_blog_post`	Neuen Beitrag anlegen	write
`update_blog_post`	Beitrag bearbeiten oder veröffentlichen	write

Shop-Übersicht

Tool	Beschreibung	Berechtigung
`get_store_summary`	Gesundheitsreport des Shops abrufen	read

Nächste Schritte

Produkte per MCP verwalten — Produkte suchen, anzeigen, bearbeiten und in Bulk aktualisieren
KI-Optimierung — SEO- und Beschreibungsqualität automatisch verbessern
Blog-Beiträge per MCP — Beiträge ohne Admin-Bereich erstellen
Shop-Übersicht — Bestandswarnungen und SEO-Score interpretieren