wpagent-mcp

wpagent-mcp

Claude、またはMCP互換クライアントが、プラグイン、コンテンツ、テーマ、メニュー、メディア、ユーザー、WooCommerce、Elementor、WP-CLIなど、WordPressサイトを実際に操作できるMCPサーバーです。

無料のWpAgentブリッジプラグインを通じて、すべてのリクエストにHMAC-SHA256署名を付与するREST APIでサイトと通信します。サイトの認証情報は使用せず、データがサードパーティのサービスを経由することもありません。接続はクライアントからお使いのWordPressへ直接行われます。

インストール

事前にインストールするものはありません。以下の設定により、必要に応じて取得されます。

1. WordPressサイトにWpAgentプラグインをインストールして有効化します。
2. WordPressの管理画面でWpAgentを開き、APIキーを生成します。アシスタントに付与する権限を選択してください。まずは読み取り専用キーから始めるのが安全です。
3. MCPクライアントにサーバーを追加します。Claude Desktopの場合は、claude_desktop_config.jsonに次のように設定します。

{
  "mcpServers": {
    "wpagent": {
      "command": "npx",
      "args": ["-y", "wpagent-mcp"],
      "env": {
        "WP_SITE_URL": "https://your-site.com",
        "WP_API_KEY_ID": "wpaia_xxxxxxxxxxxx",
        "WP_API_SECRET": "the secret shown once when you generated the key"
      }
    }
  }
}

Claude Codeの場合：

claude mcp add wpagent \
  --env WP_SITE_URL=https://your-site.com \
  --env WP_API_KEY_ID=wpaia_xxxxxxxxxxxx \
  --env WP_API_SECRET=... \
  -- npx -y wpagent-mcp

環境変数

変数	必須	説明
WP_SITE_URL	はい	サイトのベースURL。末尾にスラッシュは付けません
WP_API_KEY_ID	はい	プラグインに表示されるキーID
WP_API_SECRET	はい	キー生成時に一度だけ表示されるシークレット
WP_SITE_LABEL	いいえ	わかりやすい名前。デフォルトはホスト名です

できること

分野	例
プラグイン	一覧表示、wordpress.orgで検索、インストール、有効化、無効化、更新、削除
コンテンツ	投稿、ページ、商品、あらゆるカスタム投稿タイプ。メタデータやアイキャッチ画像にも対応
テーマ	一覧表示、検索、インストール、有効化、テーマ設定、カスタムCSS、ロゴ、色
WooCommerce	設定、注文、クーポン、配送地域、決済ゲートウェイ、税率、統計
構造	メニュー、ウィジェット、サイドバー、タクソノミー、ターム、リダイレクト
メディア	閲覧、アップロード、削除
ユーザーとコメント	一覧表示、作成、更新、モデレート
監査	セキュリティ、SEO、パフォーマンスに関するベストプラクティスのチェックと自動修正
WP-CLI	許可リストに登録されたコマンド。wp-config.phpで有効化されない限りオフ

できないこと

このAPIから任意のPHPコードやデータベース、wp-config.phpにアクセスすることはできません。サイト所有者がサーバーでdefine('WPAIA_ENABLE_WPCLI', true);を追加しない限り、WP-CLIの実行は無効です。有効化した場合でも、許可リストに登録されたコマンドのみ実行されます。db、eval、eval-file、shell、server、config、packageは常に拒否されます。

安全性

• すべてのリクエストにHMAC-SHA256署名とタイムスタンプが付与され、5分を超えたリクエストは拒否されます。
• 権限はキーごとに設定され、すべてのルートで確認されるため、読み取り専用キーは読み取り専用のままです。
• すべての呼び出しは監査ログに記録され、WordPressの管理画面で確認できます。
• WordPressでキーを取り消すと、即座に反映されます。

破壊的な操作の前にはアシスタントに確認を求め、最新のバックアップを保管してください。指示すれば、コンテンツを削除できます。

関連情報

• WpAgent — 同じブリッジを基盤とするホスト型ダッシュボード。無料の読み取り専用プランがあります
• ブリッジプラグインはGPL-2.0-or-later、このサーバーはMITライセンスです。

ライセンス

MIT © KipDev