Sviluppatori

Riferimento capacità di Zinn® Reseller Toolkit

Zinn® Reseller Toolkit registra le proprie azioni con WordPress Abilities API. Le stesse capacità sono strumenti MCP sul server del sito e route REST sotto /wp-json/wp-abilities/v1. Questa pagina viene generata dal registro del plugin stesso.

Guida utente: collega un'app di IA

Endpoint

MCP su HTTP (streamable)

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

MCP su WP-CLI (standard input e output)

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

REST: elenca le capacità

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

REST: esegui un'abilità

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

Autenticazione e autorizzazioni

Le richieste HTTP si autenticano con una password applicativa WordPress (HTTP Basic). La connessione al server MCP richiede la funzionalità mostrata di seguito; ogni abilità verifica quindi la propria autorizzazione, per singolo oggetto. Le abilità di sola lettura vengono eseguite con GET e il relativo input nella query string; le altre con POST e un corpo JSON {"input": {…}}.

Esempi

# REST: esegui un'abilità
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":{}}}

Tutte le funzionalità

Generato dalle capacità del plugin tramite abilities.json, che a sua volta viene generato da un sito in esecuzione; un test fallisce quando i due non concordano.

Abilitazione	Cosa fa	Edizione	REST	Permesso	Parametri
`zinn-reseller/create-client` `zinn-reseller-create-client`	Crea un cliente Crea un account cliente sotto il Suo (nome; default_currency, un codice a tre lettere). Inseriscilo in un piano prima del suo primo sito.	Edizione gratuita	`POST …/abilities/zinn-reseller/create-client/run`	manage_options	name: string (obbligatorio), default_currency: string
`zinn-reseller/create-site` `zinn-reseller-create-site`	Crea un sito per un cliente Crea un sito ospitato per uno dei Suoi clienti (client_id, product_line, primary_domain). Viene fatturato sul Suo account secondo il piano del cliente, come dal Suo negozio.	Edizione gratuita	`POST …/abilities/zinn-reseller/create-site/run`	manage_options	client_id: string (obbligatorio), product_line: string (obbligatorio), primary_domain: string (obbligatorio)
`zinn-reseller/get-client-plan` `zinn-reseller-get-client-plan`	Leggi il piano di un cliente Restituisce il piano attivo di un cliente e il relativo costo per Lei (client_id).	Edizione gratuita	`GET …/abilities/zinn-reseller/get-client-plan/run`	manage_options	client_id: string (obbligatorio)
`zinn-reseller/get-overview` `zinn-reseller-get-overview`	Leggi il Suo account rivenditore Restituisce l'account del rivenditore in un'unica lettura: brand, piani, conteggio di clienti e servizi, e impostazioni configurate.	Edizione gratuita	`GET …/abilities/zinn-reseller/get-overview/run`	manage_options	nessuno
`zinn-reseller/get-settings` `zinn-reseller-get-settings`	Leggi le impostazioni del Toolkit per rivenditori Restituisce le impostazioni di questo plugin (l'indirizzo API, il piano utilizzato dai nuovi ordini, le funzioni attive). La chiave API non viene mai restituita, ma solo lo stato del suo salvataggio.	Edizione gratuita	`GET …/abilities/zinn-reseller/get-settings/run`	manage_options	nessuno
`zinn-reseller/list-clients` `zinn-reseller-list-clients`	Elenca i Suoi clienti Elenca i Suoi account cliente, una pagina alla volta (cursore, limite).	Edizione gratuita	`GET …/abilities/zinn-reseller/list-clients/run`	manage_options	cursor: string, limit: integer
`zinn-reseller/list-plans` `zinn-reseller-list-plans`	Elenca i piani che puoi vendere Elenca i piani di hosting e i relativi prezzi (product_line e currency li delimitano).	Edizione gratuita	`GET …/abilities/zinn-reseller/list-plans/run`	manage_options	product_line: string, currency: string
`zinn-reseller/list-sites` `zinn-reseller-list-sites`	Elenca i siti dei Suoi clienti Elenca tutto ciò che ha configurato per i propri clienti (client_id e status limitano la ricerca), una pagina alla volta.	Edizione gratuita	`GET …/abilities/zinn-reseller/list-sites/run`	manage_options	cursor: string, limit: integer, client_id: string, status: string
`zinn-reseller/set-client-plan` `zinn-reseller-set-client-plan`	Assegna un piano a un cliente Assegna un cliente a uno dei vostri piani (client_id, plan_code; interval: month o year). Da eseguire prima del loro primo sito.	Edizione gratuita	`POST …/abilities/zinn-reseller/set-client-plan/run`	manage_options	client_id: string (obbligatorio), plan_code: string (obbligatorio), interval: month\|year
`zinn-reseller/suspend-site` `zinn-reseller-suspend-site`	Sospendi il sito di un cliente Mette il sito di un cliente in sospensione per mancato pagamento (site_id; motivo: una nota personale, mai mostrata al cliente). Il sito smette di essere attivo finché non viene riattivato.	Edizione gratuita	`POST …/abilities/zinn-reseller/suspend-site/run`	manage_options	site_id: string (obbligatorio), reason: string
`zinn-reseller/unsuspend-site` `zinn-reseller-unsuspend-site`	Riattiva il sito di un cliente Rimuove il blocco per mancato pagamento, in modo che il sito torni a essere attivo (site_id).	Edizione gratuita	`POST …/abilities/zinn-reseller/unsuspend-site/run`	manage_options	site_id: string (obbligatorio)
`zinn-reseller/update-settings` `zinn-reseller-update-settings`	Modifica le impostazioni del Reseller Toolkit Modifica le impostazioni inviate (plan_code, enable_domain_search, enable_panel_link, enable_woocommerce) e mantiene le altre. La chiave API e l'indirizzo vengono modificati solo sullo schermo.	Edizione gratuita	`POST …/abilities/zinn-reseller/update-settings/run`	manage_options	plan_code: string, enable_domain_search: boolean, enable_panel_link: boolean, enable_woocommerce: boolean