Desenvolvedores

Referência de capacidades de Zinn® Reseller Toolkit

Zinn® Reseller Toolkit registra suas ações na WordPress Abilities API. As mesmas habilidades são ferramentas de MCP no próprio servidor do site e rotas REST em /wp-json/wp-abilities/v1. Esta página é gerada a partir do registro do próprio plugin.

Guia do usuário: conectar um aplicativo de IA

Endpoints

MCP sobre HTTP (streaming)

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

MCP sobre WP-CLI (entrada e saída padrão)

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

REST: listar as habilidades

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

REST: executar uma habilidade

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

Autenticação e permissões

As solicitações HTTP autenticam-se com uma senha de aplicativo do WordPress (HTTP Basic). A conexão com o servidor MCP precisa do recurso mostrado abaixo; cada habilidade verifica então a sua própria permissão, por objeto. As habilidades somente leitura são executadas com GET e sua entrada na string de consulta; as demais, com POST e um corpo JSON {"input": {…}}.

Exemplos

# REST: executar uma habilidade
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":{}}}

Todos os recursos

Gerado a partir do arquivo abilities.json do plugin, que por sua vez é gerado a partir de um site em execução; um teste falha quando os dois discordam.

Recurso	O que ele faz	Edição	REST	Permissão	Parâmetros
`zinn-reseller/create-client` `zinn-reseller-create-client`	Criar um cliente Cria uma conta de cliente sob a sua (nome; default_currency, um código de três letras). Coloque-o em um plano antes do primeiro site dele.	Edição gratuita	`POST …/abilities/zinn-reseller/create-client/run`	manage_options	name: string (obrigatório), default_currency: string
`zinn-reseller/create-site` `zinn-reseller-create-site`	Criar um site para um cliente Cria um site hospedado para um de seus clientes (client_id, product_line, primary_domain). Ele é cobrado em sua conta no plano do cliente, conforme a sua loja.	Edição gratuita	`POST …/abilities/zinn-reseller/create-site/run`	manage_options	client_id: string (obrigatório), product_line: string (obrigatório), primary_domain: string (obrigatório)
`zinn-reseller/get-client-plan` `zinn-reseller-get-client-plan`	Ler o plano de um cliente Retorna qual plano um cliente possui e quanto isso custa a você (client_id).	Edição gratuita	`GET …/abilities/zinn-reseller/get-client-plan/run`	manage_options	client_id: string (obrigatório)
`zinn-reseller/get-overview` `zinn-reseller-get-overview`	Leia sua conta de revenda Retorna a sua conta de revenda em uma única leitura: contagem de marca, planos, clientes e serviços, e o que está configurado.	Edição gratuita	`GET …/abilities/zinn-reseller/get-overview/run`	manage_options	nenhum
`zinn-reseller/get-settings` `zinn-reseller-get-settings`	Ler as configurações do Reseller Toolkit Retorna as configurações deste plugin (o endereço da API, o plano usado por novos pedidos, quais recursos estão ativados). A chave da API nunca é retornada, apenas se há uma salva.	Edição gratuita	`GET …/abilities/zinn-reseller/get-settings/run`	manage_options	nenhum
`zinn-reseller/list-clients` `zinn-reseller-list-clients`	Listar seus clientes Lista as contas de seus clientes, uma página por vez (cursor, limit).	Edição gratuita	`GET …/abilities/zinn-reseller/list-clients/run`	manage_options	cursor: string, limit: integer
`zinn-reseller/list-plans` `zinn-reseller-list-plans`	Listar os planos que você pode vender Lista os planos de hospedagem e seus preços (product_line e currency restringem a busca).	Edição gratuita	`GET …/abilities/zinn-reseller/list-plans/run`	manage_options	product_line: string, currency: string
`zinn-reseller/list-sites` `zinn-reseller-list-sites`	Listar os sites de seus clientes Lista tudo o que você provisionou para os seus clientes (client_id e status restringem a busca), uma página por vez.	Edição 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`	Colocar um cliente em um plano Insere um cliente em um dos seus planos (client_id, plan_code; interval: month ou year). Faça isso antes do primeiro site dele.	Edição gratuita	`POST …/abilities/zinn-reseller/set-client-plan/run`	manage_options	client_id: string (obrigatório), plan_code: string (obrigatório), interval: month\|year
`zinn-reseller/suspend-site` `zinn-reseller-suspend-site`	Suspender o site de um cliente Coloca o site de um cliente em suspensão por falta de pagamento (site_id; motivo: sua própria anotação, nunca exibida ao cliente). O site para de funcionar até que seja reativado.	Edição gratuita	`POST …/abilities/zinn-reseller/suspend-site/run`	manage_options	site_id: string (obrigatório), reason: string
`zinn-reseller/unsuspend-site` `zinn-reseller-unsuspend-site`	Reativar o site do cliente Remove o bloqueio por falta de pagamento para que o site volte a funcionar (site_id).	Edição gratuita	`POST …/abilities/zinn-reseller/unsuspend-site/run`	manage_options	site_id: string (obrigatório)
`zinn-reseller/update-settings` `zinn-reseller-update-settings`	Alterar as configurações do Kit de Ferramentas de Revendedor Altera as configurações que você envia (plan_code, enable_domain_search, enable_panel_link, enable_woocommerce) e mantém o restante. A chave de API e o endereço são alterados apenas na tela.	Edição gratuita	`POST …/abilities/zinn-reseller/update-settings/run`	manage_options	plan_code: string, enable_domain_search: boolean, enable_panel_link: boolean, enable_woocommerce: boolean