Einen einfachen MCP-Server mit Lesezugriff für Ihren Shop bauen

Für einen einfachen MCP-Server wählen Sie zwei oder drei lesende Fragen, verpacken sie als Tools mit typisierten Eingaben, verbinden sie über einen eingeschränkten Schlüssel mit der API Ihres Shops und testen auf Staging. Die erste Version darf klein sein. Dieser Artikel zeigt die Schritte und eine kurze Pseudocode-Skizze, keinen Produktionscode.

Bevor Sie starten

Sie brauchen drei Dinge:

• Einen Shop mit API. WooCommerce und Shopify bieten beide APIs. Die genauen Aufrufe finden Sie in der aktuellen Dokumentation Ihrer Plattform.
• Ein MCP-SDK. Anthropic und die Community pflegen offizielle SDKs für mehrere Sprachen, darunter TypeScript und Python. Die aktuelle Liste steht in der offiziellen MCP-Dokumentation.
• Eine Staging-Kopie Ihres Shops. Testen Sie nicht an Live-Daten.

Schritt 1: Den Umfang eng halten

Schreiben Sie auf, was der Server beantworten soll. Halten Sie die Liste kurz. Für eine erste Version reichen diese drei Punkte:

• Produkte per Text suchen.
• Ein Produkt per SKU abrufen.
• Den Status einer Bestellung per Bestellnummer abrufen.

Alles andere kann warten. Eine kleine Tool-Liste ist leichter abzusichern, und das KI-Modell nutzt sie leichter richtig.

Schritt 2: Einen eingeschränkten API-Zugang anlegen

Verwenden Sie nicht Ihren Admin-Login. Legen Sie einen eigenen Zugang für den Server an.

• Geben Sie ihm nur Leserechte für Produkte und Bestellungen.
• Geben Sie keinen Zugriff auf Kunden, Einstellungen oder Zahlungen, solange kein Tool ihn braucht.
• Speichern Sie den Schlüssel in einer Umgebungsvariable oder einem Secrets-Manager, nicht im Code.
• Sorgen Sie dafür, dass er sich leicht widerrufen lässt.

Wenn Ihre Plattform einen Schlüssel nicht auf Lesen beschränken kann, setzen Sie eine dünne Schicht davor. Diese Schicht lässt nur GET-Anfragen durch.

Schritt 3: Jedes Tool definieren

Ein Tool braucht einen Namen, eine kurze Beschreibung und ein Eingabeschema. Das KI-Modell liest die Beschreibung, um zu entscheiden, wann es das Tool aufruft. Schreiben Sie die Beschreibungen in einfachen Worten.

Regeln für gutes Tool-Design:

• Ein Tool, eine Aufgabe.
• Benennen Sie Tools nach dem, was sie tun, etwa get_order_status.
• Prüfen Sie jede Eingabe. Lehnen Sie alles außerhalb des Schemas ab.
• Liefern Sie nur die Felder, die die Frage braucht.
• Begrenzen Sie die Ergebnisgröße, zum Beispiel auf höchstens 20 Produkte pro Suche.

Schritt 4: Die Handler schreiben

Ein Handler erhält geprüfte Eingaben, ruft die Shop-API auf und gibt ein gekürztes Ergebnis zurück. Hier eine Pseudocode-Skizze. Sie ist an keine Sprache und kein SDK gebunden.

server = new McpServer(name = "my-store", version = "0.1.0")

tool "search_products":
  description: "Search products by text. Returns up to 20 results."
  input:  query (string, 1 to 100 chars)
          limit (integer, 1 to 20, default 10)
  run:
    validate(input)
    rows = shopApi.get("/products", search = query, per_page = limit)
    return rows.map(p => id, sku, title, price, in_stock)

tool "get_order_status":
  description: "Get status and shipping state of one order."
  input:  order_number (string, matches digits only)
  run:
    validate(input)
    order = shopApi.get("/orders", number = order_number)
    if not order: return error("Order not found")
    return status, created_at, shipped_at, item_count, total
    // No name, no address, no email.

start server on stdio

