MCP servers for AI agents
The Smart Operations Toolkit provides its functions as tools through MCP servers (Model Context Protocol). The agent in the Agent Chat uses these servers. You can also connect your own AI agents and MCP clients.
Servers
| Function | MCP server | Tools |
|---|---|---|
Devices, device types, measuring points, facilities |
|
|
Measured values, events, rules |
|
|
Process data (read only) |
|
|
Email templates |
|
|
User information and preferences |
|
The servers are called with JSON-RPC over HTTP POST.
Authentication
MCP servers require an access token of the tenant in the Authorization header, like the REST APIs. Every tool checks the same permissions as the corresponding REST endpoint. A client that acts for a user should use the token of this user, so that the user’s permissions apply. See Authentication.
Connecting an MCP client
Example configuration for an MCP client that supports HTTP servers with a bearer token:
{
"servers": {
"sot-master-data": {
"type": "http",
"url": "https://<sot-host>/mdm/tenants/<tenant>/mcp",
"headers": { "Authorization": "Bearer <access token>" }
},
"sot-measured-values": {
"type": "http",
"url": "https://<sot-host>/cm/api/v1/tenants/<tenant>/mcp",
"headers": { "Authorization": "Bearer <access token>" }
}
}
}Recommendations for agents
The agent of the Smart Operations Toolkit follows these rules. Use them for your own agents as well:
-
Look up the device UUID by name or technical ID first. Tools for measured values, events and process data expect the UUID, not the technical ID.
-
Copy IDs, cursors and timestamps exactly from the tool results.
-
Ask the user for confirmation before calling tools that change or delete data. These tools are marked as destructive.
-
For measured values, first request one value per measuring point to get the total count, then load the data in pages of at most 10,000 values. Do not present incomplete data as complete.
-
State time ranges in UTC.
MCP-Server für KI-Agenten
Das Smart Operations Toolkit stellt seine Funktionen als Tools über MCP-Server (Model Context Protocol) bereit. Der Agent im Agent-Chat nutzt diese Server. Auch eigene KI-Agenten und MCP-Clients lassen sich anbinden.
Server
| Funktion | MCP-Server | Tools |
|---|---|---|
Geräte, Gerätetypen, Messpunkte, Anlagen |
|
|
Messwerte, Ereignisse, Regeln |
|
|
Prozessdaten (nur lesend) |
|
|
E-Mail-Vorlagen |
|
|
Benutzerinformationen und Einstellungen |
|
Die Server werden mit JSON-RPC über HTTP POST aufgerufen.
Authentifizierung
MCP-Server erfordern wie die REST-APIs ein Zugriffstoken des Tenants im Header Authorization. Jedes Tool prüft dieselben Berechtigungen wie der entsprechende REST-Endpunkt. Ein Client, der für einen Benutzer handelt, sollte das Token dieses Benutzers verwenden, damit dessen Berechtigungen gelten. Siehe Authentifizierung.
MCP-Client anbinden
Beispielkonfiguration für einen MCP-Client, der HTTP-Server mit Bearer-Token unterstützt:
{
"servers": {
"sot-master-data": {
"type": "http",
"url": "https://<sot-host>/mdm/tenants/<tenant>/mcp",
"headers": { "Authorization": "Bearer <access token>" }
},
"sot-measured-values": {
"type": "http",
"url": "https://<sot-host>/cm/api/v1/tenants/<tenant>/mcp",
"headers": { "Authorization": "Bearer <access token>" }
}
}
}Empfehlungen für Agenten
Der Agent des Smart Operations Toolkit befolgt diese Regeln. Sie eignen sich auch für eigene Agenten:
-
Zuerst die UUID des Geräts über Name oder technische ID ermitteln. Tools für Messwerte, Ereignisse und Prozessdaten erwarten die UUID, nicht die technische ID.
-
IDs, Cursor und Zeitstempel exakt aus den Ergebnissen der Tools übernehmen.
-
Vor dem Aufruf von Tools, die Daten ändern oder löschen, den Benutzer um Bestätigung bitten. Diese Tools sind als destruktiv gekennzeichnet.
-
Bei Messwerten zuerst einen Wert je Messpunkt anfordern, um die Gesamtzahl zu erhalten, dann die Daten in Seiten zu höchstens 10.000 Werten laden. Unvollständige Daten nicht als vollständig darstellen.
-
Zeiträume in UTC angeben.