内容
Kaseya 报价管理器 MCP 服务器
Status](https://github.com/wyre-technology/kaseya-quote-manager-mcp/actions/workflows/release.yml/badge.svg)](https://github.com/wyre-technology/kaseya-quote-manager-mcp/actions/workflows/release.yml)
[](https://opensource.org/licenses/Apache-2.0)
[](https://nodejs.org/)
一个 [模型上下文协议（MCP）](https://modelcontextprotocol.io/) 服务器，为 AI 助手提供 **只读** 访问 [Kaseya 报价管理器](https://help.quotemanager.kaseya.com/)（Datto Commerce）—— 报价、销售订单、采购、产品目录和客户。
> 由 [Wyre Technology](https://github.com/wyre-technology) 维护。
## 快速入门
**Claude Desktop** — 下载、打开、完成：
1. 从 [最新版本](https://github.com/wyre-technology/kaseya-quote-manager-mcp/releases/latest) 下载 `kaseya-quote-manager-mcp.mcpb`
2. 打开文件（双击或拖入 Claude Desktop）
3. 在提示时输入您的 Kaseya 报价管理器 **API 密钥**
**Claude Code（命令行界面）：**
```bash
claude mcp add kaseya-quote-manager-mcp \
-e KASEYA_QUOTE_MANAGER_API_KEY=您的-api-密钥 \
-- npx -y github:wyre-technology/kaseya-quote-manager-mcp
```
## 身份验证
报价管理器通过在 `apiKey` 头部发送的单个 **API 密钥** 进行身份验证。在报价管理器下的 **设置 → API** 中生成一个。将其设置为 `KASEYA_QUOTE_MANAGER_API_KEY`。
## 功能
- **设计为只读** —— 报价管理器 API 仅公开 `list`/`get`；没有工具可以修改您的数据。
- **39 个实体工具**，涵盖 5 个领域，以及 `kqm_navigate` / `kqm_status` 发现工具。
- **决策树导航** —— 调用 `kqm_navigate` 以探索某个领域的工具。
- **速率限制** —— 尊重 API 的 60 req/min 限制，并在 429/5xx 时重试。
- **双重传输**（本地）和 HTTP Stream网关/D- **MCPB 打包**，适用于一键式 Claude Desktop 安装。
## 领域和工具命名为 `kqmlist` 和 `k实体>_get`。
| | 实体 |
|--------|----------|
| `sales` | 报价，报价章节，报价行，销售订单行，销售 |
| `procurement` | 采购订单，采购订单行，采购订单成本，供应商，产品供应商 |
| `catalog` | 产品，产品图片（仅列表），类别，品牌 |
| `crm`客户，客户地址，联系人 |
| `org` | 员工，仓库 |
`list`接受 `page`、`pageSize`（最大 100）和 `modifiedAfter`（如果支持），以及筛选器（例如 `quoteNumber`、`customerID`、`purchaseOrderID`）。
## 使用```
kqm_navigate {": "sales" }
kqm_quote_list { "page": "pageSize": kqm_quote_get { "id": 123kqm_list { "quoteID": 12345 }
```
## Docker
```bash
docker build -t-quote-manager-mcp .
dockerrm -p 80800 \
-e MCP_TRANSPORT=http \
-eYA_QUOTE_MANAGER_API_KEY=您的-api-密钥 \
kaseya-quote-manager-mcp
# 健康curl localhost:8080```
在 WYRE MCP 网关中，镜像以 `AUTH_MODE=gateway` 运行；网关将密钥作为 `x-kaseya-quote-key` 头部注入每个请求。
## 开发
```npm install
npm run build
npm test
npm run lint
```
## 许可证
Apache-2.0 © WYRE Technology
