KI-Agent per MCP verbinden

Mit dem MCP-Server (Model Context Protocol) kann ein KI-Agent wie Claude direkt mit Ihrem Shop kommunizieren: Produkte anlegen, Kategorien strukturieren, SEO konfigurieren und Seiten erstellen — alles per natürlichsprachlichem Befehl, ohne den Admin-Bereich zu öffnen.

Schritt 1: API-Schlüssel erstellen

Jede Agenten-Verbindung benötigt einen eigenen API-Schlüssel.

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 Agent – Shop-Einrichtung".
Wählen Sie die Berechtigungsstufe (siehe unten).
Klicken Sie auf Erstellen — der vollständige Schlüssel wird nur einmal angezeigt. Kopieren Sie ihn sofort und speichern Sie ihn sicher.

Berechtigungsstufen

Stufe	Lesen	Schreiben	Empfehlung
`read`	Ja	Nein	Analysen, Berichte, Übersichten
`write`	Nein	Ja	Nur für automatisierte Schreibvorgänge ohne Lesebedarf
`read_write`	Ja	Ja	Shop-Einrichtung, Produktpflege, KI-Optimierung

Für die vollständige Shop-Einrichtung durch einen Agenten ist read_write erforderlich.

Sicherheitshinweis: Speichern Sie Schlüssel niemals in öffentlichem Code oder einem geteilten Repository. Löschen Sie Schlüssel sofort, wenn sie nicht mehr benötigt werden.

Schritt 2: MCP-Server verbinden

HTTP-Verbindung (empfohlen)

Der MCP-Server ist über eine einfache HTTPS-URL erreichbar. Diese Methode funktioniert von jedem Rechner aus — benötigt keinen Serverzugriff und keine lokale Shop-Installation.

Fügen Sie den Server in Ihrer Claude Code Konfiguration ein — entweder über claude mcp add oder direkt in .claude/mcp_servers.json:

{
  "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 öffentliche Domain Ihres Shops
Ihr-API-Schlüssel — der in Schritt 1 erstellte API-Schlüssel

Nach dem Neustart von Claude Code sind alle Tools in der Konversation verfügbar. Prüfen Sie die Verbindung mit:

„Rufe get_store_summary auf und zeige mir den Shop-Status."

Andere MCP-Clients

Der Server implementiert das standardisierte MCP-Protokoll (Streamable HTTP) und ist mit jedem MCP-kompatiblen Client nutzbar, der HTTP-Transporte unterstützt. Übergeben Sie den API-Schlüssel als Authorization: Bearer-Header.

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.

{
  "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.

Schritt 3: Erste Tool-Aufrufe

Nach der Verbindung können Sie sofort Daten abfragen. Beginnen Sie mit schreibgeschützten Aufrufen, um die Verbindung zu testen:

Shop-Übersicht:

„Zeige mir den aktuellen Shop-Status: offene Bestellungen, niedrige Lagerbestände und SEO-Score."

Produkte anzeigen:

„Liste alle Produkte auf, die noch keine Meta-Beschreibung haben."

Kategoriebaum:

„Zeige mir die vollständige Kategoriestruktur mit Produktzahlen."

Das dry_run-Muster für sichere Erkundung

Alle Schreib-Tools unterstützen den Parameter dry_run: true. Damit sieht der Agent, was gespeichert würde — ohne tatsächlich zu schreiben. Nutzen Sie dieses Muster, um Änderungen vorab zu prüfen.

Beispiel:

„Erstelle einen Entwurf für das Produkt ‚Zirbenbett 180×200' mit Preis 2.490 €. Zeige mir eine Vorschau mit dry_run, bevor du speicherst."

Gute Praxis für Agenten-Workflows:

Tool mit dry_run: true aufrufen → Vorschau anzeigen lassen
Ergebnis prüfen und bestätigen
Tool erneut ohne dry_run aufrufen → Daten werden gespeichert

Verfügbare Tool-Gruppen

Gruppe	Beispiel-Tools	Beschreibung
Medien	`upload_media`, `list_media`	Bilder hochladen und verwalten
Produkte	`create_product`, `assign_product_images`	Produkte anlegen und pflegen
Kategorien	`create_category`, `reorder_categories`	Kategoriebaum aufbauen
SEO	`update_seo_settings`, `run_seo_audit`	Meta-Tags und Weiterleitungen
Einstellungen	`get_store_settings`, `update_payment_method`	Shop-Konfiguration
Versand	`create_shipping_zone`, `create_shipping_method`	Versandzonen einrichten
Seiten	`create_page`, `update_page`	Inhaltsseiten verwalten
Kunden	`create_customer`, `add_customer_address`	Kundenkonten anlegen
Übersetzungen	`upsert_translation`, `get_translation_coverage`	Mehrsprachigkeit
Blog	`create_blog_post`, `update_blog_post`	Blog-Beiträge
Bestellungen	`list_orders`, `update_order_status`	Bestellverwaltung
Import	`analyze_woocommerce_import`, `import_woocommerce`	CSV-Datenimport

Die vollständige Referenz aller Tools finden Sie unter MCP-Tools Referenz.

Nächste Schritte

MCP-Tools Referenz — Alle ~120 Tools mit Parametern im Überblick
Shop per KI einrichten — Schritt-für-Schritt-Workflow für die vollständige Shop-Einrichtung
MCP-Server & API-Schlüssel — API-Schlüssel-Verwaltung und Sicherheit