必须启用mcp协议并正确接入服务，ai才能真正操作代码、读取文件、调用数据库或执行自定义逻辑；否则仅停留在生成建议阶段。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Trae中让AI真正操作你的项目代码、读取本地文件、调用数据库或执行自定义逻辑，而不是只生成建议或伪代码，就必须启用MCP协议并正确接入对应的服务。这一步跳过，AI就始终停留在“嘴上功夫”阶段。
确认Trae已激活MCP Host运行时
打开Trae IDE → 点击右上角齿轮图标进入设置 → 左侧导航栏选择“AI Management” → “MCP”选项卡。
页面顶部必须显示【MCP Host is active】绿色提示；若显示“Not available”，说明当前版本低于2.4.0，需立即升级至最新稳定版，否则后续所有配置均无效。
检查下方“MCP Servers”列表是否为空——非空表示已有服务注册，可直接进入验证环节；为空则继续下一步配置。
从MCP市场一键添加通用能力
适用于快速启用文件读写、JSON解析、HTTP请求等高频功能，无需写一行代码。
在MCP设置页点击“Add MCP Servers”按钮 → 搜索框输入“Filesystem” → 选择官方认证的“Filesystem MCP Server”条目 → 点击“Install”。
安装完成后点击右侧“Configure”，在JSON编辑区修改"--allowed-paths"参数，填入你项目实际所在目录，例如："D:\my-project\src,D:\my-project\data"。⚠️不配置此字段，AI将无法访问任何本地路径。
保存后返回列表，确认状态栏显示“Running”且无红色错误图标——此时@Builder with MCP智能体已能直接读取、修改你指定目录下的任意文件。
手动接入自定义Python MCP服务
当你需要AI调用项目专属逻辑（如订单校验、接口签名、Swagger解析）时，必须编写并注册自己的MCP Server。
第一步：在项目根目录新建mcp_order_validator.py，粘贴最小可行代码：
from mcp.server.fastmcp import FastMCP<br>mcp = FastMCP("OrderValidator")<br>@mcp.tool()<br>def validate_order(order_id: str) -> dict:<br> return {"valid": True, "reason": "passed"}
第二步：终端执行pip install "mcp[cli]"；若用uv，则运行uv add "mcp[cli]"。
第三步：运行python mcp_order_validator.py，控制台必须输出【MCP server 'OrderValidator' started on stdio】字样，否则服务未启动成功。
第四步：回到Trae设置→MCP→“Add Manually”，填入JSON配置（注意替换真实路径）：
{"mcpServers":{"order-validator":{"command":"python","args":["D:\my-project\mcp_order_validator.py"]}}}
保存后，该服务即刻出现在MCP Servers列表中，状态变为“Running”。现在你在对话中对@Builder with MCP说“校验订单ID ORD-789”，AI会自动触发validate_order函数并返回结果。
