> ## Documentation Index > Fetch the complete documentation index at: https://www.docusnap.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # MCP – Werkzeuge > Welche Werkzeuge Docusnap365 Ihrem KI-Tool über MCP bereitstellt, welche nur lesen und was Sie wissen sollten, bevor ein KI-Tool Daten ändert. Docusnap365 stellt Ihrem KI-Tool 27 Werkzeuge bereit. Jedes hat genau eine Aufgabe, etwa Risiken suchen oder den Bearbeitungsstand eines CVE-Fundes ändern. 19 Werkzeuge lesen, acht ändern Daten. Wie Sie das KI-Tool verbinden, steht unter [MCP – Grundlagen](https://www.docusnap.com/docs/de/api/mcp.md). ## Lesen und Ändern Docusnap365 teilt Ihrem KI-Tool zu jedem Werkzeug mit, ob es Daten ändert. Die lesenden Werkzeuge sind als nur lesend gekennzeichnet. `create_comment` und `create_inventory_object` fügen nur Neues hinzu. `update_comment`, `delete_comment`, `update_risk`, `update_cve_status`, `update_inventory_object` und `delete_inventory_object` überschreiben oder entfernen bestehende Daten. Die ändernden Werkzeuge setzen die passende Zugriffsstufe voraus. Mit der Stufe *Leser* stehen nur die lesenden Werkzeuge bereit (siehe [Benutzer › Modulzugriff](https://www.docusnap.com/docs/de/settings/users.md#modulzugriff)). Ein Werkzeug, das Sie nicht nutzen dürfen, lehnt Docusnap365 ab. ## ISMS | Werkzeug | Tut | | - | - | | `search_risks` | Risiken suchen, ohne Filter die am höchsten bewerteten zuerst | | `get_risk` | ein Risiko vollständig lesen | | `update_risk` | Wahrscheinlichkeit, Auswirkung, Behandlung, Verantwortlichen, Überprüfungstermin oder Namen eines Risikos ändern | | `search_controls` | Maßnahmen suchen, auch überfällige | | `get_control` | eine Maßnahme vollständig lesen | | `search_assessments` | die Bewertungen der aktivierten Regelwerke suchen, ein Ergebnis je bewertbarem Ziel | `update_risk` ändert nur die Felder, die das KI-Tool angibt, und mindestens eines. Wahrscheinlichkeit und Auswirkung nehmen Werte von 1 bis 10 an und lassen sich nur ändern, solange das Risiko die Lebenszyklus-Phase *Identifiziert* oder *Bewertet* hat. ## CVE | Werkzeug | Tut | | - | - | | `search_cves` | CVE-Funde suchen, etwa nach CVE-Nummer, CVSS-Wert, Schweregrad oder Status | | `get_cve` | einen CVE-Fund über seine Id oder seine CVE-Nummer lesen | | `list_affected_assets` | die von einem CVE-Fund betroffenen Geräte auflisten | | `update_cve_status` | Bearbeitungsstand, Begründung, Verantwortlichen und Frist eines CVE-Fundes ändern | Die Status *Akzeptiert* und *Falschmeldung* verlangen eine Begründung. Eine Begründung oder Frist lässt sich entfernen, indem das KI-Tool sie auf leer setzt. > [!NOTE] > > Die CVE-Werkzeuge arbeiten mit CVE-Funden aus Scans. Die Schwachstellen des ISMS sind etwas anderes und gehören nicht dazu. ## ITAM | Werkzeug | Tut | | - | - | | `search_warranties` | Garantien suchen, nach Ende der Deckung sortiert | | `search_itam_assets` | die ITAM-Sicht auf das Inventar durchsuchen: Lebenszyklus, Kritikalität, Lebensende, Validierung und Vollständigkeit | | `search_cost_sources` | die Verträge und Lizenzvereinbarungen unter ITAM › *Kosten verwalten* suchen | Die Beträge und Mengen aus `search_cost_sources` beziehen sich auf den laufenden Monat. Die Antwort nennt ihn. ## Dokumente | Werkzeug | Tut | | - | - | | `search_documents` | Dokumente suchen, zuletzt geänderte zuerst | | `get_document` | die Eigenschaften eines Dokuments lesen, ohne den Inhalt der Kapitel | ## Inventar | Werkzeug | Tut | | - | - | | `list_object_types` | die Typen auflisten, Standardtypen und selbst definierte | | `describe_object_type` | die Felder eines Typs mit Datentyp und Auswahlwerten beschreiben | | `search_inventory` | Assets suchen, wahlweise mit Gerätezusammenfassung und Feldern des Typs | | `get_inventory_object` | ein Asset mit allen Einzelwerten seines Typs lesen | | `create_inventory_object` | ein Asset anlegen | | `update_inventory_object` | Name, Organisation, Standort und Felder eines Assets ändern | | `delete_inventory_object` | ein Asset löschen | Die Felder eines Typs unterscheiden sich je Typ. Eine Suche nach Feldwerten in `search_inventory` setzt deshalb einen Typ voraus. Welche Felder ein Typ trägt, steht im [Datenmodell](https://www.docusnap.com/docs/de/api/data-model.md). `search_inventory` liefert CPU, RAM, Modell, Hersteller und die Zahl der installierten Softwarepakete mit, filtern lässt sich danach nicht. > [!NOTE] > > Ein gelöschtes Asset landet im [Papierkorb](https://www.docusnap.com/docs/de/getting-started/trash.md) und lässt sich dort wiederherstellen. `delete_inventory_object` löscht nur Assets. Eine Id, die zu etwas anderem gehört, lehnt das Werkzeug ab. > [!NOTE] > > `create_inventory_object` lehnt einen Namen ab, den ein Asset desselben Typs schon trägt, und nennt das vorhandene Asset. `update_inventory_object` lehnt aus demselben Grund eine Umbenennung ab. Ein durch einen Scan gefundenes Asset lässt sich nicht umbenennen. ## Kommentare und Beziehungen | Werkzeug | Tut | | - | - | | `list_comments` | die Kommentare eines Datensatzes in der Reihenfolge ihres Entstehens lesen | | `create_comment` | einen Kommentar oder eine Antwort anlegen | | `update_comment` | den Text eines Kommentars ersetzen | | `delete_comment` | einen Kommentar löschen | | `list_relations` | die Beziehungen eines Datensatzes lesen, gruppiert nach der Art des Gegenübers | Ändern und löschen lassen sich nur eigene Kommentare. Ein Datensatz ohne Kommentare und eine Id, die zu keinem Datensatz gehört, liefern dasselbe Ergebnis. ## Gemeinsame Regeln der Suchwerkzeuge Alle Werkzeuge, die mit `search_` beginnen, sowie `list_comments` und `list_object_types` verhalten sich gleich: | Angabe | Wirkung | | - | - | | `limit` | Anzahl der Treffer, Vorgabe 25, höchstens 100. Ein Wert außerhalb wird abgelehnt, nicht gekürzt. | | `sort_by` | Sortierung nach einer der angebotenen Optionen. Nach `cvss`, `score`, `affected_assets`, `modified`, `monthly_costs` und `completeness` sortiert eine ausdrückliche Wahl absteigend, nach den übrigen aufsteigend, sofern `sort_descending` nicht etwas anderes sagt. | | `cursor` | setzt eine Suche auf der nächsten Seite fort. Er gilt nur zusammen mit den Parametern der Suche, aus der er stammt, sonst lehnt das Werkzeug ihn ab. | | `count_only` | liefert nur die Zahl der Treffer. Gezählt werden bis zu 2000 Treffer, bei mehr ist die Zahl unvollständig und die Antwort rät, die Suche einzugrenzen. Mit `cursor` lässt sich `count_only` nicht kombinieren. | Ein Parameter, den das Werkzeug nicht kennt, wird abgelehnt. ## Weiterführend Wie Sie das KI-Tool verbinden, welche Rechte es hat und wie das Kontingent zählt, steht unter [MCP – Grundlagen](https://www.docusnap.com/docs/de/api/mcp.md). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.