開発者

Zinn® Reseller Toolkit 機能リファレンス

Zinn® Reseller Toolkit は、WordPress Abilities API にアクションを登録します。同じ能力は、サイト自体のサーバー上の MCP ツールであり、/wp-json/wp-abilities/v1 以下の REST ルートです。このページはプラグイン自体のレジストリから生成されます。

ユーザーガイド: AI アプリを接続する

プラットフォームのツールにAIアシスタントが接続されるのを歓声で迎える、私たちのバイキング、Zinn®。

エンドポイント

MCP over HTTP (ストリーマブル)

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

WP-CLI 経由の MCP (標準入出力)

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

REST: 能力の一覧を表示

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

REST: 能力を実行する

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

認証と権限

HTTP リクエストは、WordPress のアプリケーションパスワード (HTTP Basic) で認証します。MCP サーバーへの接続には以下に示す権限が必要であり、その後各アビリティがオブジェクトごとに固有のパーミッションを確認します。読み取り専用のアビリティは GET とクエリ文字列内の入力で実行され、その他のアビリティは POST と JSON ボディ{"input": {…}}で実行されます。

例

# REST: 能力を実行する
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":{}}}

すべての権限

プラグインの abilities.json から生成されます。これは稼働中のサイトからそれ自体が生成されるもので、両者が一致しない場合、テストは失敗します。

権限機能エディションREST権限パラメーター
zinn-reseller/create-client
zinn-reseller-create-client
クライアントを作成
お客様のアカウントの配下にクライアントアカウントを作成します (name、default_currency: 3文字のコード)。最初のサイトを作成する前にプランを設定してください。
無料版POST …/abilities/zinn-reseller/create-client/runmanage_optionsname: string (必須), default_currency: string
zinn-reseller/create-site
zinn-reseller-create-site
クライアント向けにサイトを作成
クライアントの1人に対してホスト型サイトを作成します (client_id, product_line, primary_domain)。ストアからと同様に、クライアントのプランでお客様のアカウントに請求されます。
無料版POST …/abilities/zinn-reseller/create-site/runmanage_optionsclient_id: string (必須), product_line: string (必須), primary_domain: string (必須)
zinn-reseller/get-client-plan
zinn-reseller-get-client-plan
クライアントのプランを表示
クライアントが利用しているプランと、それにかかる費用を返します (client_id)。
無料版GET …/abilities/zinn-reseller/get-client-plan/runmanage_optionsclient_id: string (必須)
zinn-reseller/get-overview
zinn-reseller-get-overview
リセラーアカウントを表示
リセラーアカウントを1回のリクエストで取得します: ブランド、プラン、クライアントとサービスの数、設定内容。
無料版GET …/abilities/zinn-reseller/get-overview/runmanage_optionsなし
zinn-reseller/get-settings
zinn-reseller-get-settings
Reseller Toolkit の設定を読み取る
このプラグインの設定 (API アドレス、新規注文が使用するプラン、有効になっている機能) を返します。API キーは返されず、保存されているかどうかのみが返されます。
無料版GET …/abilities/zinn-reseller/get-settings/runmanage_optionsなし
zinn-reseller/list-clients
zinn-reseller-list-clients
クライアントを一覧表示
クライアントアカウントを1ページずつ一覧表示します (cursor, limit)。
無料版GET …/abilities/zinn-reseller/list-clients/runmanage_optionscursor: string, limit: integer
zinn-reseller/list-plans
zinn-reseller-list-plans
販売可能なプランを一覧表示
ホスティングプランとその価格を一覧表示します (product_line と currency で絞り込みます)。
無料版GET …/abilities/zinn-reseller/list-plans/runmanage_optionsproduct_line: string, currency: string
zinn-reseller/list-sites
zinn-reseller-list-sites
クライアントのサイトを一覧表示
クライアント向けにプロビジョニングしたすべての項目を、1ページずつ一覧表示します (client_id と status で絞り込み可能)。
無料版GET …/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
クライアントをプランに割り当てる
クライアントをいずれかのプランに登録します (client_id, plan_code; interval: month または year)。最初のサイトを作成する前に行ってください。
無料版POST …/abilities/zinn-reseller/set-client-plan/runmanage_optionsclient_id: string (必須), plan_code: string (必須), interval: month|year
zinn-reseller/suspend-site
zinn-reseller-suspend-site
クライアントのサイトを一時停止
クライアントのサイトを未払いによる保留状態にします (site_id; reason: 独自のメモ。クライアントには表示されません)。利用停止が解除されるまで、サイトの配信は停止します。
無料版POST …/abilities/zinn-reseller/suspend-site/runmanage_optionssite_id: string (必須), reason: string
zinn-reseller/unsuspend-site
zinn-reseller-unsuspend-site
クライアントのサイトの停止を解除する
未払いによる保留を解除し、サイトを再度配信できるようにします (site_id)。
無料版POST …/abilities/zinn-reseller/unsuspend-site/runmanage_optionssite_id: string (必須)
zinn-reseller/update-settings
zinn-reseller-update-settings
Reseller Toolkit の設定を変更する
送信した設定 (plan_code、enable_domain_search、enable_panel_link、enable_woocommerce) を変更し、残りを保持します。API キーとアドレスは画面上でのみ変更されます。
無料版POST …/abilities/zinn-reseller/update-settings/runmanage_optionsplan_code: string, enable_domain_search: boolean, enable_panel_link: boolean, enable_woocommerce: boolean