MyLeadTech HVAC

Servidor MCP de HVAC — códigos de falha, consulta de modelos e respostas citadas na página do manual do fabricante.

Servidor MCP hospedado

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

Instala no Claude Code, Codex, Cursor e outros

Documentação

MyLeadTech MCP

Servidor MCP de HVAC — códigos de falha, consulta de modelos e respostas citadas com referência à página do manual OEM.

Este repositório contém os detalhes de conexão e os metadados de registro para o servidor MyLeadTech MCP hospedado. Não há código de servidor aqui: o servidor roda no endpoint abaixo.

Endpoint: https://mcp.myleadtech.app/mcp/
Transporte: HTTP Streamable
Autenticação: chave de API do painel MyLeadTech, enviada como Authorization: Bearer <api_key>. O site também oferece login OAuth com uma conta MyLeadTech para clientes que suportam esse recurso.
Marcas atendidas: Carrier, Trane, Lennox
Sandbox: 100 unidades gratuitas por mês. Consultas de equipamentos e perguntas de esclarecimento não contam. Uma solicitação repetida com a mesma chave de idempotência nunca é cobrada duas vezes.

Ferramentas

Ferramenta	O que faz	Parâmetros
`resolve_equipment`	Converte uma referência de modelo ou placa de identificação em marca e equipamento, e informa a cobertura. Não é cobrada.	`reference`, `market` (padrão `us`), `language` (padrão `en-US`)
`search_hvac_documents`	Encontra trechos e citações em documentos do fabricante.	`question`, `brand`, `model_reference`, `fault_code`, `language`, `limit` (padrão 5), `operation_id`
`get_hvac_source`	Retorna um trecho citado com contexto limitado.	`source_id`
`answer_hvac_question`	Uma resposta escrita com fontes numeradas por página.	`question`, `brand`, `model_reference`, `fault_code`, `language`, `limit` (padrão 5), `operation_id`
`get_hvac_document_page`	Uma página de origem em PNG, ou um link de PDF de página única assinado quando `format` é `pdf`.	`document_version_id`, `page_number`, `format` (padrão `png`), `region`

operation_id faz com que uma nova tentativa reproduza o resultado anterior em vez de cobrar novamente.

Instalação

Crie uma chave de API no painel primeiro.

Claude Code

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

Sem --header, o Claude Code pode fazer login com sua conta MyLeadTech.

Cursor

Cole em .cursor/mcp.json:

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

VS Code

Cole em .vscode/mcp.json:

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

Outros clientes

Qualquer cliente MCP que suporte servidores remotos Streamable HTTP: endpoint https://mcp.myleadtech.app/mcp/, cabeçalho Authorization: Bearer <api_key>.

Exemplo

Chame answer_hvac_question com:

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

Formato da resposta (exemplo de contrato ar-00/1, answer/ok.json, copiado sem alterações; não é uma chamada real):

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

Licença

MIT, apenas para os arquivos deste repositório (README e configuração). O serviço MyLeadTech e os documentos do fabricante que ele cita não estão cobertos.