# 智能体接入概览

> 效率工具箱提供 MCP 服务与 CLI 命令行两条对外调用通道，让第三方 AI 智能体和自动化脚本直接调用工具箱的近 400 个本地工具能力。

- 分类：智能体接入
- 关键词：智能体、MCP、CLI、自动化、接入、AI 客户端、工具调用、命令行
- 在线原文：https://www.xyltools.com/docs/agent-integration-overview

---

## 什么是智能体接入

效率工具箱不仅是一个桌面应用，还是一个可被外部程序调用的本地工具平台。工具箱内置的文件搜索、PDF 处理、图片处理、Office 文档、打印管理等近 400 个工具能力，全部通过两条标准通道对外开放：MCP 服务和 CLI 命令行。

- MCP 服务：面向 AI 智能体客户端。您在 AI 客户端里用自然语言提出需求（例如"帮我把这几个 PDF 合并"），AI 自动选择并调用工具箱的对应工具完成任务。
- CLI 命令行：面向脚本和程序。在 PowerShell、Python、批处理等脚本中直接执行工具箱命令，用于批量处理和流程自动化。

> **同一套工具引擎**：两条通道背后是同一套工具注册表和执行引擎，能力完全一致。区别只在调用方式：MCP 是给 AI 用的结构化协议，CLI 是给脚本用的命令行接口。

## MCP 还是 CLI？

两条通道各有侧重，按调用方类型选择即可。

| 对比项 | MCP 服务 | CLI 命令行 |
| --- | --- | --- |
| 适用调用方 | AI 智能体客户端（对话式） | 脚本、程序、计划任务 |
| 工具发现 | 客户端自动获取全部工具清单和参数说明 | 执行 --list 查看命令列表 |
| 参数构造 | AI 根据参数说明自动构造，出错率低 | 手工按参数名传入 |
| 输出形式 | 结构化 JSON 结果，AI 直接理解 | 文本输出协议 + 进程退出码 |
| 运行模式 | 长驻后台进程，客户端启动后持续可用 | 每次调用启动一次，执行完退出 |
| 推荐场景 | 日常对话式办公、让 AI 替你操作文件 | 定时批量任务、与自有系统集成 |

> **给 AI 智能体接入，永远优先选 MCP**：MCP 通道为每个工具提供了完整的参数结构说明（Schema），AI 能精确构造调用参数；CLI 更适合固定流程的脚本自动化。

## 使用前提与授权说明

两条通道共用同一道授权门：调用前需在效率工具箱内登录账号，且订阅在有效期内。未满足条件时，工具调用会返回明确的错误说明（CLI 以退出码 3 标识未授权），不会静默失败。

1. **安装并登录效率工具箱**：确保本机已安装效率工具箱，并在主界面完成账号登录。
2. **确认订阅有效**：在「账户与订阅」中确认订阅处于有效期内。订阅到期后两条通道均会拒绝调用。
3. **选择通道开始接入**：AI 客户端请阅读「MCP 服务接入」；脚本自动化请阅读「CLI 命令行调用」。

> **关于计费**：通过 MCP / CLI 调用的本地工具（文件、PDF、图片处理等）不额外收费；若调用涉及在线 AI 能力的工具，按正常在线 AI 规则扣费，详见「在线AI调用扣费说明」。

## 相关文章

---

## 相关文章

- [MCP 服务接入](https://www.xyltools.com/docs/mcp-server-guide)
- [CLI 命令行调用](https://www.xyltools.com/docs/cli-command-reference)
- [在线AI调用扣费说明](https://www.xyltools.com/docs/ai-billing-explanation)