From a52a9603476534389e77e9f604b2767ee50b6c69 Mon Sep 17 00:00:00 2001
From: cit110 <840418418@qq.com>
Date: Sun, 26 Apr 2026 15:23:47 +0800
Subject: [PATCH] Document UE MCP usage

---
 AGENTS.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 9bebf3d..749e6bd 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -45,6 +45,14 @@
 - Git/仓库 Agent 在每次修改完成后负责提交并推送当前改动，不保留已完成但未提交的工作树。
 - 相机/输入/运动/战斗之间的接口冲突、是否使用蓝图/DataAsset、是否引入插件模块依赖，统一由总架构裁决。
 
+## UE-MCP 使用约定
+- 本项目已配置 Codex MCP server：`ue_mcp`。
+- 需要操作 Unreal Editor 时，先调用 `project(action="get_status")`，确认 `editorConnected=true` 且项目为 `D:\ue\Projects\PHY\PHY.uproject`。
+- UE Editor 侧桥接端口为 `ws://localhost:9877`，由项目插件 `UE_MCP_Bridge` 提供。
+- 如果 MCP 工具未暴露，检查 `C:\Users\cit11\.codex\config.toml` 中 `[mcp_servers.ue_mcp]` 是否存在并启用，然后重启 Codex。
+- 使用 MCP 修改资产、蓝图或关卡前必须先读取现状；C++ 和配置文件仍按项目优先级优先于蓝图/DataAsset。
+- MCP 写操作完成后仍需按本文件的验证、提交和推送规则收尾。
+
 ## 相机规则
 - 项目相机主入口统一使用 Ultimate Gameplay Camera，即 `AuroraDevs_UGC`。
 - `GenericCameraSystem` 和 `SLSCameraModeSystem` 只允许作为插件内部依赖、示例资产参考或薄适配层依赖；项目玩法层尽可能不用。