项目简介 Tekmetric MCP Server 是一个独立的社区项目,旨在通过Model Context Protocol (MCP) 技术,将您的Tekmetric商店数据无缝集成到LLM(如Claude Desktop)中。它允许您使用自然语言提问,获取关于客户、车辆、维修订单、预约和库存等方面的实时信息。此工具仅提供数据读取功能,不会修改您的Tekmetric数据,并且API凭证本地存储,确保安全。

主要功能点

  • 自然语言查询: 无需记忆复杂命令,直接用日常语言提问即可。
  • 实时数据访问: 直接连接Tekmetric API,获取最新的商店运营数据。
  • 智能搜索: 按名称、VIN、日期、状态等多种条件查找客户、车辆、维修订单。
  • 丰富上下文: 自动展示客户姓名、车辆详情、格式化价格等,提供清晰易懂的结果。
  • 数据查询范围: 可查询商店信息、客户详情、车辆记录、维修订单、工单、预约、员工信息和库存数据。

安装步骤

  1. 获取Tekmetric API凭证:
    • 访问 api.tekmetric.com 申请API访问权限。
    • 等待2-3周审批,您将收到 Client ID 和 Client Secret。请务必安全保存这些凭证。
  2. 安装MCP服务器:
    • 桌面扩展(推荐): 从 GitHub Releases 下载最新版 'tekmetric-mcp.mcpb' 文件。使用Claude Desktop打开此文件,并按提示配置您的API凭证即可。
    • 手动安装: 如果您希望手动部署,需要将 'tekmetric-mcp' 可执行文件放置到系统路径或指定路径。
  3. 配置Claude Desktop:
    • 在Claude Desktop的配置文件 ('~/Library/Application Support/Claude/claude_desktop_config.json' on macOS) 中添加以下JSON配置段。请将 'command' 字段指向 'tekmetric-mcp' 可执行文件的绝对路径,并替换 'TEKMETRIC_CLIENT_ID'、'TEKMETRIC_CLIENT_SECRET' 和 'TEKMETRIC_DEFAULT_SHOP_ID' 为您的实际值。
      {
        "mcpServers": {
          "tekmetric": {
            "command": "/absolute/path/to/tekmetric-mcp",
            "args": ["serve"],
            "env": {
              "TEKMETRIC_CLIENT_ID": "您的Tekmetric API Client ID",
              "TEKMETRIC_CLIENT_SECRET": "您的Tekmetric API Client Secret",
              "TEKMETRIC_BASE_URL": "Tekmetric API基础URL,默认为https://api.tekmetric.com",
              "TEKMETRIC_DEFAULT_SHOP_ID": "默认商店的ID,用于没有明确指定商店的查询"
            }
          }
        }
      }
  4. 重启Claude Desktop: 关闭并重新打开Claude Desktop。检查是否有 🔌 图标,这表示MCP服务器已成功连接并可用。

服务器配置 MCP服务器是为MCP客户端提供服务的,其配置信息在MCP客户端中以JSON格式定义。您的MCP客户端(例如Claude Desktop)需要通过以下JSON格式配置来启动和连接Tekmetric MCP Server:

{
  "mcpServers": {
    "tekmetric": {
      "command": "/absolute/path/to/tekmetric-mcp",
      "args": ["serve"],
      "env": {
        "TEKMETRIC_CLIENT_ID": "您的Tekmetric API Client ID",
        "TEKMETRIC_CLIENT_SECRET": "您的Tekmetric API Client Secret",
        "TEKMETRIC_BASE_URL": "Tekmetric API基础URL,默认为https://api.tekmetric.com",
        "TEKMETRIC_DEFAULT_SHOP_ID": "默认商店的ID,用于没有明确指定商店的查询"
      }
    }
  }
}
  • 'command': Tekmetric MCP服务器可执行文件的绝对路径。
  • 'args': 启动服务器时要传递的参数,通常为 '["serve"]'。
  • 'env': 环境变量,用于配置Tekmetric API凭证和其他服务器设置。
    • 'TEKMETRIC_CLIENT_ID': 从Tekmetric获取的API Client ID。
    • 'TEKMETRIC_CLIENT_SECRET': 从Tekmetric获取的API Client Secret。
    • 'TEKMETRIC_BASE_URL': Tekmetric API的基地址,'https://api.tekmetric.com' 或 'https://sandbox.tekmetric.com' (开发/测试环境)。
    • 'TEKMETRIC_DEFAULT_SHOP_ID': 如果请求中未指定,服务器将使用的默认商店ID。

基本使用方法 连接成功后,您可以在Claude Desktop中直接使用自然语言提问:

  • 查看今日日程: "Show me today's appointments" (显示今日预约)
  • 查找客户: "Find customer John Smith" (查找客户 John Smith)
  • 搜索车辆: "Search for a 2020 Honda Accord" (搜索一辆 2020 Honda Accord)
  • 查询维修订单: "Show me estimates from last week" (显示上周的估价单)
  • 列出员工: "List all employees" (列出所有员工)
  • 查看库存: "What's in inventory?" (库存里有什么?)
  • 请注意:财务报告和大量数据导出应使用Tekmetric官方工具。此工具旨在提供快速、战术性的查询。

信息

分类

商业系统