Shopify MCP-Server

MCP-Server für die Shopify-API ermöglicht die Interaktion mit Shop-Daten über die GraphQL-API. Dieser Server bietet Tools zur Verwaltung von Produkten, Kunden, Bestellungen und mehr.

Merkmale

• Produktmanagement : Suchen und Abrufen von Produktinformationen

• Kundenverwaltung : Laden Sie Kundendaten und verwalten Sie Kunden-Tags

• Auftragsverwaltung : Erweiterte Auftragsabfrage und -filterung

• GraphQL-Integration : Direkte Integration mit der GraphQL-Admin-API von Shopify

• Umfassende Fehlerbehandlung : Klare Fehlermeldungen bei API- und Authentifizierungsproblemen

Werkzeuge

1. get-products

   • Alle Produkte abrufen oder nach Titel suchen

   • Eingänge:

     • searchTitle (optionale Zeichenfolge): Produkte nach Titel filtern

     • limit (Anzahl): Maximale Anzahl der zurückzugebenden Produkte

   • Rückgaben: Formatierte Produktdetails einschließlich Titel, Beschreibung, Griff und Varianten

2. get-products-by-collection

   • Produkte aus einer bestimmten Kollektion abrufen

   • Eingänge:

     • collectionId (Zeichenfolge): ID der Sammlung, aus der Produkte abgerufen werden sollen

     • limit (optionale Zahl, Standard: 10): Maximale Anzahl der zurückzugebenden Produkte

   • Rückgabe: Formatierte Produktdetails aus der angegebenen Sammlung

3. get-products-by-ids

   • Produkte anhand ihrer IDs abrufen

   • Eingänge:

     • productIds (Array von Zeichenfolgen): Array von abzurufenden Produkt-IDs

   • Retouren: Formatierte Produktdetails für die angegebenen Produkte

4. update-product-price

   • Aktualisieren Sie die Produktpreise für die ID

   • Eingänge:

     • productId (Zeichenfolge): ID des zu aktualisierenden Produkts

     • price (Zeichenfolge): Neuer Preis für das Produkt

   • Rückgabe: Antwort des Updates

5. get-variants-by-ids

   • Produktvarianten anhand ihrer IDs abrufen

   • Eingänge:

     • variantIds (Array von Zeichenfolgen): Array der abzurufenden Varianten-IDs

   • Retouren: Detaillierte Varianteninformationen inklusive Produktdetails

6. get-customers

   • Gewinnen Sie Shopify-Kunden mit Paginierungsunterstützung

   • Eingänge:

     • limit (optionale Zahl): Maximale Anzahl der Kunden, die zurückkehren

     • next (optionale Zeichenfolge): Cursor für die nächste Seite

   • Rückgabe: Kundendaten im JSON-Format

7. tag-customer

   • Einem Kunden Tags hinzufügen

   • Eingänge:

     • customerId (Zeichenfolge): Zu taggende Kunden-ID

     • tags (Zeichenfolgen-Array): Tags, die dem Kunden hinzugefügt werden sollen

   • Rückgabe: Erfolgs- oder Fehlermeldung

8. get-orders

   • Erhalten Sie Bestellungen mit erweiterter Filterung und Sortierung

   • Eingänge:

     • first (optionale Zahl): Limit der zurückzugebenden Bestellungen

     • after (optionale Zeichenfolge): Cursor für die nächste Seite

     • query (optionale Zeichenfolge): Filtern Sie Bestellungen mithilfe der Abfragesyntax

     • sortKey (optionale Aufzählung): Feld zum Sortieren ('PROCESSED_AT', 'TOTAL_PRICE', 'ID', 'CREATED_AT', 'UPDATED_AT', 'ORDER_NUMBER')

     • reverse (optional boolean): Sortierreihenfolge umkehren

   • Rücksendungen: Formatierte Bestelldetails

9. get-order

   • Erhalten Sie eine einzelne Bestellung nach ID

   • Eingänge:

     • orderId (Zeichenfolge): ID der abzurufenden Bestellung

   • Rücksendungen: Detaillierte Bestellinformationen

10. create-discount

• Erstellen Sie einen einfachen Rabattcode

• Eingänge:

  • title (Zeichenfolge): Titel des Rabatts

  • code (Zeichenfolge): Rabattcode, den Kunden eingeben

  • valueType (enum): Art des Rabatts ('Prozentsatz' oder 'fester Betrag')

  • value (Zahl): Rabattwert (Prozentsatz als Dezimalzahl oder Festbetrag)

  • startsAt (Zeichenfolge): Startdatum im ISO-Format

  • endsAt (optionale Zeichenfolge): Optionales Enddatum im ISO-Format

  • appliesOncePerCustomer (Boolesch): Ob der Rabatt nur einmal pro Kunde verwendet werden kann

