ZTools内置MCP服务器完整指南3步让AI客户端调用你的启动器命令打通AI与桌面工作流【免费下载链接】ZToolsAn open-source implementation of uTools, a high-performance, scalable application launcher and plugin platform | Supports macOS and Windows, 一个高性能、可扩展的应用启动器和插件平台 uTools 的开源实现 | 支持 macOS 和 Windows项目地址: https://gitcode.com/gh_mirrors/ztool/ZToolsZTools 是一款开源的高性能应用启动器和插件平台uTools 的开源实现它内置了一个开箱即用的 MCP 服务器。只需在设置中开启开关、复制带密钥的服务地址再把它填进 AI 客户端ChatGPT、Claude 等助手就能直接调用你 ZTools 里的应用和插件命令——真正打通 AI 与桌面工作流。ZTools内置MCP服务器是什么如果你用过 MCPModel Context Protocol模型上下文协议应该知道它解决的核心问题让 AI 不再只会聊天而是能真正动手——调用工具、访问本地能力。ZTools 把这个能力做成了内置功能零安装MCP 服务器直接运行在 ZTools 主进程中不用额外部署标准协议遵循 MCP 规范协议版本2025-06-18单一 HTTP 端点承载 JSON-RPC 2.0 请求密钥鉴权自动生成随机 API Key未带密钥的请求一律拒绝工具即插件任何插件只要声明了tools就会自动出现在 MCP 工具列表里服务逻辑集中在 mcpServer.ts默认监听36579固定端口端点为http://127.0.0.1:36579/mcp并且监听全部网卡地址局域网内其他设备也能通过本机 IP 访问。第一步在设置中启用MCP服务打开 ZTools 设置窗口进入 MCP 服务设置页只需勾选「启用 MCP 服务」开关服务即刻启动该页面会自动展示服务地址http://127.0.0.1:36579/mcp运行状态绿色圆点表示「服务运行中」一键复制按钮复制时会自动拼上访问密钥得到形如http://127.0.0.1:36579/mcp?keyxxxx的完整地址 密钥由系统自动生成16 字节随机十六进制保存在本地配置中无需手动填写。设置页实现见 McpServiceSetting.vue。第二步把带密钥的地址填入AI客户端不同 AI 客户端的入口略有差异但思路完全一致——把 MCP 服务器当作一个 HTTP 类型服务添加AI 客户端添加位置填写内容Cherry Studio设置 → MCP → 新增类型选 SSE/HTTP地址粘贴带?key的完整地址Claude Desktopclaude_desktop_config.json使用支持 HTTP 的 MCP 代理指向该地址Cline / 其他MCP 服务器配置同上粘贴带密钥地址即可为什么地址里要带密钥看 mcpServer.ts 的鉴权逻辑它同时支持标准的Authorization: Bearer请求头和?key查询参数两种鉴权方式。很多 MCP 客户端不方便配置请求头用 URL 参数携带密钥是最省事的方式——这也正是设置页「复制」按钮自动拼接密钥的原因。第三步让AI调用你的启动器命令配置完成后在 AI 对话中就可以直接下达指令了例如「帮我打开微信」「用 ZTools 的剪贴板插件查看内容」「启动 IntelliJ IDEA 并打开项目目录」背后的工作机制是这样的AI 客户端先发起initializeZTools 返回服务器信息与能力声明客户端通过tools/list拉取工具清单工具名格式为插件名_工具名如clipboard_get全局唯一命名规则见 tools.ts真正执行时走tools/call若插件尚未运行ZTools 会后台自动预加载插件等待其注册工具处理器后再执行全程无需你手动打开插件注意AI 只能看到插件在plugin.json中声明、且通过ztools.registerTool(name, handler)注册过的工具调用入口定义在 preload.js。这是刻意设计的安全边界——未声明的能力对 AI 完全不可见。按插件开关MCP工具隐私可控并不是所有插件都该暴露给 AI。设置页中「支持 MCP 的插件」列表按插件分组展示每个插件都有独立开关关闭某个插件后它的所有 MCP 工具都会从服务端隐藏AI 将看不到这些工具点击工具旁的「详情」可以查看该工具的 JSON 描述description、inputSchema、outputSchema方便排查 AI 是否理解正确禁用列表持久化在本地配置键settings-mcp-disabled-plugins中逻辑见 tools.ts。常见问题快速排查现象原因与解决AI 提示连接失败确认 ZTools 正在运行且 MCP 开关已打开状态灯应为绿色返回「API 密钥无效」必须使用带?key的完整地址或配置 Bearer 请求头工具列表为空当前没有插件声明 MCP 工具到插件市场安装或自行开发端口冲突端口固定为 36579检查本机是否有其他服务占用局域网设备连不上服务已监听0.0.0.0用本机局域网 IP 替换127.0.0.1即可⚠️安全提示服务监听全部网卡密钥相当于通行密码。如果不需要跨设备访问请勿把带密钥的地址分享给他人。延伸阅读插件开发含 Provider 接入docs/provider-development-guide.md内置 HTTP API 说明docs/http-api.md插件市场与安装逻辑plugins.ts至此你只需要 3 步就能让 AI 客户端指挥 ZTools 打开应用、调用插件把问 AI变成让 AI 干活。这正是 MCP 生态最迷人的地方桌面能力即插即用工作流真正闭环。【免费下载链接】ZToolsAn open-source implementation of uTools, a high-performance, scalable application launcher and plugin platform | Supports macOS and Windows, 一个高性能、可扩展的应用启动器和插件平台 uTools 的开源实现 | 支持 macOS 和 Windows项目地址: https://gitcode.com/gh_mirrors/ztool/ZTools创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考