Beachten Sie, was die Skizze weglässt. Das Bestell-Tool liefert weder Namen noch Anschrift noch E-Mail-Adresse. Das ist eine bewusste Entscheidung, kein Zufall.

Schritt 5: Den Transport wählen

MCP legt fest, wie Client und Server miteinander sprechen. Zwei gängige Optionen:

• stdio. Die KI-App startet Ihren Server als lokalen Prozess. Das passt für Werkzeuge auf Ihrem eigenen Rechner.
• HTTP-basierter Transport. Der Server läuft als Webdienst, den mehrere Nutzer erreichen. Er braucht saubere Authentifizierung, etwa OAuth. Lesen Sie den Abschnitt zur Autorisierung in der MCP-Spezifikation, bevor Sie das bauen.

Für den ersten Test ist ein lokaler stdio-Server einfacher. Wechseln Sie zu einem gehosteten Server erst bei klarem Bedarf.

Schritt 6: Mit einem Client testen

Testen Sie den Server, bevor Sie ihn in einen echten Ablauf einbinden.

1. Listen Sie Ihre Tools mit einem MCP-Inspector oder einem vertrauenswürdigen Client auf.
2. Rufen Sie jedes Tool von Hand mit normalen Eingaben auf.
3. Rufen Sie jedes Tool mit fehlerhaften Eingaben auf, etwa leeren Texten, sehr langen Texten und Sonderzeichen. Der Server sollte sie sauber ablehnen.
4. Stellen Sie einer KI-App einige einfache Fragen. Prüfen Sie, ob sie das richtige Tool wählt.
5. Vergleichen Sie die Ergebnisse mit dem, was der Shop-Admin anzeigt.

Führen Sie all das gegen Staging aus.

Schritt 7: Protokollierung ergänzen

Protokollieren Sie jeden Tool-Aufruf mit Zeitstempel, Tool-Name, Eingabe und Ergebnisgröße. Schreiben Sie keine Geheimnisse ins Protokoll. Denken Sie auch an personenbezogene Daten in Logs. Prüfen Sie die Protokolle nach der ersten Woche. Sie zeigen, was die KI abfragt und wo sie unsicher ist.

Schritt 8: Den nächsten Schritt planen

Wenn der lesende Server stabil läuft, können Sie über mehr entscheiden. Lesen Sie vor einem schreibenden Tool die Sicherheits-Checkliste und planen Sie die menschliche Freigabe. Ein schreibendes Tool wie eine Erstattung braucht Grenzen, Freigabe und ein Prüfprotokoll.

Eine letzte Checkliste

• Der Umfang umfasst zwei oder drei lesende Tools.
• Der API-Schlüssel ist eigens angelegt und nur lesend.
• Eingaben werden geprüft.
• Ergebnisse sind gekürzt und begrenzt.
• Personenbezogene Daten werden nur geliefert, wenn eine Aufgabe sie braucht.
• Jeder Aufruf wird protokolliert.
• Zuerst auf Staging getestet.

Häufig gestellte Fragen

Welche Programmiersprache soll ich nutzen?

Nehmen Sie die Sprache, die Ihr Team schon kennt, sofern es dafür ein MCP-SDK gibt. TypeScript und Python sind gängige Wahlen. Die Sprache zählt weniger als das Tool-Design.

Muss ich den Server öffentlich hosten?

Nein. Ein lokaler Server mit stdio genügt für eine Person an einem Rechner. Hosten Sie ihn als Webdienst nur, wenn mehrere Personen oder entfernte KI-Apps ihn brauchen. Ein gehosteter Server braucht Authentifizierung und sorgfältigere Absicherung.

Darf der Server in meinen Shop schreiben?

Er kann, aber starten Sie lesend. Fügen Sie schreibende Tools später einzeln hinzu, mit engem Umfang, Grenzen und menschlicher Freigabe für wichtige Aktionen.

Wie lange dauert eine erste Version?

Das hängt von Ihrer Plattform und Erfahrung ab. Ein kleiner Server mit wenigen lesenden Tools ist meist ein überschaubares Projekt. Tests und Sicherheitsprüfung brauchen oft mehr Zeit als der Code.