连接 Agent 并完成第一条 MQTT 消息

你将完成什么

你会把可信的本机 Agent 连接到 Mqttable，创建一个隔离的测试 Connection，订阅唯一 Topic，发布一条 QoS 1 JSON 消息，并在 Trace 中确认完整交互。

开始前：

• Mqttable 与 Agent 必须运行在同一台可信电脑上。
• 只能使用合成数据。本教程使用公共测试端点 broker.emqx.io:1883；唯一 Topic 可以减少冲突，但不会让消息变得私密。
• 如果 Broker 不可用、Agent 报告了另一个 Mqttable Runtime，或 允许变更 不可用，请停止，不要改用生产端点。

开启 MCP 并复制配置

打开 应用设置 > MCP，然后选择 启用。新安装默认关闭 MCP，只有启用后才会开放本机端点。

12

MCP 首先进入 只读。本教程需要创建和删除测试对象，请选择 允许变更。访问级别会立即生效，并一直保留到你主动修改或关闭 MCP。

允许变更就是授权边界。 Mqttable 不会为每个 Plan 再打开一次审批界面。每项修改仍会经过有边界的 Plan、masked_diff、Apply 和 Verify。

123

选择 JSON 或 TOML，再点击 复制。请使用 Mqttable 生成的完整配置，不要手输端点，也不要添加 Authorization header、Token、密码或 URL query credential。

连接 Agent

只把复制的配置加入可信 Client 和可信工作区：

• Codex： 把 TOML 配置放入 ~/.codex/config.toml，也可以放入可信项目的 .codex/config.toml。启动新的会话，再用 /mcp 或 codex mcp list 确认 mqttable。
• Claude Code： 把 JSON 配置放入可信项目的 .mcp.json。启动新的会话，根据提示批准项目 Server，再用 /mcp 确认连接。
• Cursor： 把 JSON 配置放入项目的 .cursor/mcp.json，或全局的 ~/.cursor/mcp.json。打开 Customize > MCP，确认 mqttable 已启用并连接。
• 其他 MCP Client： 使用复制配置中的准确 URL 和 Streamable HTTP。Client 必须运行在能通过 127.0.0.1 访问当前 Mqttable Runtime 的位置。

继续前，让 Agent 报告已连接的 Mqttable Runtime 和访问模式。只有 Runtime 位于本机且模式为 approved_changes 时才继续。

运行第一条消息任务

把下面的 Prompt 复制到同一个 Agent 会话：

主 Prompt

请使用已连接的 Mqttable MCP 工具，通过 broker.emqx.io:1883 帮我发出并收到第一条 MQTT 消息。使用 MQTT 5.0、QoS 1 和一条测试 JSON 消息，不要改动已有配置，完成后告诉我在 Mqttable 哪里看结果。

这就是完整任务。临时名称和 MCP 执行步骤都由 Agent 处理。如果公共 Broker 不可用，Agent 应停止，不要改用其他端点。

确认结果

Agent 完成后，回到 连接。成功结果如下：

123

你只需要确认三件事：

• Connection 显示 已连接，MQTT 为 5.0；
• 教程 Topic 显示 QoS1；
• Trace 同时出现已发送和已接收 PUBLISH，并有成功的 PUBACK。

如果缺少任何结果，请停止，不要再发送一条消息，并查看排错与 MCP 边界。

清理并继续

把已完成报告保留在同一个 Agent 对话中，然后发送下面的 Prompt：

清理 Prompt

只删除你为首条消息测试创建的临时 Broker、Connection 和 Topic，不要改动其他任何对象。删除后确认这些临时对象已经不存在。

如果换了 Agent 对话，必须先粘贴完成报告中的准确对象清单，再请求清理。

接下来可以阅读 Connection 与消息，创建有边界的定时心跳；也可以阅读 Trace 与诊断，继续分析 QoS 1 交互。