• Retouren: Rabattdetails erstellt

11. create-draft-order

• Erstellen Sie einen Bestellentwurf

• Eingänge:

  • lineItems (Array): Array von Artikeln mit variantId und Menge

  • email (Zeichenfolge): E-Mail des Kunden

  • shippingAddress (Objekt): Details zur Lieferadresse

  • note (optionale Zeichenfolge): Optionaler Hinweis zur Bestellung

• Rücksendungen: Details zum Bestellentwurf erstellt

12. complete-draft-order

• Einen Bestellentwurf abschließen

• Eingänge:

  • draftOrderId (Zeichenfolge): ID des zu vervollständigenden Bestellentwurfs

  • variantId (Zeichenfolge): ID der Variante im Bestellentwurf

• Rücksendungen: Ausgefüllte Bestelldetails

13. get-collections

• Alle Sammlungen abrufen

• Eingänge:

  • limit (optionale Zahl, Standard: 10): Maximale Anzahl der zurückzugebenden Sammlungen

  • name (optionale Zeichenfolge): Sammlungen nach Namen filtern

• Rücksendungen: Abholdetails

14. get-shop

• Shopdetails abrufen

• Eingänge: Keine

• Rücksendungen: Grundlegende Shop-Informationen

15. get-shop-details

• Erhalten Sie erweiterte Shopdetails, einschließlich Versandländer

• Eingänge: Keine

• Retouren: Erweiterte Shop-Informationen inkl. Versandländer

16. manage-webhook

• Webhooks abonnieren, suchen oder abbestellen

• Eingänge:

  • action (Aufzählung): Auszuführende Aktion ('Abonnieren', 'Suchen', 'Abmelden')

  • callbackUrl (Zeichenfolge): Webhook-Rückruf-URL

  • topic (Aufzählung): Zu abonnierendes Webhook-Thema

  • webhookId (optionale Zeichenfolge): Webhook-ID (erforderlich zum Abbestellen)

• Gibt zurück: Webhook-Details oder Erfolgsmeldung

Aufstellen

Shopify-Zugriffstoken

Um diesen MCP-Server zu verwenden, müssen Sie in Ihrem Shopify-Shop eine benutzerdefinierte App erstellen:

1. Gehen Sie in Ihrem Shopify-Adminbereich zu Einstellungen > Apps und Vertriebskanäle

2. Klicken Sie auf „Apps entwickeln“ (möglicherweise müssen Sie zuerst die Entwicklervorschau aktivieren).

3. Klicken Sie auf App erstellen

4. Legen Sie einen Namen für Ihre App fest (z. B. „Shopify MCP Server“)

5. Klicken Sie auf „Admin-API-Bereiche konfigurieren“

6. Wählen Sie die folgenden Bereiche aus:

   • read_products , write_products

   • read_customers , write_customers

   • read_orders , write_orders

7. Klicken Sie auf Speichern

8. Klicken Sie auf App installieren

9. Klicken Sie auf Installieren, um der App Zugriff auf Ihre Shop-Daten zu gewähren

10. Nach der Installation sehen Sie Ihr Admin-API-Zugriffstoken

11. Kopieren Sie dieses Token – Sie benötigen es für die Konfiguration

Hinweis: Bewahren Sie Ihren Zugriffstoken sicher auf. Er ermöglicht den Zugriff auf Ihre Shop-Daten und sollte niemals weitergegeben oder der Versionskontrolle übergeben werden. Weitere Informationen zur Erstellung einer Shopify-App finden Sie hier .

Verwendung mit Claude Desktop

Fügen Sie zu Ihrer claude_desktop_config.json hinzu:

Entwicklung

1. Klonen Sie das Repository

2. Installieren Sie Abhängigkeiten:

3. Erstellen Sie eine .env Datei:

4. Erstellen Sie das Projekt:

5. Führen Sie Tests durch:

Abhängigkeiten

• @modelcontextprotocol/sdk – Implementierung des MCP-Protokolls

• graphql-request – GraphQL-Client für die Shopify-API

• zod - Laufzeittypvalidierung

Beitragen

Beiträge sind willkommen! Bitte lesen Sie zuerst unsere Beitragsrichtlinien .

Lizenz

MIT

Gemeinschaft

• MCP GitHub-Diskussionen

• Probleme melden

Mit ❤️ unter Verwendung des Model Context Protocol erstellt