BUSLOOM MANUAL

MCP integration

Authenticated local control from automation agents.

13 · PROFESSIONAL

MCP integration

Busloom can expose the open desktop session as a local Model Context Protocol server. It is an adapter to the same project, connection, scan, view, tag, write, and automation paths—not a second hidden Modbus client.

Enable a client

  1. Open Application Preferences → MCP

    MCP is a Professional feature and is disabled by default.

  2. Enable the local server

    The listener binds only to 127.0.0.1 and Busloom must remain open.

  3. Copy URL and bearer token

    Configure the client for Streamable HTTP and send the token in the Authorization header.

  4. Keep prompts enabled first

    Read and project operations can proceed, while tag writes and real write-capable automation ask in Busloom.

  5. Regenerate after exposure

    Regenerating the token restarts the enabled server and disconnects existing clients.

What an agent can orchestrate

The MCP surface covers project creation/open/save, profiles, port and Unit-ID discovery, connection, scans, views, tags, acquisition, bounded observation of changing values, writes, diagnostics, and automation. Mutations use the same project validator and undo/history path. Unsaved MCP edits remain unsaved until the project is explicitly saved.

ControlProtectionOperator responsibility
Loopback bindingPrevents direct network exposureA local malicious process is still in scope
Bearer tokenAuthenticates every requestStore it only in the local MCP client configuration
Write promptsRequire visible approval for device changesCan be disabled explicitly; read-only profiles still win
Bounded operationsLimits payloads, observations, scans, and project discoveryExhaustive scan requires explicit confirmation