MCP 配置指南 · LadDoc Cloud

端点与鉴权

MCP 端点	`https://tia.hubwiz.com/lad/mcp`
传输	Streamable HTTP（无状态，POST JSON-RPC）
鉴权	`Authorization: Bearer lad_live_…`（也接受 `X-API-Key`）
计费	每次 `tools/call` 扣 1 次额度；握手请求免费

API Key 在控制台创建与吊销，明文只显示一次。

Claude Code

claude mcp add --transport http lad-cloud https://tia.hubwiz.com/lad/mcp \
  --header "Authorization: Bearer lad_live_你的密钥"

添加后运行 claude mcp list 确认连接。

Cursor / VS Code / 通用 JSON 配置

{
  "mcpServers": {
    "lad-cloud": {
      "url": "https://tia.hubwiz.com/lad/mcp",
      "headers": {
        "Authorization": "Bearer lad_live_你的密钥"
      }
    }
  }
}

工具示例

每次调用提交一个 LadDoc 文档（doc 参数）。如果需要生成多个块，请逐个调用；被调用的 FC/FB 也各自作为文档提交。

先确认本服务实现的规范版本（免费，不计额度）：

{
  "name": "lad_version",
  "arguments": {}
}

返回 { schemaVersion, packFormatVersion, sourceCommit, bundleHash, ... }；把它与 LAD-IR 规范服务 /api/v1/lad/version 的 bundleHash 对比，相同表示你读到的文本就是判分规则。

校验一份 LadDoc：

{
  "name": "lad_validate",
  "arguments": {
    "doc": { "schemaVersion": "1.0", "block": { "...": "你的 LadDoc" } },
    "specHash": "sha256:… 你读到的 bundleHash（可选）"
  }
}

返回 { "valid": true, "block": "LatchFC", "issues": [], "spec": { … } }；非法文档返回逐条 { code, path, message }。

校验并生成 SimaticML：

{
  "name": "lad_generate",
  "arguments": {
    "doc": { "schemaVersion": "1.0", "block": { "...": "你的 LadDoc" } }
  }
}

成功返回 { ok: true, block, fileName, bytes, xml }；有任何校验问题时返回 isError 和 issues，且不产出 XML。

带目标工程符号清单（可选，启用符号交叉检查）：

{
  "name": "lad_generate",
  "arguments": {
    "doc": { "...": "你的 LadDoc" },
    "inventory": { "...": "lad-ir inventory 文档" }
  }
}

LadDoc 文档格式

LadDoc 是 JSON 格式的 PLC 梯形图文档，专为 AI 生成与修改梯形图设计；它不是 Lua 的 LDoc，也不是 Teladoc。本服务不发布 LadDoc 的语法规范。工具只接受你已有的 LadDoc 文档，校验器返回的 code / path / message 是唯一的格式反馈：按 path 定位字段、按 code 搜索对应规则即可修正。