diff --git a/xiaoqu-franchisee/doc/agent-mcp-service-design.md b/xiaoqu-franchisee/doc/agent-mcp-service-design.md
index cef31f1..bb90806 100644
--- a/xiaoqu-franchisee/doc/agent-mcp-service-design.md
+++ b/xiaoqu-franchisee/doc/agent-mcp-service-design.md
@@ -216,7 +216,6 @@ xiaoqu-agent-service/
 - 已裁剪：开票信息、银行账户。
 
 ## 10. 已明确的取舍记录
-
 - 不移植字段级（page_field 六表）功能权限 → 用 scope 替代，更简单且服务端强制
 - 作用域纯手工配置，不做代码内默认归属 → 新工具默认关闭
 - 工具分类（category）代码注册时声明，页面只读 → 分类与代码业务归属不漂移
@@ -224,3 +223,19 @@ xiaoqu-agent-service/
 - CLI 复用 `/mcp` 端点做 MCP 客户端，不开第二套服务 → 权限逻辑只有一份；Go 单二进制分发，与服务端 Java 栈解耦
 - 不依赖老 jar，Entity 自行生成 → 与老系统零代码依赖
 - 前后端一体打包单 jar → 可逆决定，将来可拆
+
+## 11. 开发环境（dev）
+
+**本机即开发环境并兼任部署机**：程序直接跑在本机，dev 阶段裸跑 HTTP（§8），端口避开老系统的 8091。数据库/Redis/ES 连接信息沿用 `xiaoqu-franchisee/pom.xml` dev profile：
+
+| 组件 | 地址 | 账号 | 库/DB |
+|---|---|---|---|
+| MySQL m0（权限库） | 192.168.1.181:3306 | root | `xiaoqu_comples_d`（user/agent/authority/代管物业表在此） |
+| MySQL m1（商城库） | 192.168.1.181:3306 | root | `xiaoqu_mall_d`（按需启用） |
+| MySQL m2（业务库） | 192.168.1.181:3306 | root | `xiaoqu_franchisee_d`（warehouse_agent_auth 在此） |
+| Redis | 192.168.1.181:6379 | 密码见 pom dev | db5（`entity:User:{id}`、Dictionary）、db13 |
+| ES | 192.168.1.152:9200 | 无认证 | 预留，一期不用 |
+
+- 密码等敏感值不入库本文档，以 `pom.xml` dev profile 为准；新系统 `application-dev.yml` 引用同名环境变量。
+- 自有库表（§7）建在同实例新 schema：dev 用 `xiaoqu_agent_svc_d`（沿用 `_d` 后缀约定），首次部署前手工建库。
+- 新系统与老的 dev 后端（Jetty 8091）可同时运行，互不干扰——注意两边连的是**同一套** dev 数据库和 Redis，老系统dev库的数据变动会同时影响两边的查询结果。