企业官网建设流程全解析

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/ZTools

ZTools 是一款开源的高性能应用启动器和插件平台（uTools 的开源实现），它内置了一个开箱即用的 MCP 服务器。只需在设置中开启开关、复制带密钥的服务地址，再把它填进 AI 客户端，ChatGPT、Claude 等助手就能直接调用你 ZTools 里的应用和插件命令——真正打通 AI 与桌面工作流。

ZTools内置MCP服务器是什么？

如果你用过 MCP（Model 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?key=xxxx的完整地址

💡 密钥由系统自动生成（16 字节随机十六进制），保存在本地配置中，无需手动填写。设置页实现见 McpServiceSetting.vue。

第二步：把带密钥的地址填入AI客户端

不同 AI 客户端的入口略有差异，但思路完全一致——把 MCP 服务器当作一个 HTTP 类型服务添加：

为什么地址里要带密钥？看 mcpServer.ts 的鉴权逻辑：它同时支持标准的Authorization: Bearer请求头和?key=查询参数两种鉴权方式。很多 MCP 客户端不方便配置请求头，用 URL 参数携带密钥是最省事的方式——这也正是设置页「复制」按钮自动拼接密钥的原因。

第三步：让AI调用你的启动器命令

配置完成后，在 AI 对话中就可以直接下达指令了，例如：

• 「帮我打开微信」
• 「用 ZTools 的剪贴板插件查看内容」
• 「启动 IntelliJ IDEA 并打开项目目录」

背后的工作机制是这样的：

1. AI 客户端先发起initialize，ZTools 返回服务器信息与能力声明
2. 客户端通过tools/list拉取工具清单，工具名格式为插件名_工具名（如clipboard_get），全局唯一，命名规则见 tools.ts
3. 真正执行时走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。

常见问题快速排查

⚠️安全提示：服务监听全部网卡，密钥相当于通行密码。如果不需要跨设备访问，请勿把带密钥的地址分享给他人。

延伸阅读

• 插件开发（含 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