Devices MCP tools
Vizualizați toate cele 6 instrumente ale platformei MCP pentru dispozitive, cu scheme de intrare, scheme de ieșire și sfaturi de comportament pentru construirea integrărilor agenților AI
This page documents 6 tools în grupul de dispozitive. Înapoi la complete MCP tool reference to browse another group.
Selectați un instrument pentru a inspecta schemele și comportamentul său. Schema link-uri deschide definiția exactă în GitHub.
listDevicesList DevicesCitește numaiLista dispozitivelor ITAM pentru o organizație. Utilizați createDevice pentru a emite un dispozitiv PENDING și un token de înscriere cu o singură lovitură pentru instalatorul agentului. Dispozitivul afirmă: PENDING (tokenul de înscriere emis, agentul nu a verificat niciodată), ACTIVE (bătăile inimii agentului), REVOKED (înregistrarea revocată). Utilizați last_seen_at ca semnal de stagnare. latest_postures este gol, cu excepția cazului în care include_postures este adevărat; când este încărcat, acesta deține cel mai nou rezultat per check_key și este gol pentru dispozitivele PENDING. Pagina cu dimensiune și cursor; când next_cursor este prezent, trece ca cursor la următoarea apelare.
getDeviceGet DeviceCitește numaiObțineți un dispozitiv ITAM prin ID (dispozitivele șterse ușor nu sunt returnate). Aceeași mașină de stare ca listDevices: PENDING (token de înregistrare emis, agentul nu a verificat niciodată), ACTIVE (agentul bate inima), REVOKED (enrollment revocat). Utilizați last_seen_at ca semnal de stagnare. latest_postures este gol, cu excepția cazului în care include_postures este adevărat; când este încărcat, acesta deține cel mai nou rezultat pe check_key și este gol pentru dispozitivele PENDING.
createDeviceCreate DeviceWrites dataCreați un dispozitiv PENDING ITAM și returnați un token de înregistrare cu o singură lovitură (plus server_url și enrollment_url) pentru instalatorul agentului. Tokenul plaintext este afișat numai în acest răspuns; numai hash-ul său este stocat. Tokenul expiră, de asemenea, după o durată de viață configurată de implementare (7 zile în mod implicit), deci dați-l instalatorului acum în loc să-l stocați pentru o retragere ulterioară: schimbul unui token expirat nu reușește cu tokenul de înregistrare expirat și lasă dispozitivul PENDING și trebuie să apelați din nou la createDevice pentru a emite un dispozitiv și token proaspăt. Opțional atribuiți un proprietar cu owner_id
revokeDeviceRevoke DeviceWrites dataAnulează irevocabil înregistrarea unui dispozitiv. Invalidează imediat cheia agentului dispozitivului API astfel încât agentul să înceteze autentificarea și raportarea; nu există nici un instrument care să nu fie revocat. Siguranță pentru a apela mai mult de o dată: statul rămâne REVOKED și revoked_at își păstrează valoarea inițială. Apelați acest lucru înainte de a ștergeDevice.
deleteDeviceDelete DeviceWrites dataȘtergeți ușor un dispozitiv. Dispozitivul trebuie să fi fost deja REVOKED – apelați revokeDevice mai întâi, altfel apelul nu reușește cu dispozitivul de eroare nu poate fi șters. După succes, dispozitivul încetează să apară în listDevices/getDevice; tokenurile de înregistrare pentru dispozitiv sunt eliminate.
setDeviceOwnerSet Device OwnerWrites dataSetarea sau ștergerea proprietarului unui dispozitiv ITAM. owner_id este necesar: treceți un GID MembershipProfile aparținând aceleiași organizații ca dispozitivul care trebuie atribuit sau null pentru a șterge. omiterea câmpului este nulă.