AgenticCMSに対応

.agents/skills/php-migration/SKILL.md

@@ -171,7 +171,19 @@ $code = str_increment($code);
 `__serialize()` / `__unserialize()` を使う（PHP7 互換が不要なら移行）。
 
 ### 6. `$http_response_header` の非推奨
-スーパーグローバル `$http_response_header` が非推奨。`http_get_last_response_headers()` を使う。**※ `http_get_last_response_headers()` は 8.4+。8.1 維持中は `$http_response_header` のまま据え置く。**
+スーパーグローバル `$http_response_header` が 8.5 で非推奨。`http_get_last_response_headers()` を使う。**※ `http_get_last_response_headers()` は 8.4+** なので、8.1 互換を維持するなら**素朴な置換は不可**（8.1〜8.3 で undefined function の fatal になる）。
+- **8.1〜8.5 を一度に満たす互換パターン**（推奨）: 関数があれば使い、無ければ従来のスーパーグローバルにフォールバックする。8.5 では関数経由になるので非推奨を回避でき、8.1〜8.3 では関数が無いので `if` を素通りし、その下の `isset($http_response_header)`（直前の `file_get_contents` 等が設定するスーパーグローバル）を読む——どのバージョンでも fatal にならない。
+  ```php
+  // file_get_contents() 等の HTTP 取得直後
+  if (function_exists('http_get_last_response_headers')) { // 8.4+
+      $http_response_header = http_get_last_response_headers();
+  }
+  if (isset($http_response_header)) {                       // 8.1〜8.3 は従来のスーパーグローバルを参照
+      foreach ($http_response_header as $header) { /* Content-Type 抽出等 */ }
+  }
+  ```
+- **症状**: 8.5＋テスト（`Error.errorLevel = E_ALL`）では、このスーパーグローバル参照の非推奨が顕在化し、ファイル取得系を通るテストが不安定化・失敗することがある（baserCMS 実績: `BcMcp\Mcp\BaseMcpTool` の URL 画像取得で Content-Type 判定に使用）。
+- 単純に「8.1 維持中は据え置き」でも 8.5 では警告のみで動作はするが、テストを通すなら上記の互換パターンで解消する方が確実。
 
 ### 7. バッククォート演算子の非推奨
 `` `command` ``（`shell_exec()` のエイリアス）が非推奨。`shell_exec()` を直接使う。

.github/instructions/basercms.instructions.md

@@ -12,6 +12,11 @@ baserCMSの開発についての指示をまとめたものです。
 - プラグインが見つからない場合は `BcUtil::includePluginClass()` を利用。
 - APIテストは `/baser/api/admin/baser-core/users/login.json` で認証→トークン取得→各API呼び出し。
 - CI/CDはGitHub Actions（`test.yml`）で自動化。主要コマンドは `composer install`、`docker compose up`。
+- **外部プロセス（MCPサーバー等）に依存するテストの方針**:
+  - 必要なプロセスは**該当テスト側で起動**し、`setUp` 全体ではなく**それを要する個別テストの先頭**でガードする（他テストに起動待ちを波及させない）。
+  - 起動判定は「プロセスの存在（pidファイル）」だけで済ませない。**プロキシ等が実際に接続する先（例 `127.0.0.1:{port}`）へ到達できるまで待つ**（`fsockopen` 等でポーリング、最大十数秒）。プロセス起動直後はポートの bind が間に合わず接続拒否＝500 になり、CI でのみ失敗する典型。
+  - **到達できない場合は `markTestSkipped` で隠さず、`assertTrue` 等で明示的に失敗させる**。スキップはサーバー起動の不具合を握りつぶし CI を緑にしてしまうため不可。「外部プロセスが動いていること」も統合テストの検証対象とみなす。
+  - 実装例: `plugins/bc-mcp/tests/TestCase/Controller/Admin/OAuth2ControllerTest.php` の `requireMcpServer()`。
 
 ## コーディング規約・パターン
 - クラスに新メソッド追加時は「必ず最後」に追加。

.github/workflows/split_monorepo.yml

@@ -41,6 +41,8 @@ jobs:
             split_repository: 'bc-installer'
           - local_path: 'bc-mail'
             split_repository: 'bc-mail'
+          - local_path: 'bc-mcp'
+            split_repository: 'bc-mcp'
           - local_path: 'bc-search-index'
             split_repository: 'bc-search-index'
           - local_path: 'bc-seo'

.gitignore

@@ -90,6 +90,7 @@ yarn-error.log
 !/plugins/BcColumn
 !/plugins/bc-seo
 !/plugins/bc-burger-editor
+!/plugins/bc-mcp
 /plugins/*/vendor
 /plugins/*/composer.lock
 /profile/*
@@ -121,6 +122,7 @@ node_modules
 /webroot/bc_installer
 /webroot/bc_custom_content
 /webroot/bc_burger_editor
+/webroot/bc_mcp
 /webroot/bc_spa_sample
 /webroot/debug_kit
 /webroot/.gitignore

composer.json

@@ -9,6 +9,7 @@
         "ext-gd": "*",
         "ext-json": "*",
         "ext-mbstring": "*",
+        "ext-openssl": "*",
         "ext-pdo": "*",
         "ext-sqlite3": "*",
         "ext-zip": "*",
@@ -20,9 +21,13 @@
         "ezyang/htmlpurifier": "~4.19.0",
         "firebase/php-jwt": "~7.0.2",
         "josegonzalez/dotenv": "~4.0.0",
+        "league/oauth2-server": "^8.5",
+        "logiscape/mcp-sdk-php": "^2.0",
         "mobiledetect/mobiledetectlib": "~3.74.4",
-        "psr/http-message": "^1.0",
-        "robmorgan/phinx": "0.16.10"
+        "nyholm/psr7": "~1.8.2",
+        "psr/http-message": "~1.1",
+        "robmorgan/phinx": "0.16.10",
+        "symfony/psr-http-message-bridge": "~2.3.1"
     },
     "require-dev": {
         "ext-xdebug": "*",
@@ -47,6 +52,7 @@
         "baserproject/bc-front": "5.4.x",
         "baserproject/bc-installer": "5.4.x",
         "baserproject/bc-mail": "5.4.x",
+        "baserproject/bc-mcp": "5.4.x",
         "baserproject/bc-plugin-sample": "5.4.x",
         "baserproject/bc-search-index": "5.4.x",
         "baserproject/bc-seo": "5.4.x",
@@ -77,6 +83,7 @@
             "BcFront\\": "plugins/bc-front/src/",
             "BcInstaller\\": "plugins/bc-installer/src/",
             "BcMail\\": "plugins/bc-mail/src/",
+            "BcMcp\\": "plugins/bc-mcp/src/",
             "BcPluginSample\\": "plugins/BcPluginSample/src/",
             "BcSearchIndex\\": "plugins/bc-search-index/src/",
             "BcSeo\\": "plugins/bc-seo/src/",
@@ -99,6 +106,7 @@
             "BcFavorite\\Test\\": "plugins/bc-favorite/tests/",
             "BcInstaller\\Test\\": "plugins/bc-installer/tests/",
             "BcMail\\Test\\": "plugins/bc-mail/tests/",
+            "BcMcp\\Test\\": "plugins/bc-mcp/tests/",
             "BcSearchIndex\\Test\\": "plugins/bc-search-index/tests/",
             "BcSeo\\Test\\": "plugins/bc-seo/tests/",
             "BcThemeConfig\\Test\\": "plugins/bc-theme-config/tests/",