開発者

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

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

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

エンドポイント

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
クライアントを作成
あなたのアカウントの下にクライアントアカウントを作成します(名前、3文字のコードである default_currency)。最初のサイトを作成する前にプランを設定してください。
無料版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
代理店アカウントを読む
ブランド、プラン、顧客およびサービスの数、そして設定内容など、リセラーアカウントの概要を一目で確認できます。
無料版GET …/abilities/zinn-reseller/get-overview/runmanage_optionsなし
zinn-reseller/get-settings
zinn-reseller-get-settings
リセラーツールキットの設定を読み取る
このプラグインの設定(APIアドレス、新規注文で使用するプラン、有効な機能)を返します。APIキーは返されず、保存されているかどうかのみが返されます。
無料版GET …/abilities/zinn-reseller/get-settings/runmanage_optionsなし
zinn-reseller/list-clients
zinn-reseller-list-clients
クライアントの一覧を表示
クライアントアカウントを1ページずつ一覧表示します(カーソル、制限)。
無料版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
クライアントのサイトを一覧表示する
クライアントに対してプロビジョニングしたすべてのもの(client_idとstatusで絞り込み可能)を、1ページずつリスト表示します。
無料版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; 理由:ご自身のメモで、クライアントには一切表示されません)。解除されるまでサイトの配信が停止されます。
無料版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
リセラーツールキットの設定を変更する
送信する設定(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