AssetLab

AssetLab MCP 服务

与您的资产对话。 通过 Model Context Protocol，将 Claude、ChatGPT、Microsoft Copilot 或任何兼容 MCP 的客户端连接到您的 AssetLab 账户——用自然语言询问工单、预防性维护计划、资本计划和基础设施网络，并免提创建或更新记录。

480 多种工具，涵盖 100 多种资源 · 范围受限、绑定租户、可审计 · 支持读取 和 写入 · 托管或本地

---

快速开始

Claude.ai（托管版——最简单）

1. 在 AssetLab → Settings → API Keys 中创建 API 密钥
2. 在 Claude.ai 中：Settings → Connectors → Add connector
3. 粘贴连接器 URL：https://mcp.assetlab.ca
4. 系统提示进行身份验证时，粘贴您的 API 密钥（al_live_...）

ChatGPT

1. 在 AssetLab → Settings → API Keys 中创建 API 密钥
2. 在 ChatGPT 中：Settings → Apps & Connectors → Add new connector
3. 为连接器命名（例如 AssetLab），并输入服务 URL：https://mcp.assetlab.ca
4. 将身份验证设为 OAuth，然后点击 Create——OAuth 端点会自动发现
5. 在 AssetLab 授权页面中，粘贴您的 API 密钥（al_live_...）

Microsoft Copilot（通过 Copilot Studio）

Copilot 聊天中没有“添加服务”字段，因此需要由一人创建 Agent 并发布一次；之后，员工即可在常规 Microsoft 365 Copilot 中使用该 Agent。

1. 在 AssetLab → Settings → API Keys 中创建 API 密钥
2. 在 Copilot Studio 中，打开一个启用了生成式编排的 Agent，并选择 Tools → Add a tool → New tool → Model Context Protocol
3. 服务 URL：https://mcp.assetlab.ca/mcp?profile=core
4. 身份验证选择 API key，类型选择 Header，标头名称为 Authorization；连接值为 Bearer al_live_...
5. 将 Agent 发布到 Microsoft 365 Copilot 渠道，并请管理员批准

此处请使用 ?profile=core 地址。Copilot Studio 将每个 Agent 的工具数限制为 128 个，并建议使用 25 到 30 个；此服务发布了 480 多种工具，而 core 配置仅提供 28 种，涵盖站点、建筑、资产、工单、工作请求、预防性维护计划和供应商。Claude 和 ChatGPT 没有此限制，应使用普通 URL。

Claude Desktop / Claude Code（本地，stdio）

此软件包通过 stdio 作为本地 MCP 服务运行，不会向网络公开任何内容。

{
  "mcpServers": {
    "assetlab": {
      "command": "npx",
      "args": ["-y", "@assetlab/mcp-server"],
      "env": {
        "ASSETLAB_API_KEY": "al_live_...",
        "ASSETLAB_API_URL": "https://<your-project>.supabase.co/functions/v1/api-gateway"
      }
    }
  }
}

您的 AssetLab 管理员可以提供贵组织的 API URL。

---

您可以询问什么？

您说	它会做什么
“显示所有逾期工单”	按顺序列出工单，并附上返回 AssetLab 的链接
“为 3 号楼的故障水泵创建工单”	查找建筑和资产，然后创建工单
“哪些项目存在风险或延期？”	扫描项目状态和风险
“资产 X 的总成本历史记录是多少？”	汇总所有成本记录
“列出直径超过 500 毫米且状况不佳的输水主管”	按直径和状况筛选基础设施要素
“在路面养护策略中添加一项每平方米 4 美元的裂缝密封事件”	管理您的生命周期策略
“本月有哪些预防性维护计划到期？”	检查每项计划的下次到期日
“将 WO-1234 的优先级更新为紧急”	编辑记录（需具备相应写入权限）

---

2.7 版本更新

为 Microsoft Copilot 精心策划的工具配置。 在托管服务 URL 后添加 ?profile=core，即可发布 28 个工具，而不是 480 多个。这让服务能够在限制单个 Agent 可托管工具数量的客户端中使用——Microsoft Copilot Studio 允许托管 128 个工具，并建议使用 25–30 个。无法识别的配置名称会被拒绝，而不会悄悄提供完整目录。Claude 和 ChatGPT 不受影响，仍可使用完整工具集。

---

2.5 版本更新

设施生命周期策略。 生命周期策略工具现在涵盖建筑物和设备，而不再局限于线性基础设施。asset_lifecycle_events 范围下新增五个工具，用于读取和维护由状况触发的干预措施（“状况达到 70–85 时重新涂刷屋顶，可延长使用寿命五年”）。事件关联到资产类型或资产类型组，而不是单个资产，因此一个事件就能维护整类设备。

