Tekmetric MCP Server

使用自然语言询问您的店铺数据。立即获取关于客户、车辆、维修订单、预约等信息——直接在Claude中。

<p align="center"> <img src="./docs/static/img/example.png" alt="示例：询问最大的维修订单" width="600"> </p>

⚠️ 独立社区项目

这是一个独立的、由社区构建的工具，与Tekmetric的API集成。它不是官方的Tekmetric产品，也不受Tekmetric, Inc.的支持或认可。

如需官方Tekmetric产品和支持，请访问tekmetric.com。

您可以做什么

今天的日程

显示今天的预约

哪些维修订单正在进行？

查找客户及车辆

查找客户John Smith

搜索2020款本田雅阁

查询VIN 1HGBH41JXMN109186

检查最近的工作

显示上周的估价

查找客户456的维修订单

客户123拥有哪些车辆？

分析服务历史

分析车辆12345的服务历史

获得完整的时间线，包括：

• 所有服务和更换的零件
• 花费模式和维护遵守情况
• 常见问题和建议
• 格式化为简洁的markdown表格

特点

• 自然语言 - 只需提问，无需记忆命令
• 实时数据 - 直接访问您的Tekmetric数据
• 智能搜索 - 通过名称、VIN、日期、状态等查找任何内容
• 服务历史分析 - 完整的车辆时间线，带有AI驱动的见解
• 丰富上下文 - 自动查看客户姓名、车辆详情和格式化的价格
• 快速且轻量级 - 单一可执行文件，无依赖项，即时响应

适用场景

最适合战术性、日常查询：

• 查找客户联系信息
• 通过VIN或车牌号查找车辆详情
• 检查预约时间表
• 搜索特定的维修订单
• 分析完整的服务历史时间线
• 获取技术人员分配

不适用于：

• 财务报告或会计（使用Tekmetric内置的报告）
• 收入计算或利润分析
• 大规模数据导出
• 商业智能仪表板

注意：每个查询结果限制为25条记录，以保持响应速度。对于全面的财务数据或批量导出，请使用Tekmetric的原生报告工具。

🚀 快速开始

1. 获取API凭证

重要：必须从Tekmetric请求API访问权限。

1. 访问api.tekmetric.com请求API访问权限
2. 等待2-3周审批
3. 从Tekmetric接收您的客户端ID和客户端密钥
4. 安全保存它们

2. 安装

桌面扩展（最简单）

1. 从发布页面下载tekmetric-mcp.mcpb
2. 使用Claude Desktop打开.mcpb文件
3. 配置您的API凭证
4. 开始提问！

手动安装

添加到您的Claude Desktop配置（macOS上的路径为~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "tekmetric": {
      "command": "/绝对路径/to/tekmetric-mcp",
      "args": ["serve"],
      "env": {
        "TEKMETRIC_CLIENT_ID": "您的客户端ID",
        "TEKMETRIC_CLIENT_SECRET": "您的客户端密钥",
        "TEKMETRIC_BASE_URL": "https://shop.tekmetric.com",
        "TEKMETRIC_DEFAULT_SHOP_ID": "123"
      }
    }
  }
}

3. 重启Claude Desktop

退出并重新打开Claude Desktop。查看🔌图标以验证连接。

您可以访问的数据

店铺 - 查看店铺详情、营业时间、人工费率和设置

客户 - 按姓名、电子邮件、电话搜索；查看联系信息和服务历史

车辆 - 按VIN、车牌、品牌型号查找；查看服务记录

维修订单 - 按状态、日期、客户、车辆筛选；跟踪工作和收入

任务 - 查看单独的服务、人工、零件和技术人员分配

预约 - 按日期、客户、车辆搜索；管理调度

员工 - 列出技术人员和员工，按角色和状态筛选

库存 - 检查零件库存水平和可用性（测试版）

分析工具 - 获取全面的车辆服务历史，带有智能格式化

示例查询

基本查找

显示今天的预约

查找电话为555-1234的客户

显示上周的维修订单

按VIN搜索车辆

列出所有员工

库存里有什么？

服务历史分析

分析车辆12345的服务历史

这将返回一个完整的时间线，显示：

• 每次服务访问的日期和里程数
• 执行的所有服务和更换的零件
• 人工小时和成本
• 报告的客户关注点
• 格式化为可扫描的markdown表格
• 自动分类（如换油、刹车等）
• 花费模式和维护洞察

📚 文档

• 完整文档 - 包含示例的完整指南
• 工具参考 - 所有可用工具及其参数
• 贡献指南 - 如何贡献（AI优先方法）

🔒 安全与隐私

• 只读访问 - 无法修改您的Tekmetric数据
• 您的凭证 - API密钥本地存储，从未发送给第三方
• 直接连接 - 直接与Tekmetric API通信
• 开源 - 完整代码透明度

🤝 贡献

这是一个AI优先项目！我们更偏好清晰的需求文档而非代码提交。请参阅我们的贡献指南，了解如何使用需求而不是拉取请求来贡献。

🐛 发现了错误？

打开一个问题并提供：

• 您询问的内容
• 您期望的结果
• 实际发生的情况

---

技术细节

要求

• Go 1.23+（用于从源代码构建）
• Tekmetric API凭证
• Claude Desktop应用

从源代码构建

git clone https://github.com/beetlebugorg/tekmetric-mcp.git
cd tekmetric-mcp
make build

配置

环境变量：

变量	描述	是否必需
TEKMETRIC_CLIENT_ID	API客户端ID	是
TEKMETRIC_CLIENT_SECRET	API客户端密钥	是
TEKMETRIC_BASE_URL	API URL（沙盒或生产）	否
TEKMETRIC_DEFAULT_SHOP_ID	默认店铺ID	否
TEKMETRIC_DEBUG	启用调试日志	否

技术栈

• Go 1.23+ - 快速、编译的二进制文件
• MCP SDK - 模型上下文协议
• OAuth 2.0 - 安全认证
• 速率限制 - 自动重试带退避

故障排除

连接问题：

• 验证配置中的绝对路径
• 检查二进制文件是否可执行
• 查看Claude Desktop开发者工具

身份验证失败：

• 验证客户端ID和客户端密钥
• 检查正确的基础URL（沙盒与生产）
• 尝试重新生成API凭证

速率限制：

• 服务器自动重试带退避
• 如需减少请求频率

启用调试模式：

tekmetric-mcp -d serve

📄 许可

MIT许可 - 请参阅LICENSE文件

免责声明：提供的“原样”无保证。先在沙盒中测试。不隶属于Tekmetric, Inc.

---

使用 🤖 + 💻 构建 | GitHub | 文档