MyLeadTech HVAC

Servidor MCP de HVAC: códigos de falla, búsqueda de modelos y respuestas citadas a la página del manual del OEM.

Servidor MCP alojado

npx add-mcp 'https://mcp.myleadtech.app/mcp/'

Se instala en Claude Code, Codex, Cursor y más

Documentación

MyLeadTech MCP

Servidor MCP de HVAC: códigos de falla, búsqueda de modelos y respuestas citadas a la página del manual del OEM.

Este repositorio contiene los detalles de conexión y los metadatos de registro para el servidor MCP alojado de MyLeadTech. Aquí no hay código del servidor: el servidor se ejecuta en el endpoint que se indica a continuación.

Endpoint: https://mcp.myleadtech.app/mcp/
Transporte: HTTP Streamable
Autenticación: clave API del panel de MyLeadTech, enviada como Authorization: Bearer <api_key>. El sitio también ofrece inicio de sesión con OAuth mediante una cuenta de MyLeadTech para los clientes que lo admitan.
Marcas atendidas: Carrier, Trane, Lennox
Sandbox: 100 unidades gratuitas al mes. Las consultas de equipos y las preguntas aclaratorias no cuentan. Una solicitud reintentada con la misma clave de idempotencia nunca se cobra dos veces.

Herramientas

Herramienta	Qué hace	Parámetros
`resolve_equipment`	Convierte una referencia de modelo o placa de identificación en marca y equipo, e informa la cobertura. No se cobra.	`reference`, `market` (predeterminado `us`), `language` (predeterminado `en-US`)
`search_hvac_documents`	Encuentra pasajes y citas en documentos del fabricante.	`question`, `brand`, `model_reference`, `fault_code`, `language`, `limit` (predeterminado 5), `operation_id`
`get_hvac_source`	Devuelve un pasaje citado con contexto limitado.	`source_id`
`answer_hvac_question`	Una respuesta escrita con fuentes numeradas a nivel de página.	`question`, `brand`, `model_reference`, `fault_code`, `language`, `limit` (predeterminado 5), `operation_id`
`get_hvac_document_page`	Una página de origen como PNG, o un enlace PDF firmado de una sola página cuando `format` es `pdf`.	`document_version_id`, `page_number`, `format` (predeterminado `png`), `region`

operation_id hace que un reintento reproduzca el resultado anterior en lugar de cobrar de nuevo.

Instalación

Primero crea una clave API en el panel.

Claude Code

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

Sin --header, Claude Code puede iniciar sesión con tu cuenta de MyLeadTech en su lugar.

Cursor

Pega en .cursor/mcp.json:

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

VS Code

Pega en .vscode/mcp.json:

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

Otros clientes

Cualquier cliente MCP que admita servidores HTTP Streamable remotos: endpoint https://mcp.myleadtech.app/mcp/, encabezado Authorization: Bearer <api_key>.

Ejemplo

Llama a answer_hvac_question con:

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

Forma de la respuesta (ejemplo de contrato ar-00/1, answer/ok.json, copiado sin cambios; no es una llamada en vivo):

{
  "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": []
    }
  ]
}

Enlaces

Documentación para desarrolladores: https://myleadtech.app/developers/docs
Guía de MCP: https://myleadtech.app/developers/mcp
Especificación OpenAPI de REST: https://api.myleadtech.app/v1/openapi.json
Sitio: https://myleadtech.app
Obtén una clave API: https://web.myleadtech.app

Licencia

MIT, solo para los archivos de este repositorio (README y configuración). El servicio de MyLeadTech y los documentos del fabricante que cita no están cubiertos.