AI Agent 与 MCP 接入
将本机 Agent 连接到 DeskPulse,辅助配置 HTTP 数据源、创建和预览可编辑主题。
桌面 App 可通过本机 MCP 服务,让 AI Agent 配置 HTTP 数据源、创建和修改可编辑主题、校验并生成预览。服务默认关闭,使用时需要 DeskPulse 保持运行。
开启与连接
- 打开“应用设置 → AI Agent 接入”,开启服务,确认显示“服务运行中”。
- 点击“复制接入指令给 Agent”,发给你使用的本机 Agent;也可选择“一键配置 Codex”或“一键配置 Claude Code”。
- 一键配置会写入本机客户端配置并备份原文件。按提示重新加载客户端或新建会话,让 Agent 确认连接。
- 自定义客户端可以使用“手动配置”中的对应配置片段。地址以 App 显示为准,默认本机端口为 47831。
接入配置包含访问令牌,请只交给信任的 Agent。修改端口或重置令牌后,需重新配置客户端;端口被占用时可换成 1024–65535 中可用的端口并重连。关闭开关或完全退出 DeskPulse 会停止服务。
从需求到设备主题
可以向 Agent 提出这样的任务:
创建一个 320×240 的桌面主题,显示 CO₂、在位状态和番茄钟;CO₂ 高于 800 时将文字变红。保存为新的本地主题,给我预览。
Agent 可以读取设计能力、保存本地项目和素材、校验布局,并生成使用预览样例的图片。随后在 App 主题编辑器打开项目,检查字体、布局、数据源和目标设备,再由你点击“发布”。
MCP 只编辑本地草稿,不会自动发布到设备、刷写固件或执行本地插件。 生成预览使用样例数据,视频只取首帧,不代表设备当前真实读数。
HTTP 数据源的验证
App 0.1.7 起,Agent 编辑和校验的是当前主题内的 HTTP 定义,不再使用全局 HTTP 配置。个人参数值单独保存在本机,不进入主题导出包或市场快照。
Agent 的试请求从电脑发出。电脑能够访问接口,不等于设备也能访问,例如仅监听电脑本机或依赖代理的接口。需要时在 App 主题编辑器的“HTTP 数据源”中执行“设备试请求”。
保存数据源只修改本地配置。要让设备采用新 URL、Header、字段或刷新间隔,仍需重新发布引用它的主题。完整用法见数据源与本地插件。
与其他 AI 功能的区别
MCP 连接到你选择的本机 Agent,供其辅助创作;“数据源”里的 Codex 集成用于显示状态和额度;首页“AI 洞察”是独立在线服务。开启其中一个不代表另外两个已经配置或开放,详见在线服务。