# MCP 服务接入

> 将效率工具箱作为 MCP 服务器接入任意支持 MCP 协议的 AI 客户端：一键勾选接入、手动配置方法、协议兼容说明与常见问题排查。

- 分类：智能体接入
- 关键词：MCP、MCP 服务器、AI 客户端、stdio、一键接入、yinlian-toolbox、工具调用、接入配置
- 在线原文：https://www.xyltools.com/docs/mcp-server-guide

---

## 功能简介

MCP（Model Context Protocol）是 AI 行业通用的工具调用协议。效率工具箱内置了标准 MCP 服务器，通过 stdio（标准输入输出）方式与 AI 客户端通信，把近 400 个本地工具能力开放给任意支持 MCP 协议的 AI 客户端。接入后，您在 AI 客户端中直接用自然语言下达任务，AI 会自动调用工具箱完成文件搜索、PDF 处理、图片处理、打印等操作。

- **服务器名称**：yinlian-toolbox
- **通信方式**：stdio（本地进程，数据不经过网络）
- **启动命令**：EfficiencyToolbox.exe --mcp-server
- **工具数量**：近 400 个（随版本更新持续增加）
- **协议兼容**：自动协商 2024-11-05 至 2026-07-28 之间的各版本 MCP 协议

## 方式一：设置页一键接入（推荐）

效率工具箱的设置页内置「MCP 接入」区，会自动检测本机已安装的十余种主流 AI 客户端（如 Claude Desktop、Cursor、Visual Studio Code、Windsurf、Trae、Qoder、Cline、WorkBuddy 等），检测到的客户端以复选框列出。

1. **打开设置页的 MCP 接入区**：在效率工具箱主界面进入「设置」，找到「MCP 接入」区域，已安装的 AI 客户端会自动出现在列表中。
2. **勾选要接入的客户端**：勾选即接入——工具箱会立即把服务器配置写入该客户端的 MCP 配置文件；取消勾选即断开。勾选状态与真实接入状态始终一致。
3. **重启该 AI 客户端**：接入后需重启对应的 AI 客户端才能生效。重启后在客户端的 MCP / 连接器管理页应能看到 yinlian-toolbox 及其工具列表。

![设置页 MCP 接入区](https://www.xyltools.com/docs/light/mcp-server-guide-1.png)

> **列表外的客户端也能纳入一键管理**：如果您使用的 AI 客户端不在自动检测列表中，可通过「添加自定义客户端」登记其配置文件路径，之后同样支持勾选接入 / 断开。

## 方式二：手动配置

任何支持 MCP 协议的客户端都可以手动接入。设置页「MCP 接入」区提供了可直接复制的配置片段（已包含本机的实际安装路径），粘贴到客户端的 MCP 配置文件即可。配置结构如下：

**MCP 客户端配置片段（示意，实际路径请从设置页复制）**

```json
{
  "mcpServers": {
    "yinlian-toolbox": {
      "command": "<安装目录>\\EfficiencyToolbox.exe",
      "args": ["--mcp-server"]
    }
  }
}
```

- command 必须指向效率工具箱的实际安装路径，建议直接从设置页复制生成好的片段，避免手写路径出错。
- 部分客户端要求额外的 "type": "stdio" 字段，设置页生成的片段和一键接入都会按目标客户端自动处理。
- 配置文件的具体位置因客户端而异，请查阅对应客户端的 MCP 配置说明。

> **让 AI 更懂工具箱**：设置页还提供一段「智能体规则文本」，可粘贴到 AI 客户端的规则 / 系统提示词中。它告诉 AI：提到"印联""效率工具箱""工具箱"等名称时都指向本服务，处理文件、PDF、图片、打印类任务时优先调用工具箱而不是自己实现。

## 工具启用数量建议

接入成功后，AI 客户端会拿到工具箱的全部工具清单。部分客户端在启用工具超过一定数量（常见阈值为 80 个）时会提示"启用工具数量过多"。这是客户端的通用性能建议，不是错误：启用的每个工具的名称、说明和参数结构都会随每轮对话发送给 AI 模型，工具越多，AI 挑选工具的准确率越可能下降，对话消耗也越高。

- 推荐做法：在 AI 客户端的工具管理面板中按需启用，只保留当前工作常用的工具组（如 PDF、图片、文件搜索），其余禁用。
- 禁用只影响该客户端本轮可见的工具，不影响工具箱本身，随时可以重新启用。
- 如果客户端支持按工具组批量开关，优先按组管理，效率更高。

## 常见问题排查

| 现象 | 原因与处理 |
| --- | --- |
| 客户端里看不到 yinlian-toolbox | 接入后未重启客户端。重启 AI 客户端；仍不出现时回到设置页确认勾选状态，取消勾选后重新勾选一次。 |
| 工具调用返回"未登录"或"订阅已到期" | MCP 与 CLI 共用授权门。打开效率工具箱主界面完成登录，或续费订阅后重试。 |
| 效率工具箱更新版本后客户端连接断开 | 更新过程会重启工具箱进程。在 AI 客户端的 MCP / 连接器管理页手动重连一次即可，配置无需改动。 |
| 客户端弹出"是否信任 / 批准该服务器" | 首次接入时部分客户端会请求信任确认，选择允许即可。配置未变时后续不会重复弹出。 |
| AI 老是选错工具 | 启用的工具太多。按上一节建议在客户端里只启用常用工具组，并粘贴设置页提供的智能体规则文本。 |

> **数据安全说明**：MCP 通道是本机进程间通信，文件内容不会因为接入而上传到任何服务器；只有当 AI 客户端本身把对话内容发给其云端模型时才会产生网络传输，这由客户端而非工具箱决定。

## 相关文章

---

## 相关文章

- [智能体接入概览](https://www.xyltools.com/docs/agent-integration-overview)
- [CLI 命令行调用](https://www.xyltools.com/docs/cli-command-reference)
- [在线AI调用扣费说明](https://www.xyltools.com/docs/ai-billing-explanation)