Entwickler

Zinn® Reseller Toolkit-Funktionen-Referenz

Zinn® Reseller Toolkit registriert seine Aktionen bei der WordPress Abilities API. Dieselben Berechtigungen sind MCP-Tools auf dem eigenen Server der Website und REST-Routen unter /wp-json/wp-abilities/v1. Diese Seite wird aus der eigenen Registry des Plugins generiert.

Benutzerhandbuch: Verbinden einer KI-App

Zinn®, unser Wikinger, jubelt, während sich ein KI-Assistent mit den Tools der Plattform verbindet.

Endpunkte

MCP über HTTP (streamable)

https://example.com/wp-json/zinn-reseller/v1/mcp

MCP über WP-CLI (Standardeingabe und -ausgabe)

wp mcp-adapter serve --server=zinn-reseller --user=<login>

REST: Fähigkeiten auflisten

/wp-json/wp-abilities/v1/abilities?category=zinn-reseller

REST: Fähigkeit ausführen

/wp-json/wp-abilities/v1/abilities/<name>/run

Authentifizierung und Berechtigungen

HTTP-Anfragen authentifizieren sich mit einem WordPress-Anwendungspasswort (HTTP Basic). Das Verbinden mit dem MCP-Server erfordert die unten gezeigte Berechtigung; jede Funktion prüft anschließend ihre eigene Berechtigung pro Objekt. Schreibgeschützte Funktionen werden mit GET und ihrer Eingabe in der Abfragezeichenfolge ausgeführt; die anderen mit POST und einem JSON-Body {„input“: {…}}.

Beispiele

# REST: Fähigkeit ausführen
curl -u your-username:your-application-password \
  "https://example.com/wp-json/wp-abilities/v1/abilities/zinn-reseller/get-overview/run"
# MCP (JSON-RPC over HTTP, after "initialize")
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"zinn-reseller-get-overview","arguments":{}}}

Alle Berechtigungen

Generiert aus der abilities.json des Plugins, die ihrerseits aus einer laufenden Website generiert wird; ein Test schlägt fehl, wenn beide nicht übereinstimmen.

BerechtigungFunktionsweiseAusgabeRuhezeitBerechtigungParameter
zinn-reseller/create-client
zinn-reseller-create-client
Erstelle einen Client
Erstellt ein Kundenkonto unter deinem Konto (name; default_currency, ein dreistelliger Code). Weise ihnen vor ihrer ersten Website einen Tarif zu.
Kostenlose EditionPOST …/abilities/zinn-reseller/create-client/runmanage_optionsname: string (Erforderlich), default_currency: string
zinn-reseller/create-site
zinn-reseller-create-site
Erstelle eine Website für einen Kunden
Erstellt eine gehostete Website für einen deiner Kunden (client_id, product_line, primary_domain). Sie wird deinem Konto gemäß dem Tarif des Kunden wie von deinem Shop in Rechnung gestellt.
Kostenlose EditionPOST …/abilities/zinn-reseller/create-site/runmanage_optionsclient_id: string (Erforderlich), product_line: string (Erforderlich), primary_domain: string (Erforderlich)
zinn-reseller/get-client-plan
zinn-reseller-get-client-plan
Lies den Tarif eines Kunden
Gibt zurück, welchen Tarif ein Kunde nutzt und was er dich kostet (client_id).
Kostenlose EditionGET …/abilities/zinn-reseller/get-client-plan/runmanage_optionsclient_id: string (Erforderlich)
zinn-reseller/get-overview
zinn-reseller-get-overview
Lies dein Reseller-Konto
Gibt dein Reseller-Konto in einem einzigen Lesevorgang zurück: Marke, Tarife, Anzahl der Kunden und Dienste sowie was eingerichtet ist.
Kostenlose EditionGET …/abilities/zinn-reseller/get-overview/runmanage_optionsKeine
zinn-reseller/get-settings
zinn-reseller-get-settings
Lies die Einstellungen des Reseller-Toolkits
Gibt die Einstellungen dieses Plugins zurück (die API-Adresse, den von neuen Bestellungen verwendeten Tarif, welche Funktionen aktiviert sind). Der API-Schlüssel wird nie zurückgegeben, sondern nur, ob einer gespeichert ist.
Kostenlose EditionGET …/abilities/zinn-reseller/get-settings/runmanage_optionsKeine
zinn-reseller/list-clients
zinn-reseller-list-clients
Liste deine Kunden auf
Listet deine Kundenkonten seitenweise auf (cursor, limit).
Kostenlose EditionGET …/abilities/zinn-reseller/list-clients/runmanage_optionscursor: string, limit: integer
zinn-reseller/list-plans
zinn-reseller-list-plans
Liste die Tarife auf, die du verkaufen kannst
Listet die Hosting-Tarife und deren Preise auf (product_line und currency schränken dies ein).
Kostenlose EditionGET …/abilities/zinn-reseller/list-plans/runmanage_optionsproduct_line: string, currency: string
zinn-reseller/list-sites
zinn-reseller-list-sites
Websites deiner Kunden auflisten
Listet seitenweise alles auf, was du für deine Kunden bereitgestellt hast (client_id und status schränken es ein).
Kostenlose EditionGET …/abilities/zinn-reseller/list-sites/runmanage_optionscursor: string, limit: integer, client_id: string, status: string
zinn-reseller/set-client-plan
zinn-reseller-set-client-plan
Weise einem Kunden einen Tarif zu
Weist einen Kunden einem deiner Tarife zu (client_id, plan_code; interval: month oder year). Mach dies vor deren erster Website.
Kostenlose EditionPOST …/abilities/zinn-reseller/set-client-plan/runmanage_optionsclient_id: string (Erforderlich), plan_code: string (Erforderlich), interval: month|year
zinn-reseller/suspend-site
zinn-reseller-suspend-site
Website eines Kunden sperren
Versetzt die Website eines Kunden in eine Zahlungsausstandsperre (site_id; reason: deine eigene Notiz, die dem Kunden niemals angezeigt wird). Die Website stoppt die Bereitstellung, bis die Sperrung aufgehoben wird.
Kostenlose EditionPOST …/abilities/zinn-reseller/suspend-site/runmanage_optionssite_id: string (Erforderlich), reason: string
zinn-reseller/unsuspend-site
zinn-reseller-unsuspend-site
Website eines Kunden entsperren
Hebt eine Sperre wegen Nichtzahlung auf, damit die Website wieder erreichbar ist (site_id).
Kostenlose EditionPOST …/abilities/zinn-reseller/unsuspend-site/runmanage_optionssite_id: string (Erforderlich)
zinn-reseller/update-settings
zinn-reseller-update-settings
Ändere die Reseller-Toolkit-Einstellungen
Ändert die Einstellungen, die du sendest (plan_code, enable_domain_search, enable_panel_link, enable_woocommerce), und behält den Rest bei. Der API-Schlüssel und die Adresse werden nur auf dem Bildschirm geändert.
Kostenlose EditionPOST …/abilities/zinn-reseller/update-settings/runmanage_optionsplan_code: string, enable_domain_search: boolean, enable_panel_link: boolean, enable_woocommerce: boolean