增加 SuperAgent MCP 内嵌接口和配置文档

README.md

@@ -11,6 +11,9 @@ client/
 server/
 后端 Spring Boot 服务目录。后端负责数据库、外部系统适配、业务规则、安全脱敏和审计边界。
 
+mcp-server/
+SuperAgent MCP 方案入口指针。当前不单独部署 MCP 服务，运行时代码内嵌在 `server/`，对外资料包位于 `docs/project/integrations/superagent-mcp/`。
+
 docs/
 项目文档、可复用规范、当前项目需求和外部系统接入记录。
 ```
@@ -67,6 +70,19 @@ http://127.0.0.1:5174/debug/eml-superagent
 
 中文说明：该页面只用于 dev/test 受控调试。Debug 上传口令必须由调试人员在页面手动输入，不能写入 `VITE_*`、源码、localStorage、sessionStorage、URL、错误上报或普通日志。
 
+## SuperAgent MCP
+
+当前 MCP 采用后端内嵌方式，不需要额外部署独立服务。启用示例：
+
+```bash
+cd server
+MCP_ENABLED=true MCP_AUTH_TOKEN=test-token MCP_ENABLE_SUBMIT_TASK_RESULTS=false ./mvnw spring-boot:run
+```
+
+中文说明：SuperAgent 通过 `POST /mcp` 调用 5 个 MCP tools。写入工具由 `MCP_ENABLE_SUBMIT_TASK_RESULTS`
+单独控制，生产启用前需要单独确认。MCP 单次请求体默认限制为 10MB，可通过 `MCP_MAX_BODY_BYTES`
+调整。
+
 ### 测试数据库配置
 
 默认 `test` profile 使用 H2 MySQL Mode，便于本地和 CI 在没有 MySQL 的情况下运行：