IN THIS ARTICLE

Incorrect email!

The article was successfully sent to the email

Summary

MCP (Model Context Protocol) lets an AI agent read live TRBOnet data to check system status, investigate communication issues, and find configured radios and users. Access is read-only, with no access to the database or historical data.

You can use any AI agent that supports MCP: ChatGPT Codex, Kimi Claw and Antigravity (with Claude Sonnet and Gemini) were successfully tested with the feature. This article describes setup and use with Codex. AI Agent can summarize the returned data and suggest further checks. A confirmed root cause may require additional diagnostics.

• TRBOnet Server: Enterprise/Plus communication services, voice sessions, mobile client registration, and queues.
• TRBOnet Administrator: Enterprise/Plus radios, users, roles, groups, and other configured objects.
• TRBOnet Watch: network status, active alarms, repeater diagnostics, and monitored computer health.
This guide uses a paid ChatGPT plan with the agent running in Codex mode. Other MCP-compatible agents and connection options are available. This guide covers only this setup.

License Requirements

The MCP option must be active in the license of each application you want to connect: TRBOnet Enterprise/Plus and TRBOnet Watch.

TRBOnet Enterprise/Plus Configuration

1. In TRBOnet Console, open Administration → System Settings → AI MCP Server, then select Configure.
2. Enable the MCP server and select any available TCP port. Make sure another application is not using it.
3. Select HTTP or HTTPS.
MCP settings in TRBOnet Console
HTTP is the simplest option for a local connection. Use HTTPS if your agent requires it or you want to encrypt local traffic. MCP endpoints accept local connections only, regardless of the selected protocol.

4. Select OK to apply the settings. Open Administration → Server → State and check the endpoint URLs under Model Context Protocol Server. Use these URLs when connecting your AI agent.
MCP settings in TRBOnet Console

The server address comes from TRBOnet Enterprise/Plus Server Configurator → Network.

TRBOnet Watch Configuration

1. In TRBOnet Watch Console, open the server menu and select Settings → AI MCP Server.
2. Turn on Enable the MCP server for live data.
3. Copy the URL from Endpoint.
TRBOnet Watch uses a fixed MCP address and port. The configurator has no setting to change the address. The port cannot be changed, so make sure another application is not using it. Only HTTP is supported.

Restarting the TRBOnet Watch service is not required.

MCP settings in TRBOnet Watch Console

Connect Codex

You do not need to edit the Codex configuration manually. Send the following prompt to Codex:

Find the MCP endpoints available in the installed TRBOnet Enterprise/Plus and TRBOnet Watch applications, then add them to my Codex configuration. Name the connections TRBOnet Server, TRBOnet Administrator, and TRBOnet Watch, as applicable. Preserve my existing connections and verify that each new connection works. If you cannot determine an endpoint URL, ask me for it.

Provide only the endpoints you want to use. If Codex requests a restart or approval to update its configuration, follow the prompt.

Optional Manual Configuration

You can also add the connections to %USERPROFILE%\.codex\config.toml. Replace each placeholder below with the full endpoint URL shown in the corresponding console.

[mcp_servers."TRBOnet Server"]
url = "TRBONET_SERVER_ENDPOINT_URL"

[mcp_servers."TRBOnet Administrator"]
url = "TRBONET_ADMINISTRATOR_ENDPOINT_URL"

[mcp_servers."TRBOnet Watch"]
url = "TRBONET_WATCH_ENDPOINT_URL"

For Enterprise/Plus, use the server address, available port, and protocol selected for your installation. For TRBOnet Watch, use the fixed HTTP endpoint shown in the console. See the Codex MCP documentation.

Instructions for Codex Example

Paste these instructions into the chat before requesting diagnostics:

Use the connected TRBOnet MCP tools for system checks. Start with the tools relevant to my question. Keep answers short and use device names. Separate confirmed problems from possible causes. If data is missing or incomplete, say so.

TRBOnet Enterprise/Plus Request Examples

Check mobile client registration and request queues using TRBOnet Server. Show any gateways with pending requests and summarize what needs investigation.

Find the radio named Warehouse using TRBOnet Administrator. Show its configured properties and current status where available.

TRBOnet Watch Request Examples

Check the current TRBOnet Watch network status. List disconnected repeaters and devices with active alarms, grouped by system.

Use TRBOnet Watch to show monitored computers with less than 20% free disk space. Include the computer name, disk, and free space.



Helpful?
We're glad this article helped.

Thanks for letting us know. What went wrong?