跳到主要内容

打开导航

Mqttable for AI Agents

给 AI Agent MQTT 证据,而不是不受控的访问权。

Mqttable 让兼容 Agent 发现运行时、读取有界 MQTT 证据,并通过唯一修改入口执行已授权操作。服务端负责提交检查和结果取证。

合成流程演示:静态文本,不是实时遥测。Mqttable 不调用,也不内置独立模型。

mqttable · mcp
静态记录

01 · Discover

$ query_mqttable → mqttable://runtime/status find_mqttable_capabilities → describe_mqttable_capability

Runtime 位于本机回环,MCP 已启用,运行健康状态正常,schema 内含示例。

02 · Capture

$ query_mqttable → mqtt.qos.analyze_flow query_mqttable → proxy.toxic.list

QoS 分析发现重复 PUBLISH 与 2.6 秒到达的 PUBACK;Proxy 报告 2400 ms downstream latency。

03 · Reproduce

$ query_mqttable → bounded Trace URI query_mqttable → proxy.toxic.list

有界 Trace、Proxy 与 Monitor 证据共同指向下行延迟,本地运行时压力保持正常。

04 · Act

$ execute_mqttable_action({ action: "proxy.toxic.delete", input: { … }, idempotency_key: "remove-fault-once" })

本次操作只针对 latency_downstream。重试时复用幂等键,不会因为响应丢失而再次执行。

05 · 结果证据

$ query_mqttable → operation.read query_mqttable → mqtt.qos.analyze_flow

先看操作返回的结果证据。只有结果待定或未知时才查询 operation.read,再按用户目标检查 MQTT 流程证据。

固定的 QoS 1 延迟案例;不自动播放、不调用模型、不连接 Broker,也不代表实时运行时输出。

QoS 1 延迟重试

围绕一场有界事故完成发现、捕获、复现、操作与验证。

读取工具不产生业务副作用。MCP 已启用且运行时健康时,一次执行调用即可完成受支持修改的检查、执行和结果验证。

  1. 01

    Discover

    Runtime 位于本机回环,MCP 已启用,运行健康状态正常,schema 内含示例。

  2. 02

    Capture

    QoS 分析发现重复 PUBLISH 与 2.6 秒到达的 PUBACK;Proxy 报告 2400 ms downstream latency。

  3. 03

    Reproduce

    有界 Trace、Proxy 与 Monitor 证据共同指向下行延迟,本地运行时压力保持正常。

  4. 04

    Act

    本次操作只针对 latency_downstream。重试时复用幂等键,不会因为响应丢失而再次执行。

  5. 05

    结果证据

    先看操作返回的结果证据。只有结果待定或未知时才查询 operation.read,再按用户目标检查 MQTT 流程证据。

紧凑外部契约

五个工具,查找能力后直接执行。

Example 已并入 schema expansion。能力深度可以变化,而无需让 Agent 学习新的顶层工具列表。

find_mqttable_capabilities

在 capability id 未知时查找一个 typed action、workflow、resource 或 prompt。

describe_mqttable_capability

返回一个准确的 action、resource 或 workflow 契约与 compact example。

query_mqttable

查询数据、运行无副作用分析,或读取一个有界 mqttable:// resource。

execute_mqttable_action

执行一个已授权的有副作用 action,并返回持久化 Operation 证据。

diagnose_mqttable

返回 Mqttable Runtime 与 MCP 服务的被动或显式主动诊断。

持久本地策略

一个开关,独立的运行健康状态

启用 MCP 即授权受支持的读取与变更。每次变更仍需通过运行时检查。

mcp_enabled: false

MCP 不可用

endpoint 关闭;用户重新启用后,原 URL-only 客户端配置可以继续使用。

mcp_enabled: true

MCP 已启用

本机客户端可以读取证据、执行受支持的操作。启用状态持续有效,直到你关闭 MCP。

运行健康状态与启用开关独立。变更服务异常时拒绝写入,但不改变用户设置;可用的诊断读取仍保留。

硬边界

Agent 的访问面始终比工作台更窄。

写入只留在本机

本地 MCP client 无需客户端凭据,直接连接 loopback endpoint。浏览器 Origin 请求会被拒绝,mutable call 仍需要有效变更门禁。

不提供 Remote MCP

MCP 只接受 loopback HTTP;非 loopback 请求没有配置开关或 authorization provider 旁路。

原始 secrets 留在 MCP 之外

密码、bearer token、PEM 证书与 private key 通过第一方 intake 录入;Agent 流程只引用 SecretRef、CertRef 与 KeyRef handles。

Replay 留在 Workbench

Replay 场景在 Workbench 中创建、审阅、Dry Run 与执行。当前没有 Replay 专用 MCP 执行面。

三步接入

连接 Agent,不要手写猜测配置。

阅读完整 Agent 快速开始
  1. 01

    打开 Settings → MCP,为受信任的本机客户端启用 MCP。修改仍需通过当前授权和运行时健康检查。

  2. 02

    复制生成的 URL-only 客户端配置。停用或重新启用 MCP 不会使它失效,也没有客户端凭据生命周期。

  3. 03

    先读 runtime info;只有 capability id 未知时才 search;调用前先读对应 schema。

Agent FAQ

连接 Agent 前最值得问的问题。

把有边界的 MQTT 证据交给 Agent,同时保留控制权。

打开下载页,在设置中选择 MCP 访问模式,并从运行时发现开始,而不是猜测状态。

下载