開発者

Zinn® Cache 機能リファレンス

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

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

エンドポイント

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

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

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

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

REST: 能力の一覧を表示

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

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-cache/get-diagnostics/run"
# MCP (JSON-RPC over HTTP, after "initialize")
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"zinn-cache-get-diagnostics","arguments":{}}}

すべての権限

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

権限動作の仕組みエディションREST権限パラメータ
zinn-cache/clean-database
zinn-cache-clean-database
データベースのクリーンアップ (Pro)
設定で有効にされている不要なファイルをバックグラウンドで削除します。一度削除したファイルは復元できません。
プロ版POST …/abilities/zinn-cache/clean-database/runmanage_optionsなし
zinn-cache/convert-images
zinn-cache-convert-images
既存の画像をすべて変換(Pro)
設定で有効にされたメディアライブラリの画像の最新フォーマットへの変換を、バックグラウンドで開始します。
プロ版POST …/abilities/zinn-cache/convert-images/runmanage_optionsなし
zinn-cache/get-cache-analytics
zinn-cache-get-cache-analytics
キャッシュ分析を読む (Pro)
オブジェクトキャッシュの直近数時間(最大720時間)のヒット率とトラフィック、最も処理の遅いコマンド、およびキャッシュミスが最も多いプラグインを返します。
プロ版GET …/abilities/zinn-cache/get-cache-analytics/runmanage_optionshours: integer
zinn-cache/get-diagnostics
zinn-cache-get-diagnostics
診断レポートを読む
サポート窓口から依頼される診断レポート(バージョン、サーバー制限、キャッシュの状態、最近のエラーなど)を出力します。パスワードやキーは含まれません。
無料版GET …/abilities/zinn-cache/get-diagnostics/runmanage_optionsなし
zinn-cache/get-image-progress
zinn-cache-get-image-progress
画像変換の進行状況を読み取る(Pro)
画像の変換(または削除)がどの程度進んでいるかを返します。
プロ版GET …/abilities/zinn-cache/get-image-progress/runmanage_optionsなし
zinn-cache/get-pro-settings
zinn-cache-get-pro-settings
Cache Proの設定を読む (Pro)
Cache Proのすべての設定(プリロード、画像、スクリプトとスタイル、データベースのクリーンアップ、スマートパージ、ファインダー)を返します。機密情報は一切返されません。
プロ版GET …/abilities/zinn-cache/get-pro-settings/runmanage_optionsなし
zinn-cache/get-settings
zinn-cache-get-settings
キャッシュ設定を読む
すべてのキャッシュ設定を返します。Redisのパスワードは返されず、保存されているかどうのみが返されます。
無料版GET …/abilities/zinn-cache/get-settings/runmanage_optionsなし
zinn-cache/get-slow-queries
zinn-cache-get-slow-queries
スロークエリファインダーを読む(Pro)
ファインダーが記録した中で最も遅いデータベースクエリと外部への呼び出しを、それぞれを実行したプラグインまたはテーマとともに返します。
プロ版GET …/abilities/zinn-cache/get-slow-queries/runmanage_optionsなし
zinn-cache/get-status
zinn-cache-get-status
キャッシュステータスを読み取る
ページキャッシュとオブジェクトキャッシュが有効で正しく機能しているかどうか、キャッシュされているページの数、およびオブジェクトキャッシュの接続数とヒット数を返します。
無料版GET …/abilities/zinn-cache/get-status/runmanage_optionsなし
zinn-cache/get-warmup-progress
zinn-cache-get-warmup-progress
ウォームアップの進捗を読む (Pro)
ウォームアップが実行中かどうか、訪問したページ数、および失敗したページ数を返します。
プロ版GET …/abilities/zinn-cache/get-warmup-progress/runmanage_optionsなし
zinn-cache/preview-database-cleanup
zinn-cache-preview-database-cleanup
データベースのクリーンアップのプレビュー (Pro)
クリーンアップによって削除される項目を種類別(リビジョン、下書き、スパム、有効期限切れの一時データなど)にカウントします。データは削除されません。
プロ版GET …/abilities/zinn-cache/preview-database-cleanup/runmanage_optionsなし
zinn-cache/purge
zinn-cache-purge
キャッシュを削除
キャッシュされたページを破棄します:すべて(all: true)、一部のアドレス(urls)、またはタグ付けされたすべて(tags)。ページは訪問者のアクセス時に再構築されます。
無料版POST …/abilities/zinn-cache/purge/runmanage_options (the REST route's own check)all: boolean, urls: array, tags: array
zinn-cache/remove-converted-images
zinn-cache-remove-converted-images
変換されたすべての画像を削除(Pro)
バックグラウンドですべての画像の変換済みコピーを削除します。オリジナルは保持されます。
プロ版POST …/abilities/zinn-cache/remove-converted-images/runmanage_optionsなし
zinn-cache/reset-settings
zinn-cache-reset-settings
キャッシュ設定をデフォルトに戻す
[リセット]ボタンと同様に、すべてのキャッシュ設定をデフォルトに戻します。保存されているRedisのパスワードも削除されます。
無料版POST …/abilities/zinn-cache/reset-settings/runmanage_optionsなし
zinn-cache/reset-slow-queries
zinn-cache-reset-slow-queries
低速クエリの検出結果をクリア (Pro)
これまでに検出されたすべての低速クエリおよび低速呼び出しの記録を消去し、検索を最初からやり直します。
プロ版POST …/abilities/zinn-cache/reset-slow-queries/runmanage_optionsなし
zinn-cache/update-pro-settings
zinn-cache-update-pro-settings
Cache Proの設定を変更する (Pro)
送信するCache Proの設定を変更し(設定:キーと値)、残りはそのまま維持します。各値はCache Pro画面とまったく同じようにチェックされ、未知のキーは拒否されます。
プロ版POST …/abilities/zinn-cache/update-pro-settings/runmanage_optionssettings: object (必須)
zinn-cache/update-settings
zinn-cache-update-settings
キャッシュ設定を変更する
送信された設定を変更し、残りの設定(ページキャッシュ、ページのキャッシュ保持期間、オブジェクトキャッシュとそのRedis接続、パージルールと除外設定)はそのまま保持します。値は「キャッシュ」画面と同様に厳密にチェックおよび修正されます。
無料版POST …/abilities/zinn-cache/update-settings/runmanage_optionslscache_enabled: boolean, lscache_ttl: integer, object_cache_enabled: boolean, auto_purge_enabled: boolean, purge_on_upgrade: boolean, exclude_uris: array|object|string, exclude_query_keys: array|object|string, exclude_cookies: array|object|string, redis_host: string, redis_port: integer, redis_database: integer, redis_username: string, redis_password: string, redis_key_prefix: string, browser_ttl: integer, cache_logged_out_only: boolean, purge_on_comment: boolean, ttl_overrides: array|object|string
zinn-cache/warm-cache
zinn-cache-warm-cache
キャッシュをウォームアップ (Pro)
バックグラウンドでサイトマップ内のすべてのページの巡回を開始し、訪問者がキャッシュ済みのページを取得できるようにします。続いて zinn-cache/get-warmup-progress を実行してください。
プロ版POST …/abilities/zinn-cache/warm-cache/runmanage_optionsなし