事件会说明后续工作类型。 两端的生命周期事件现在都带有 work_generation 设置——仅计划、工单或项目——因此到期的干预措施会记录其应转变为何种工作。不会按计划创建任何内容；干预措施列表仍是做出该决定的地方。

---

工具目录

工具在整个目录中遵循统一的命名模式：使用 list_* / get_* 进行读取，使用 create_* / update_* / delete_* 进行写入。下文中的读取指 list/get；写入指 create/update/delete（不同资源的可用操作略有差异，以工具说明为准）。

资产与维护记录（17 个资源）

资源	读取	写入
资产	✓	✓
资产评论 · 成本 · 文档 · 部件	✓	✓
资产位置（平面图标记）	✓	✓
资产替换计划	✓	✓
资产状况评估	✓	✓
资产生命周期事件（策略）	✓	✓
资产风险历史	✓	-
资产状态 · 类型 · 类型组	✓	✓
附件（以及 upload_file、create_upload_url）	✓	✓
制造商	✓	✓
部件 · 部件类别	✓	✓

工作管理（7 个资源）

资源	读取	写入
工单	✓	✓
工单评论 · 计划安排	✓	✓
工作请求	✓	✓
工作类别	✓	✓
PM 计划	✓	✓
PM 模板	✓	✓

场地、建筑与系统（11 个资源）

资源	读取	写入
场地	✓	✓
场地 FCI 历史	✓	-
建筑 · 建筑类型	✓	✓
位置 · 位置类型	✓	✓
系统 · 系统类别 · 系统组	✓	✓
平面图 · 平面图区域	✓	✓

基础设施（线性资产）（11 个资源）

资源	读取	写入
要素类别	✓	✓
网络	✓	✓
要素（线段与节点，GeoJSON 几何）	✓	✓
要素检查	✓	✓
生命周期事件（策略）	✓	✓
区域	✓	✓
要素评论 · 成本 · 文档 · 部件	✓	✓
要素风险历史	✓	-

项目与资本规划（20 多个资源）

资源	读取	写入
项目	✓	✓
任务 · 任务依赖项 · 里程碑	✓	✓
阶段 · 阶段类别	✓	✓
预算项目 · 工时条目 · 成本快照	✓	✓
评论 · 更新 · 风险 · 团队成员	✓	✓
文档 · 文档文件夹模板	✓	✓
项目关联（资产、建筑、场地、位置、系统、基础设施）	✓	✓
服务区域（以及场地和系统类别关联）	✓	✓

财务与供应商（10 个资源）

资源	读取	写入
预算	✓	✓
费用 · 发票 · 采购订单	✓	✓
变更订单	✓	✓
成本类别	✓	✓
合同 · 合同场地 · 合同文档	✓	✓
供应商 · 供应商场地分配	✓	✓

合规、表单与服务水平（15 个资源）

资源	读取	写入
合规项目 · 记录	✓	✓
表单模板 · 模板项目	✓	✓
表单响应	✓	✓
表单响应答案	✓	-
LoS 指标 · 测量值	✓	✓
LoS 拟议目标	✓	✓
LoS 目标历史	✓	-
LoS 系统目标 · 基础设施目标	✓	✓
关键性修正项	✓	✓
LoS 后果	✓	✓
LoS 状态快照	✓	-

管理与分析（6 个资源）

资源	读取	写入
用户	✓	-
自定义字段定义 · 值	✓	✓
仪表板摘要 · 快照	✓	-
批量操作（bulk_create、bulk_update）	-	✓

---

权限范围

API 密钥使用权限范围，精确控制助手可以访问的内容。在 设置 → API Keys 中配置各资源的读取和写入权限——权限范围按类别分组（Operations、Facilities、Projects、Finance、Infrastructure 等），并提供批量切换控件。

权限范围模式	访问权限
resource:read	列出和获取记录（例如 assets:read、work_orders:read）
resource:write	创建、更新和删除记录（例如 assets:write）
*:*	完全访问所有资源

---

安全性

• OAuth 2.0 + PKCE，通过 mcp.assetlab.ca；API 密钥在传输过程中经过加密，且 MCP 服务不会存储该密钥
• 绑定租户——每个密钥仅限访问所属组织，服务会忽略任何访问其他租户的尝试
• 可审计——所有数据访问都会记录在 AssetLab 的审计日志中
• 可撤销——可随时在 设置 → API Keys 中撤销密钥；撤销后立即失效
• 默认只读——写入操作需要明确授予写入权限范围

---

支持

有疑问或遇到问题？请发送邮件至 [email protected]。

文档：assetlab.ca → Docs → AI & MCP