必须启用mcp协议栈并配置服务才能让waker调用外部系统能力：勾选「enable mcp protocol stack」，编辑.qoder/config.yaml声明本地stdio或远程streamable-http服务，右键「reload mcp configuration」加载，状态栏显示活跃服务数即生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让QoderWake创建的Waker实体能主动调用外部系统能力（如读取钉钉文档、检索乐鑫芯片手册、查询ROS2节点），必须通过MCP协议完成能力注册与上下文绑定，否则Waker仅能基于对话历史推理，无法“动手做事”。
确认Waker运行环境支持MCP
打开QoderWake设置 →「高级」→「协议栈」→ 确保【Enable MCP Protocol Stack】已勾选。未启用时，所有MCP连接器将静默失效，界面不报错但日志显示“no mcp server available”。
重启QoderWake使协议栈生效。若使用JetBrains IDE插件，需额外进入Settings → Languages & Frameworks → Qoder → Advanced同步勾选。
在Waker配置中注入MCP服务定义
Waker本身不直接管理MCP连接，而是通过其绑定的项目级配置加载服务。需编辑项目根目录下的.qoder/config.yaml文件，在mcpServers节点下声明服务：
方法一：本地STDIO方式（推荐开发验证）
适用于已部署本地MCP Server（如钉钉MCP Server、ROS2 MCP Server）：mcpServers: dingtalk-docs-mcp: command: "npx" args: ["-y", "dingtalk-mcp@latest"] env: DINGTALK_Client_ID: "your_client_id" DINGTALK_Client_Secret: "your_client_secret"
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
方法二：远程Streamable HTTP方式（适用于乐鑫等官方MCP服务）
注意：必须指定transport: streamable-http，否则默认走SSE协议导致405错误：mcpServers: espressif-docs: url: "https://mcp.espressif.com/docs" transport: "streamable-http" headers: Authorization: "Bearer your_oauth_token"
⚠️ 乐鑫MCP服务不支持自动OAuth发现，【必须手动获取并填入Bearer Token】，可通过npx mcp-remote --server https://mcp.espressif.com/docs启动代理并完成交互式授权获取。
触发Waker加载MCP上下文
第一步：右键点击项目根目录 → 选择「Qoder → Reload MCP Configuration」。
第二步：等待状态栏提示「MCP services reloaded (2 active)」，数字应与config.yaml中定义的服务数量一致。
第三步：在Waker对话框中输入指令，例如“查一下钉钉知识库里关于审批流的最新文档”，QoderWake会自动匹配dingtalk-docs-mcp服务并发起检索。
这一步操作起来很简单，直接右键触发即可，无需重启Waker进程。但若服务名拼写错误或环境变量缺失，状态栏只会显示“reloaded (0 active)”，此时需检查config.yaml缩进和引号是否为英文字符。
