MyLeadTech HVAC

MyLeadTech MCP

HVAC MCP 服务——故障代码、型号查询，以及附有 OEM 手册页引用的解答。

此仓库包含托管的 MyLeadTech MCP 服务的连接详情和注册表元数据。这里没有服务端代码：服务运行在以下端点。

• 端点： https://mcp.myleadtech.app/mcp/
• 传输方式： Streamable HTTP
• 身份验证： 从 MyLeadTech 控制面板获取 API 密钥，并通过 Authorization: Bearer <api_key> 发送。该网站也提供使用 MyLeadTech 账户进行 OAuth 登录的选项，供支持此方式的客户端使用。
• 支持的品牌： Carrier、Trane、Lennox
• 沙盒： 每月 100 个免费额度单位。设备查询和澄清问题不计费。使用相同幂等键重试请求，绝不会重复收费。

工具

工具	功能	参数
resolve_equipment	将型号或铭牌信息解析为品牌和设备，并报告覆盖情况。不计费。	reference、market（默认值为 us）、language（默认值为 en-US）
search_hvac_documents	在制造商文档中查找段落和引用。	question、brand、model_reference、fault_code、language、limit（默认值为 5）、operation_id
get_hvac_source	返回带有限上下文的引用段落。	source_id
answer_hvac_question	提供书面解答，并附带编号的页面级来源。	question、brand、model_reference、fault_code、language、limit（默认值为 5）、operation_id
get_hvac_document_page	返回来源页面的 PNG，或在 format 为 pdf 时返回带签名的单页 PDF 链接。	document_version_id、page_number、format（默认值为 png）、region

operation_id 可确保重试时重放先前的结果，而不是再次收费。

安装

请先在 控制面板中创建 API 密钥。

Claude Code

claude mcp add --transport http myleadtech https://mcp.myleadtech.app/mcp/ --header "Authorization: Bearer YOUR_API_KEY"

不使用 --header 时，Claude Code 可以通过 MyLeadTech 账户登录。

Cursor

粘贴到 .cursor/mcp.json：

{
  "mcpServers": {
    "myleadtech": {
      "url": "https://mcp.myleadtech.app/mcp/",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code

粘贴到 .vscode/mcp.json：

{
  "servers": {
    "myleadtech": {
      "type": "http",
      "url": "https://mcp.myleadtech.app/mcp/",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

其他客户端

任何支持远程 Streamable HTTP 服务的 MCP 客户端：端点 https://mcp.myleadtech.app/mcp/，请求头为 Authorization: Bearer <api_key>。

示例

使用以下内容调用 answer_hvac_question：

{ "question": "What refrigerant does the 27TPA8 use?", "brand": "carrier", "model_reference": "27TPA8" }

响应格式（契约示例 ar-00/1、answer/ok.json，原样复制；非实时调用）：

{
  "request_id": "55555555-5555-4555-8555-555555555501",
  "contract_version": "ar-00/1",
  "service_revision": "2026.10.06-doc",
  "publication": {
    "branch": "main",
    "snapshot_ref": "main-20261006-5ed-carrier-263ch"
  },
  "status": "ok",
  "partial": false,
  "missing": [],
  "degraded": [],
  "usage": {
    "operation": "answer",
    "debited": true,
    "units": null
  },
  "answer": "The 27TPA8 is a Performance Series 2-stage heat pump for R-454B indoor units only.",
  "claims": [
    {
      "text": "Uses Puron Advance (R-454B) refrigerant.",
      "source_id": "chunk:1a9595df-e0cb-4dfe-83d8-504e1da1757a"
    }
  ],
  "limits": [],
  "passages": [
    {
      "source_id": "chunk:1a9595df-e0cb-4dfe-83d8-504e1da1757a",
      "document_version_id": "65a562f3-1c45-4071-be67-30b35eac7393",
      "document_type": "product_data",
      "text": "27TPA8 Performance Series 2-Stage Heat Pump with Puron Advance™ (R-454B) Refrigerant …",
      "pages": [
        1
      ],
      "printed_label": null,
      "applicability": "established",
      "rank": 1,
      "citations": []
    }
  ]
}

链接

• 开发者文档：https://myleadtech.app/developers/docs
• MCP 指南：https://myleadtech.app/developers/mcp
• REST OpenAPI 规范：https://api.myleadtech.app/v1/openapi.json
• 网站：https://myleadtech.app
• 获取 API 密钥：https://web.myleadtech.app

许可证

MIT，仅适用于此仓库中的文件（README 和配置）。MyLeadTech 服务及其引用的制造商文档不在许可范围内。