Dokumentation
Dokumentation von MCPify für WooCommerce
Server-URL für OAuth-Clients: https://woo.getmcpify.app/mcp. API-Schlüssel nutzen https://woo.getmcpify.app/mcp/<Verbindungs-ID>. MCPify nutzt die WooCommerce-REST-API (/wc/v3) und für Seiten, Beiträge, Medien und Menüs die WordPress-REST-API (/wp/v2).
Anleitungen Schritt für Schritt: Claude, ChatGPT, Cursor, Codex. Ideen, was du damit machen kannst: Einsatzbeispiele.
Was MCPify für WooCommerce ist
MCPify verbindet einen WooCommerce-Shop über das Model Context Protocol mit einem KI-Client. Eine Verbindung legt fest, was der Client darf: lesen, ändern oder löschen pro Shop-Bereich, welche direkten REST-API-Anfragen er senden darf und weitere Limits wie Preise, Erstattungen, endgültiges Löschen oder Kundendaten. Jeder Aufruf wird geprüft, bevor er den Shop erreicht, und im Audit-Log des Shops festgehalten. MCPify hat keinen eigenen Chat; Prompts und Modelle übernimmt der KI-Client.
Einen Client verbinden
OAuth (Claude-Connectoren, Claude Code, ChatGPT, Cursor, Codex mit OAuth): Trag die Server-URL ein, die auf /mcp endet. Der Client öffnet die Anmeldeseite von MCPify: Wähle „Continue in WordPress admin“ und gib die Adresse des Shops ein (ein WordPress-Administrator oder Shop-Manager wählt dort die Verbindung), oder gib einen Pairing-Code von der Seite der Verbindung im MCPify-Dashboard ein. API-Schlüssel (jeder Client, der Header senden kann): Nutze die URL der Verbindung /mcp/<Verbindungs-ID> mit dem Header „Authorization: Bearer <Schlüssel>“. Schlüssel werden einmal angezeigt; behandle sie wie Passwörter.
Rechte und Limits
Rechte pro Bereich (lesen / ändern / löschen) schalten die vorgefertigten Tools frei. Direkte REST-API-Anfragen sind getrennt davon: Jedes Muster „METHODE /route“ muss ausdrücklich freigegeben werden, Bereichsrechte gelten dafür nie. Weitere Limits: Produktinhalte, Preise (braucht auch Produktinhalte), Medien, Kundendaten (aus = Kunden-Tools ausgeblendet und Namen, Adressen, E-Mail, Telefon und IP-Adressen geschwärzt; Freitext wie Bestellnotizen kann trotzdem personenbezogene Daten enthalten), Erstattungen mit optionaler Obergrenze, endgültiges Löschen (aus = nur Papierkorb) und Stapelgröße. Eine Sperrliste blockiert Anfragen überall. Auch der WooCommerce-REST-API-Schlüssel des Shops begrenzt jeden Aufruf. Skills vergeben nie Rechte.
Direkte REST-Anfragen
Für alles, was die vorgefertigten Tools nicht abdecken, kann der Shop-Inhaber Muster „METHODE /route“ der WooCommerce- (/wc/v3) und WordPress-REST-API (/wp/v2) freigeben, z. B. „GET /wc/v3/reports*“. Freigegebene Lesezugriffe laufen über woo_rest_get, freigegebene Änderungen über woo_rest_request (Pläne Pro und Agency). Es gelten dieselben Limits wie für die vorgefertigten Tools: Preise, Erstattungen, endgültiges Löschen, Medien, Kundendaten und Stapelgröße. Bereichsrechte gelten nie für direkte Anfragen, und eine Sperrliste blockiert Anfragen überall. Manche Anfragen werden nie gesendet, egal was freigegeben ist: WordPress-Benutzer und Anwendungspasswörter, Plugins, Änderungen an Website-Einstellungen, Zahlungsarten, Webhooks, die Wartungs-Tools von WooCommerce und das Setzen von Passwörtern. Zugangsdaten in Antworten (API-Schlüssel, Secrets, Passwort-Einstellungen) bleiben verborgen.
Seitenweise Abfragen
Listen kommen seitenweise mit page und per_page (höchstens 100). Das Ergebnis nennt die Gesamtzahl der Einträge und Seiten; weiterlesen bis zur letzten Seite. Eine Seite allein beweist nie, dass eine Liste vollständig ist.
Sichere Wiederholungen
Gib Änderungen, die es annehmen, einen idempotencyKey (UUID) mit. Eine Wiederholung mit demselben Schlüssel und denselben Argumenten liefert das gespeicherte Ergebnis, statt den Shop erneut zu ändern; derselbe Schlüssel mit anderen Argumenten wird abgelehnt, ebenso eine Wiederholung, während der erste Aufruf noch läuft. Ist ein Aufruf in ein Zeitlimit gelaufen, lies zuerst den aktuellen Stand. Ist der Zielwert schon gesetzt, hör auf; sonst plane eine neue Änderung mit neuem Schlüssel auf Grundlage dessen, was du gerade gelesen hast.
Arbeitsregeln für KI-Clients
So, auf Englisch, bekommen KI-Clients sie über get_instructions:
# Working with this WooCommerce store through MCPify
- Call get_store_info first so you know which store, currency and language you are working with.
- Read before you write: look at the current state of what you want to change.
- Ask the user before every change and show what will change. Deletes move items to the trash unless permanent deletes are allowed.
- Work in pages and say how much of a list you have covered.
- If MCPify blocks a call, explain in plain words what the connection may not do and where the store owner can allow it (MCPify dashboard › Connections › Permissions or Advanced limits). Do not try to work around a block.
- Customer data may be redacted ("[redacted]"); never guess it.
- Report problems with MCPify itself through get_support_reporting_instructions.Shop-Bereiche
| Bereich | Schlüssel | Aktionen |
|---|---|---|
| Shop & Einstellungen | store | lesen, ändern |
| Produkte & Varianten | products | lesen, ändern, löschen |
| Kategorien & Schlagwörter | taxonomies | lesen, ändern, löschen |
| Lagerbestand | inventory | lesen, ändern |
| Bestellungen | orders | lesen, ändern |
| Kunden | customers | lesen, ändern |
| Gutscheine | coupons | lesen, ändern, löschen |
| Bewertungen | reviews | lesen, ändern, löschen |
| Seiten & Beiträge | content | lesen, ändern, löschen |
| Medien | media | lesen, ändern, löschen |
| Menüs | menus | lesen, ändern |
| Versand & Steuern | shipping_tax | lesen |
Limits
Sperren innerhalb der erlaubten Bereiche, für jedes Tool und jede direkte REST-Anfrage:
- Produktinhalte: Namen, Beschreibungen, Kategorien, Schlagwörter, Eigenschaften und Varianten von Produkten.
- Preisänderungen: Normal- und Angebotspreise von Produkten und Varianten (braucht Produktinhalte). Standardmäßig aus.
- Medien: Produktbilder und Uploads in die Mediathek.
- Kundendaten: Namen, Adressen, E-Mails, Telefonnummern und IP-Adressen sowie die Kunden-Tools. Standardmäßig aus: in jeder Antwort geschwärzt.
- Erstattungen: Erstattungen anlegen, optional bis zu einer Höchstsumme. Standardmäßig aus.
- Endgültiges Löschen: Endgültig löschen (force) und Stapel-Löschungen statt Papierkorb. Standardmäßig aus.
- Größter Stapel: Einträge pro Stapelanfrage, höchstens 100.
Tool-Liste (70)
Direkt aus der Tool-Liste des Servers, mit den englischen Beschreibungen, die auch KI-Clients sehen. „always“ heißt: Es braucht kein Bereichsrecht; Anmeldung und alle anderen Prüfungen gelten trotzdem. Tools, die den Shop ändern, brauchen außerdem einen Plan mit Schreibzugriff.
| Tool | Bereich | Braucht | Beschreibung |
|---|---|---|---|
add_order_note | orders | write | Add a note to an order. |
create_category | taxonomies | write | Create a product category. |
create_coupon | coupons | write | Create a coupon code with a percentage or fixed discount and optional limits. |
create_page | content | write | Create a WordPress page. |
create_post | content | write | Create a WordPress blog post. |
create_product | products | write | Create a simple or variable product. |
create_refund | orders | write | Refund (part of) an order. |
create_tag | taxonomies | write | Create a product tag. |
create_variation | products | write | Add a variation to a variable product, e.g. |
delete_category | taxonomies | delete | Delete a product category for good (categorys have no trash). |
delete_coupon | coupons | delete | Move a coupon to the trash. |
delete_media | media | delete | Delete a file from the media library for good (media has no trash). |
delete_page | content | delete | Move a WordPress page to the trash. |
delete_post | content | delete | Move a WordPress blog post to the trash. |
delete_product | products | delete | Move a product to the trash. |
delete_review | reviews | delete | Move a review to the trash. |
delete_tag | taxonomies | delete | Delete a product tag for good (tags have no trash). |
delete_variation | products | delete | Delete a variation for good (variations have no trash). |
get_capabilities | general | always | Plan, permissions, limits and granted REST patterns of this connection. |
get_coupon | coupons | read | One coupon with all its rules (products, categories, limits). |
get_customer | customers | read | One customer account with billing and shipping address. |
get_documentation | general | always | MCPify documentation by topic: overview, connecting, permissions, raw_requests, pagination, retries. |
get_instructions | general | always | How to work safely with this WooCommerce store through MCPify. |
get_order | orders | read | One order with line items, shipping and tax lines, coupons, refunds, payment and addresses (addresses redacted unless customer data is allowed). |
get_page | content | read | One WordPress page with its content (raw and rendered). |
get_post | content | read | One blog post with its content (raw and rendered). |
get_product | products | read | One product with descriptions, images and their alt texts, attributes, variation IDs, dimensions and custom fields. |
get_sales_report | orders | read | Sales totals (gross and net sales, orders, items, tax, shipping, refunds, discounts) for a period or date range, with daily or monthly totals. |
get_settings | store | read | WooCommerce settings. |
get_skill | general | always | Step-by-step instructions of one skill, filled in with arguments. |
get_store_info | store | read | Store name, address, currency, WordPress and WooCommerce versions, active theme and plugins. |
get_support_reporting_instructions | general | always | How to report a bug or missing feature to MCPify support. |
get_top_sellers | orders | read | Best-selling products by quantity for a period or date range. |
get_variation | products | read | One variation of a variable product with all its fields. |
list_categories | taxonomies | read | Product categories with their parent, description, image and number of products. |
list_coupons | coupons | read | Coupon codes with discount type, amount, expiry and usage. |
list_customers | customers | read | Search and list customer accounts with name, email, order count and total spent. |
list_media | media | read | Files in the media library with URL, type, title and alt text. |
list_menu_items | menus | read | The items of a menu with title, link, order and parent item. |
list_menus | menus | read | Navigation menus with their locations. |
list_order_notes | orders | read | Notes on an order: private notes and notes sent to the customer. |
list_orders | orders | read | Search and list orders with status, totals, dates and line items. |
list_pages | content | read | WordPress pages with title, status, link and excerpt. |
list_posts | content | read | Blog posts with title, status, link, categories and excerpt. |
list_product_attributes | products | read | Global product attributes (e.g. |
list_products | products | read | Search and list products with price, stock and categories. |
list_refunds | orders | read | Refunds of an order with amount, reason and refunded line items. |
list_reviews | reviews | read | Product reviews with rating, text and moderation status. |
list_shipping_zones | shipping_tax | read | Shipping zones with their regions and shipping methods (flat rate, free shipping, local pickup) and costs. |
list_skills | general | always | Skills enabled for this connection. |
list_stock | inventory | read | Stock quantity, stock status, stock management and backorder setting of products. |
list_tags | taxonomies | read | Product tags with their number of products. |
list_tax_rates | shipping_tax | read | Tax classes and their tax rates by country, state and postcode. |
list_variations | products | read | The variations of a variable product with their attributes, prices and stock. |
moderate_review | reviews | write | Approve a review, put it on hold or mark it as spam. |
set_stock | inventory | write | Set the stock of a product or of one variation: stock quantity, whether WooCommerce manages stock, stock status and backorders. |
submit_support_report | general | always | Send an issue report to MCPify support. |
update_category | taxonomies | write | Rename a product category or change its slug or description or parent. |
update_coupon | coupons | write | Change a coupon's code, discount, expiry or limits. |
update_customer | customers | write | Change a customer's name, email or billing and shipping address. |
update_media | media | write | Set a media file's alt text, title, caption or description. |
update_order_status | orders | write | Change an order's status, e.g. |
update_page | content | write | Change a WordPress page's title, content, excerpt, slug, status or date. |
update_post | content | write | Change a WordPress blog post's title, content, excerpt, slug, status or date. |
update_product | products | write | Change a product's name, texts, slug, status, SKU, categories, tags, images or prices. |
update_products_batch | products | write | Change several products at once (at most 100, and at most the connection's batch size). |
update_tag | taxonomies | write | Rename a product tag or change its slug or description. |
update_variation | products | write | Change a variation's SKU, prices, status, description or image. |
woo_rest_get | raw REST | granted GET pattern | Run one granted GET request of the WooCommerce or WordPress REST API (Pro). |
woo_rest_request | raw REST | granted pattern | Run one granted POST, PUT, PATCH or DELETE request (Pro). |
Pläne
Free · $0
- 1 Verbindung
- 150 Anfragen pro Monat
- Nur lesen
- Audit-Log für 7 Tage
Starter · $9.99 / Monat oder $99.90 / Jahr
- 1 Verbindung
- 1.000 Anfragen pro Monat
- Schreiben und löschen
- Eigene Rechte und Limits
- Audit-Log für 30 Tage
Pro · $29 / Monat oder $290 / Jahr
- Alles aus Starter
- Unbegrenzt Verbindungen und Anfragen
- Skills
- Freigaben für die REST-API
- Audit-Log für 12 Monate
Agency · $79 / Monat oder $790 / Jahr
- Alles aus Pro
- Bis zu 10 Shops in einem Workspace
- Teamzugang für bis zu 10 Mitglieder
- Export des Audit-Logs (CSV)
- Bevorzugter Support
Details und der kostenlose Test: Preise.
Agenturen: mehrere Shops, ein Workspace
- Installiere und verbinde das MCPify-Plugin in jedem Shop, auch in deinem eigenen.
- Schließ den Agency-Plan in dem Shop ab, der für alle zahlen soll, und lege dann in seinem MCPify-Dashboard unter Agency einen Workspace an.
- Erstelle dort einen Code und schick ihn deinem Kunden. Der Administrator des Kunden gibt ihn in seinem eigenen MCPify-Dashboard unter Agency ein; der Shop bekommt den Agency-Plan dann über deinen Workspace.
- Füge dein Team per E-Mail hinzu. Teammitglieder verwalten MCPify (Verbindungen, Schlüssel, Skills) in jedem Shop des Workspace, in dem sie ein WordPress-Konto als Shop-Manager haben.
Das Dashboard deines Hauptshops zeigt Verbindungen, Anfragen und blockierte Anfragen aller Shops und exportiert alle Audit-Logs auf einmal. Kundenshops sehen nur, zu welchem Workspace sie gehören, nie einander, und können jederzeit austreten.