Tovább a tartalomhoz

MCP — toolok

A szerver jelenleg 36 toolt kínál. A lista a művelet- registryből generálódik, és megegyezik a REST API műveleteivel — a tool neve a POST /v1/ops/<név> végpontnak felel meg.

A jelleg oszlop: olvasó (csak lekérdez), író (létrehoz/módosít), destruktív (töröl — mindig támogat dry_run-t).

Eszköz típusok

ToolJellegLeírás
copy_device_type_versioníróEszköztípus másolása új verzióként (a szenzor-hozzárendelésekkel együtt).
create_device_typeíróÚj eszköztípus létrehozása, opcionálisan szenzorsablon-hozzárendelésekkel.
delete_device_typedestruktívEszköztípus törlése. Eszköz által használt típus nem törölhető. dry_run támogatott.
get_device_typeolvasóEszköztípus részletei a hozzárendelt szenzorsablonokkal.
list_device_typesolvasóA szervezet eszköztípusai.
update_device_typeíróEszköztípus módosítása; template_ids megadásakor a szenzorsablon-hozzárendelések teljes cseréje.

Eszközök

ToolJellegLeírás
create_deviceíróÚj eszköz létrehozása; type_id megadásakor a szenzorlista a típusból automatikusan létrejön.
delete_devicedestruktívEszköz törlése minden kapcsolódó adattal (szenzorok, riasztások, mért értékek). dry_run=true: csak a törlési terv darabszámai.
delete_sensordestruktívEgy szenzor törlése az eszközről (riasztási eseménnyel rendelkező szenzor nem törölhető). dry_run támogatott.
get_deviceolvasóEgy eszköz részletei: adatok, szenzorok az aktuális értékekkel, legutóbbi riasztások.
get_device_historyolvasóEgy szenzor előzmény-értékei (legutóbbiak elöl).
list_devicesolvasóA szervezet eszközei (kereshető, lapozható).
purge_archived_incidentsdestruktívAz eszköz archivált riasztási eseményeinek végleges törlése. dry_run támogatott.
set_test_valuesíróTeszt szenzorértékek rögzítése egy eszközre (a korábbi érték automatikusan az előzményekbe kerül).
sync_device_typeíróAz eszköz szenzorlistájának szinkronja egy eszköztípusra (egyezők maradnak, hiányzók inaktiválódnak, újak felkerülnek). dry_run támogatott.
update_deviceíróEszköz adatainak módosítása (a szenzorlistát a sync_device_type kezeli).

Helyszínek

ToolJellegLeírás
create_placeíróÚj helyszín létrehozása a szervezetben.
delete_placedestruktívHelyszín törlése. Eszközzel rendelkező helyszín nem törölhető (a válasz megmondja, hány eszköz hivatkozik rá). dry_run támogatott.
list_placesolvasóA szervezet helyszínei.
update_placeíróHelyszín módosítása.

Riasztási események

ToolJellegLeírás
list_incidentsolvasóRiasztási események (szűrhető, lapozható; az archiváltak külön kérhetők).
set_incident_statusíróRiasztási esemény státuszának állítása (acknowledged / resolved / archived).

Riasztási szabályok

ToolJellegLeírás
create_alert_ruleíróÚj riasztási szabály létrehozása tartományokkal és hozzárendelésekkel.
delete_alert_ruledestruktívSzabály törlése (tartományaival és hozzárendeléseivel). Riasztási eseménnyel rendelkező szabály nem törölhető. dry_run támogatott.
get_alert_ruleolvasóSzabály részletei a tartományokkal és a szenzor-hozzárendelésekkel.
get_run_resultolvasóEgy szabályfutás eredménye: a runlog sora és a szabályonkénti találatok.
list_alert_rulesolvasóA szervezet riasztási szabályai.
run_alert_ruleíróRiasztási szabály azonnali (kézi) futtatása; a létrejött események számát adja vissza.
set_rule_enabledíróSzabály engedélyezése / letiltása.
update_alert_ruleíróSzabály módosítása; ranges/assignments megadásakor azok teljes cseréje.

Szenzor típusok

ToolJellegLeírás
create_sensor_templateíróÚj szenzorsablon létrehozása.
delete_sensor_templatedestruktívSzenzorsablon törlése. Használatban lévő sablon (eszköz-szenzor, eszköztípus vagy szabály hivatkozik rá) nem törölhető. dry_run támogatott.
list_sensor_templatesolvasóA szervezet szenzorsablonjai.
update_sensor_templateíróSzenzorsablon módosítása.

Szervezetek

ToolJellegLeírás
list_my_organisationsolvasóA bejelentkezett felhasználó szervezetei (tagságai).

Tesztadatok

ToolJellegLeírás
run_testdata_generationíróTeszt-szervezet generálása demó adatokkal (helyszínek, típusok, sablonok, eszközök).