mqttable_runtime_info读取 configured 与 effective MCP 运行时状态，不暴露凭据。
Mqttable for AI Agents
给 AI Agent MQTT 证据，而不是不受控的访问权。
Mqttable 让兼容 Agent 通过紧凑 MCP 接口发现运行时、读取有界 Trace 与产品证据、创建脱敏计划并验证结果。
合成流程演示：静态文本，不是实时遥测。Mqttable 不调用，也不内置独立模型。
mqttable · mcp
静态记录01 · Discover
$ mqttable_runtime_info
search_mqttable_capabilities → get_mqttable_schema运行时位于 loopback，effective access 是 approved_changes，schema 已内联 compact example。
02 · Capture
$ execute_mqttable_read → mqtt.qos.analyze_flow
execute_mqttable_read → proxy.toxic.listQoS 分析发现重复 PUBLISH 与 2.6 秒到达的 PUBACK；Proxy 报告 2400 ms downstream latency。
03 · Reproduce
$ read_mqttable_resource → bounded Trace
execute_mqttable_read → proxy.toxic.list有界 Trace、Proxy 与 Monitor 证据共同指向下行延迟，本地运行时压力保持正常。
04 · Act
$ plan_mqttable_action({ action: "proxy.toxic.delete", … })
apply_mqttable_plan({ plan_id, verification: "auto" })durable masked plan 只针对 latency_downstream；apply 只接受 plan_id 与 verification，不接受替换 payload。
05 · Verify
$ verify_mqttable_plan({ plan_id })
execute_mqttable_read → mqtt.qos.analyze_flow验证重新读取状态：toxic 已不存在，PUBACK 在 180 ms 返回，回到重试窗口内。
QoS 1 延迟重试
围绕一场有界事故完成发现、捕获、复现、操作与验证。
这份记录遵循当前 compact MCP 契约。读工具没有副作用；变更使用 durable masked plan，且只有本机 effective access 为 approved_changes 时才能 apply。
- 01
Discover
运行时位于 loopback，effective access 是 approved_changes，schema 已内联 compact example。
- 02
Capture
QoS 分析发现重复 PUBLISH 与 2.6 秒到达的 PUBACK；Proxy 报告 2400 ms downstream latency。
- 03
Reproduce
有界 Trace、Proxy 与 Monitor 证据共同指向下行延迟，本地运行时压力保持正常。
- 04
Act
durable masked plan 只针对 latency_downstream；apply 只接受 plan_id 与 verification，不接受替换 payload。
- 05
Verify
验证重新读取状态：toxic 已不存在，PUBACK 在 180 ms 返回，回到重试窗口内。
紧凑外部契约
九个工具，让发现范围更窄、行为更明确。
Example 已并入 schema expansion。能力深度可以变化，而无需让 Agent 学习新的顶层工具列表。
mqttable_doctor对运行时、传输与发现问题给出被动诊断。
search_mqttable_capabilities只在 capability id 未知时搜索 actions、workflows、resources 与 prompts。
get_mqttable_schema返回单个 action、resource 或 workflow schema，并内联 compact example。
execute_mqttable_read通过紧凑 read envelope 执行一个 typed no-effect action。
read_mqttable_resource通过工具门面读取一个有界 mqttable:// resource。
plan_mqttable_action为准确的 mutable action 创建不可变 durable plan，并返回 masked diff。
apply_mqttable_plan本机变更门禁有效时，只用 plan_id 与 verification 应用已保存计划。
verify_mqttable_plan为同一个 plan 重新读取运行时或持久化状态，并返回验证证据。
持久本地策略
访问权来自 Settings，不是每次操作都弹出确认。
用户在 Mqttable Settings 中选择三种模式之一。Agent 无法通过 MCP 提升这个模式。
offMCP 不可用
endpoint 关闭；用户重新启用后，原 URL-only 客户端配置可以继续使用。
read_only只检查，不修改
受信任本地客户端可以发现能力并读取有界证据，但 apply 保持禁用。
approved_changes允许计划式变更
受信任本地客户端可以在持久本机策略下应用 durable masked plan。
如果 readiness、registry、generation 或其他 mutation gate 不健康，即使 configured mode 仍是 approved_changes，effective access 也会自动降为 read_only。
硬边界
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 执行面。
- 01
打开 Settings → MCP，启用 read-only，再决定是否允许这个受信任本地客户端 apply approved changes。
- 02
复制生成的 URL-only 客户端配置。停用或重新启用 MCP 不会使它失效，也没有客户端凭据生命周期。
- 03
先读 runtime info；只有 capability id 未知时才 search；调用前先读对应 schema。
Agent FAQ
连接 Agent 前最值得问的问题。
把有边界的 MQTT 证据交给 Agent，同时保留控制权。
打开下载页，在设置中选择 MCP 访问模式，并从运行时发现开始，而不是猜测状态。