Shopify MCP-Server aktualisieren

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

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
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
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
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
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
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
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
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
get-order
- Erhalten Sie eine einzelne Bestellung nach ID
- Eingänge:
  - orderId (Zeichenfolge): ID der abzurufenden Bestellung
- Rücksendungen: Detaillierte Bestellinformationen
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

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

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

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

get-shop

Shopdetails abrufen
Eingänge: Keine
Rücksendungen: Grundlegende Shop-Informationen

get-shop-details

Erhalten Sie erweiterte Shopdetails, einschließlich Versandländer
Eingänge: Keine
Retouren: Erweiterte Shop-Informationen inkl. Versandländer

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:

Gehen Sie in Ihrem Shopify-Adminbereich zu Einstellungen > Apps und Vertriebskanäle
Klicken Sie auf „Apps entwickeln“ (möglicherweise müssen Sie zuerst die Entwicklervorschau aktivieren).
Klicken Sie auf App erstellen
Legen Sie einen Namen für Ihre App fest (z. B. „Shopify MCP Server“)
Klicken Sie auf „Admin-API-Bereiche konfigurieren“
Wählen Sie die folgenden Bereiche aus:
- read_products , write_products
- read_customers , write_customers
- read_orders , write_orders
Klicken Sie auf Speichern
Klicken Sie auf App installieren
Klicken Sie auf Installieren, um der App Zugriff auf Ihre Shop-Daten zu gewähren
Nach der Installation sehen Sie Ihr Admin-API-Zugriffstoken
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:

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": ["-y", "shopify-mcp-server"],
      "env": {
        "SHOPIFY_ACCESS_TOKEN": "<YOUR_ACCESS_TOKEN>",
        "MYSHOPIFY_DOMAIN": "<YOUR_SHOP>.myshopify.com"
      }
    }
  }
}

Entwicklung

Klonen Sie das Repository
Installieren Sie Abhängigkeiten:

npm install

Erstellen Sie eine .env Datei:

SHOPIFY_ACCESS_TOKEN=your_access_token
MYSHOPIFY_DOMAIN=your-store.myshopify.com

Erstellen Sie das Projekt:

npm run build

Führen Sie Tests durch:

npm test

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

Mit ❤️ unter Verwendung des Model Context Protocol erstellt

Shopify Update MCP Server