KI-Assistenten und API
Caryvane bietet einen MCP-Server und eine passende REST-API, authentifiziert über persönliche Zugriffsschlüssel. Ein Assistent mit einem Schlüssel kann „Welche Backups sind letzte Nacht fehlgeschlagen?“ beantworten, einen Job ausführen, einen Rechner registrieren oder den Speicher eines Kunden einrichten – begrenzt durch die Stufe des Schlüssels und durch das, was der ausstellende Benutzer sehen darf.
Einen Schlüssel erstellen #
- Konsole → Ihr Name (oben rechts) → KI-Zugriffsschlüssel → Neuer Schlüssel. Geben Sie ihm einen Namen, an dem Sie ihn beim Widerrufen wiedererkennen.
- Wählen Sie die Stufe. So wenig Rechte wie für die Aufgabe nötig – ein Schlüssel für einen Berichts-Assistenten sollte Nur lesen sein.
- Kopieren Sie den Schlüssel. Er wird einmal angezeigt, beim Erstellen, und nie wieder. Geht er verloren, widerrufen Sie ihn und stellen einen neuen aus.
| Stufe | Erlaubt |
|---|---|
| Nur lesen | Dashboard, Jobs, Ausführungsverlauf und Protokolle, Agenten und ihre Protokolle, Speicherziele, Kunden, Registrierungstoken, Status der Cloud-Flotte, was der Ausführungsverlauf an Problemen nahelegt, die Gesamtlage eines Kunden und abrechenbare Plätze Monat für Monat. Außerdem das Durchsuchen – sowohl eines Ziels als auch eines Ordners auf einem Ihrer Rechner –, das Namen, Größen und Datumsangaben liefert, nie Dateiinhalte. |
| Lesen + steuern | Lesen, dazu Ausführungen starten und abbrechen. |
| Lesen + steuern + bearbeiten | Dazu Jobs erstellen und bearbeiten, eine Wiederherstellung starten (immer in einen neuen Ordner, nie über Live-Daten), Agenteneinstellungen ändern, Cloud-Laufwerke einbinden und trennen, Registrierungstoken widerrufen, Archive für Microsoft 365 / Google erstellen, ein gesichertes Postfach als PST exportieren, den inkrementellen Hyper-V-Modus eines Agenten festlegen. |
| Vollzugriff | Dazu Jobs löschen, Speicherziele erstellen, Registrierungstoken erstellen, einen Kunden hinzufügen und das Audit-Protokoll lesen (nur Plattformadministratoren). |
| Governance-Tags | Keine Stufe für Assistenten. Nur für Caryvane Governance: Speicherziele auflisten (nie mit Zugangsdaten), Ordner und Dateien nach Namen durchsuchen, Metadatenspalten und Tags lesen, Archivierungsregeln und die Archivübersicht lesen und Tag-Werte setzen – eine Datei oder bis zu 500 pro Aufruf, jeweils als Governance-Vorschlag mit seiner Konfidenz erfasst. Keine Jobs, keine Ausführungen, keine Wiederherstellungen, keine Dateiinhalte und keines der MCP-Tools. Die Routen liegen unter /governance/, mit demselben Bearer-Header. |
Ein Schlüssel sieht genau das, was sein Inhaber sieht: Der Schlüssel eines MSP-Administrators sieht die Kunden dieses MSP, der Schlüssel eines Kundenbenutzers sieht einen Kunden. Jede Aktion eines Schlüssels wird im Audit-Protokoll unter dem Namen des Inhabers erfasst. Schlüssel werden im selben Dialog widerrufen und funktionieren sofort nicht mehr.
Wer einen Schlüssel mit Vollzugriff hat, kann Rechner bei Ihren Kunden registrieren und Backups auf seinen eigenen Speicher umleiten. Bewahren Sie Schlüssel im eigenen Geheimnisspeicher des Assistenten auf, nie in einem geteilten Dokument.
Claude verbinden #
Der MCP-Server ist ein einzelner HTTP-Endpunkt, https://console.caryvane.com/mcp/rpc, mit dem Schlüssel als Bearer-Token. In Claude Code tragen Sie Folgendes in .mcp.json im Projekt ein (oder in ~/.claude.json für alle Projekte):
{
"mcpServers": {
"caryvane": {
"type": "http",
"url": "https://console.caryvane.com/mcp/rpc",
"headers": { "Authorization": "Bearer <key>" }
}
}
}
Oder im Terminal: claude mcp add --transport http caryvane https://console.caryvane.com/mcp/rpc --header "Authorization: Bearer <key>". Claude Desktop und claude.ai nehmen dieselbe URL und denselben Header unter Einstellungen → Konnektoren → Benutzerdefinierten Konnektor hinzufügen (englisch Settings → Connectors → Add custom connector). Lassen Sie sich nach dem Verbinden die Tools auflisten; die Beschreibung jedes Tools ist für den Assistenten geschrieben, sodass er weiß, dass er vor create_job erst list_agents prüfen muss.
VS Code verbinden (Copilot im Agent-Modus) #
Tragen Sie Folgendes in .vscode/mcp.json ein (VS Code fragt einmal nach dem Schlüssel und legt ihn in seinem geschützten Speicher ab):
{
"inputs": [
{ "id": "caryvane-key", "type": "promptString", "password": true, "description": "Caryvane access key" }
],
"servers": {
"caryvane": {
"type": "http",
"url": "https://console.caryvane.com/mcp/rpc",
"headers": { "Authorization": "Bearer ${input:caryvane-key}" }
}
}
}
Die Tools #
Die Namen sind in MCP und in der REST-API unten gleich. Die Stufe ist die mindestens nötige Schlüsselstufe (Lesen = Nur lesen, Steuern = Lesen + steuern, Bearbeiten = Lesen + steuern + bearbeiten).
| Tool | Stufe | Was es tut |
|---|---|---|
get_dashboard | Lesen | Die Startseite der Konsole als Zahlen: Agenten online, Jobs, Ergebnisse der letzten 24 h. |
list_jobs, get_job | Lesen | Jobs, mit Suche und seitenweiser Ausgabe; ein Job vollständig. |
get_job_runs | Lesen | Ausführungsverlauf eines Jobs: Status, Zeiten, Bytes, das Ausführungsprotokoll, fehlgeschlagene Dateien. |
list_agents, get_agent | Lesen | Rechner mit Online-Status, Version, Kunde, letzter Meldung. |
get_agent_logs | Lesen | Das Anwendungsprotokoll des Agenten, wie es an die Konsole übertragen wird; Filter nach Stufe oder Text. |
list_storage_targets | Lesen | Ziele mit Anbieter und letztem Testergebnis. |
browse_storage_target | Lesen | Ordnerliste eines Speicherziels – Namen, Größen, Datumsangaben. Nie Dateiinhalte. |
get_storage_usage | Lesen | Wie viel an jedem Ziel gespeichert ist, mit dem Messdatum. Aus dem nächtlichen Durchlauf zwischengespeichert; ein Ziel ohne Zahl wird als solches gemeldet, nie als null. |
measure_storage_usage | Bearbeiten | Ein Ziel jetzt messen, statt die Zahl der letzten Nacht zu verwenden. Langsam und bei Anbietern mit Abrechnung nach Nutzung kostenpflichtig. |
list_cloud_drives | Lesen | Auf einem Agenten eingebundene Laufwerke. |
list_drive_users, list_user_drives | Lesen | Laufwerksbenutzer (die Personen, die sich auf ihren Computern und Telefonen bei ihren eigenen Laufwerken anmelden) und die Laufwerke jedes Einzelnen. |
browse_backup | Lesen | Was ein Backup enthält, Ebene für Ebene: Art, dann wessen Postfach oder Laufwerk, dann Ordner. Beantwortet „Wessen OneDrive ist das?“. |
search_backup_items | Lesen | Elemente nach Betreff, Absender, Empfänger oder Dateiname finden, eingegrenzt nach Inhaber, Ordner, Datum oder Anhängen. |
name_backup_owners | Bearbeiten | Trägt ein, aus welchem Postfach, Laufwerk oder welcher Website jedes katalogisierte Element stammt, und benennt diese IDs. Nach einem Upgrade einmal pro Job ausführen; füllt nur Lücken. |
read_backup_email | Lesen | Eine gespeicherte E-Mail, dekodiert: Betreff, Absender, Empfänger, Text und die Liste ihrer Anhänge. |
list_metadata_schemas | Lesen | Welche Metadatenspalten für welche Ordner eines Ziels gelten, ihr Typ und welche Pflicht sind. |
set_metadata_schema | Bearbeiten | Die Spalten festlegen, die die Dateien eines Ordners tragen dürfen, als neuer Satz oder als Ersatz; ein leerer Ordnerpfad steht für das Stammverzeichnis des Containers, und Spalten vererben sich im Baum nach unten. Lesen Sie zuerst list_metadata_schemas: Dies ersetzt die Spalten des Ordners. |
list_xero_backups | Lesen | Jede Xero-Organisation, die der Schlüssel sieht, Kunde für Kunde: verbunden oder darauf wartend, dass sich der Kunde erneut bei Xero anmeldet, wohin gesichert wird, ob das erste Backup fertig ist, wie die letzte Ausführung verlief. Der Ausgangspunkt für „Ist Xero gesichert?“ |
get_xero_backup_summary | Lesen | Was das Backup einer Organisation enthält – Anzahlen nach Datensatztyp und Anhänge –, Stand jetzt oder Stand eines beliebigen früheren Datums. |
get_xero_backup_usage | Lesen | Xero-API-Aufrufe und heruntergeladene Bytes in diesem Kalendermonat im Vergleich zum Kontingent, pro Organisation oder für jedes abgerechnete Konto, das der Schlüssel sieht. |
verify_xero_backup | Lesen | Ein Backup gegen die Saldenliste von Xero prüfen: Forderungen und Verbindlichkeiten, aus den gesicherten Rechnungen, Gutschriften und Überzahlungen neu berechnet, müssen mit ihr übereinstimmen. Macht keine Xero-Aufrufe. |
preview_xero_backup_invoice | Vollzugriff | Plattformadministratoren: wie die Rechnung eines Kunden für das Xero-Backup in einem Kalendermonat aussähe – Organisationen, genutzte und enthaltene Daten, Mehrverbrauch, Summe. Speichert und versendet nichts. |
get_file_metadata | Lesen | Die Tags einer Datei, ihr Klassifizierungsstatus und alle noch fehlenden Pflichtspalten. |
query_file_metadata | Lesen | Getaggte Dateien auf einem Ziel finden – nach Ordner, nach Spaltenwert oder alles, was noch klassifiziert werden muss. |
set_file_metadata | Bearbeiten | Eine Datei taggen. Ersetzt ihren gesamten Wertesatz; unbekannte Spaltenschlüssel werden abgelehnt. |
list_archive_rules | Lesen | Die Archivierungsregeln eines Ziels: welche Ordner markiert sind, wie alt eine Datei sein muss und ob die Archivierung für dieses Ziel überhaupt eingeschaltet ist. |
set_archive_rules | Bearbeiten | Ordner für die Archivierung markieren, viele auf einmal mit derselben Regel – die eigentliche Form einer Anfrage wie „5445 bis 5460 nach einem Jahr archivieren“. Die Antwort listet die Regeln so, wie sie gespeichert wurden, und jeden abgelehnten Ordner. Regeln bewirken nichts, bis ein Archivierungs-Job läuft. |
remove_archive_rule | Bearbeiten | Die Regel eines Ordners entfernen; er folgt dann dem, was darüber markiert ist, oder nichts. |
list_vss_instances | Lesen | Was ein Windows-Agent anwendungskonsistent sichern kann: Hyper-V-VMs, SQL-Datenbanken, AD. Live vom Rechner. |
list_machine_disks | Lesen | Die Datenträger eines Windows-Agenten: Nummer, Größe, Typ, Laufwerksbuchstaben und ob ein Abbild möglich ist. Live vom Rechner. |
list_customers | Lesen | Die Kunden, die der Inhaber des Schlüssels sieht. |
list_enrollment_tokens | Lesen | Aktive Registrierungstoken. |
get_customer_health | Lesen | Die Gesamtlage eines Kunden für ein Ticket: stille Rechner, Jobs, deren letzte Ausführung fehlgeschlagen ist oder eine Warnung hatte, nie ausgeführte Jobs, Ziele, deren Anmeldung verloren ging. |
get_customer_report | Lesen | Der Monatsbericht eines Kunden als Zahlen, nie die E-Mail: der archivierte Bericht wie versendet oder live erstellt. Nicht gemessen ist nicht null. Mit includePdf kommt auch das PDF in Ihrem Branding zurück. |
get_billing_usage | Lesen | Monat für Monat pro Kunde: Rechner zum Monatsende, Cloud-Guthaben und genutzte GB, Rechnungsbetrag und ob er bezahlt wurde. Der laufende Monat ist eine Zwischensumme, keine Rechnung. |
browse_agent | Lesen | Einen Ordner auf einem Rechner live auflisten. Nur Namen, Größen und Datumsangaben. |
list_file_versions | Lesen | Frühere Versionen einer Datei an einem Ziel, die neueste zuerst. |
restore_files | Bearbeiten | Aus einem Backup auf den Rechner wiederherstellen, der es erstellt hat. Immer in einen neuen Ordner mit Zeitstempel – Live-Daten kann es nie überschreiben. |
create_customer | Vollzugriff | Ein Konto an beliebiger Stelle in Ihrem eigenen Baum hinzufügen – einen Kunden oder, für einen Distributor, einen MSP darunter. Übergeben Sie parentTenantId und tenantType; der Server lehnt Kombinationen ab, die der übergeordnete Kunde nicht besitzen darf. |
get_audit_events | Vollzugriff | Wer was wann getan hat. Nur Plattformadministratoren. |
get_access_audit | Vollzugriff | Wer was wiederhergestellt, heruntergeladen, in der Vorschau angesehen, durchsucht oder gelöscht hat, für die Kunden, die Ihr Schlüssel sieht, gefiltert nach Kunde, Zeitraum, Aktionstyp und Person. Siehe Zugriffsbericht. |
add_drive_user | Vollzugriff | Einem Kunden einen Laufwerksbenutzer hinzufügen, der sich mit Microsoft, Google oder einem Passwort anmeldet. Hat der Kunde Microsoft 365 oder Google Workspace verbunden, muss die Person dort ein aktiviertes Mitglied sein (kein Gast), und ihr Konto wird verknüpft, sodass sich niemand aus einer anderen Organisation als sie anmelden kann. |
set_drive_user_status | Vollzugriff | Einen Laufwerksbenutzer deaktivieren (ausscheidende Person, verlorenes Telefon) oder wieder aktivieren. Jedes Gerät wird bei seiner nächsten Anfrage abgemeldet. |
get_stale_data_report | Lesen | Die veralteten und verwaisten Daten eines Kunden: seit N Jahren nicht geänderte Dateien, Postfächer und Laufwerke ausgeschiedener Personen und was ins Archiv wandern könnte, mit Entwürfen für Archivierungsregeln, die es nie anwendet. Siehe Bericht über veraltete Daten. |
get_insights | Lesen | Was der Ausführungsverlauf nahelegt: Jobs, die häufiger fehlschlagen als früher, wie viel jeder im Vergleich zum Vormonat überträgt und welche noch Verlauf aufbauen. |
get_cloud_fleet, get_cloud_worker_jobs | Lesen | Cloud-Agent-Worker und was sie gerade ausführen. |
run_job, cancel_job | Steuern | Jetzt eine Ausführung starten; die laufende abbrechen. |
create_job, update_job | Bearbeiten | Jede Option des Job-Assistenten der Konsole: Dateien, Speicher zu Speicher, Connector, anwendungskonsistent, Cloud oder Agent, Zeitplan, Aufbewahrung. |
update_agent_settings | Bearbeiten | Anzeigename, Grenze für gleichzeitige Jobs, Upload-Limit. |
set_hyperv_rct_mode | Bearbeiten | Off / Diag / Compose für inkrementelle Hyper-V-Backups geänderter Blöcke auf einem Agenten. |
mount_cloud_drive, unmount_cloud_drive | Bearbeiten | Ein Laufwerk auf einem Agenten hinzufügen oder entfernen. |
assign_user_drive, remove_user_drive | Bearbeiten | Einem Laufwerksbenutzer ein Cloud-Laufwerk geben oder wegnehmen. Es folgt ihm auf jeden Computer und jedes Telefon, an dem er sich anmeldet. Dateien im Speicher werden nie angetastet. |
create_office365_archive, create_google_workspace_archive | Bearbeiten | Ein einmaliges Archiv von Postfach und Laufwerk einer Person – der Ablauf für ausscheidende Personen. |
preview_office365_pst_export | Lesen | Vor einem Export: wie viele Nachrichten eine Auswahl umfasst und ungefähr wie groß sie sind, allein aus dem Katalog des Backups. Ein Postfach, optional ein Ordner (mit oder ohne Unterordner) und alle Mails, nur Mails älter als N Tage oder ein Zeitraum. Aus dem Speicher wird nichts gelesen; Nachrichten, die ohne Größe katalogisiert wurden, machen die Summe zu einer Untergrenze. |
create_office365_pst_export | Bearbeiten | E-Mails, die ein Microsoft-365-Backup bereits enthält, als PST-Dateien exportieren, geteilt bei etwa 3 GB, mit einem Bericht daneben, der jede ausgelassene Nachricht nennt. Dieselbe Auswahl wie in der Vorschau; die Dateien gehen in einen Ordner auf einem der Agenten des Kunden oder in ein Speicherziel, ausgeführt vom Agenten, dem das Backup gehört, einem anderen Agenten des Kunden oder der Caryvane-Cloud (ein Cloud-Guthaben; nur in ein Speicherziel). Das Backup wird nur gelesen. Nicht in der Testphase. Siehe Export als PST. |
list_office365_pst_exports | Lesen | Die bisher angeforderten Exporte und wie jeder geendet hat: geschriebene, übersprungene und fehlgeschlagene Nachrichten, die Zahl der PST-Dateien und wo sie und der Bericht liegen. Optional für einen Backup-Job. |
revoke_enrollment_token | Bearbeiten | Ein Token vorzeitig ungültig machen. |
create_enrollment_token | Vollzugriff | Ein Registrierungstoken für einen Kunden, mit dem fertigen Installationsbefehl. |
create_storage_target | Vollzugriff | Ein neues Ziel mit seinen Zugangsdaten. Übergeben Sie customerTenantId, um es für einen Kunden statt für sich selbst anzulegen. |
clone_storage_target | Vollzugriff | Ein neues Ziel, das die Zugangsdaten eines bestehenden wiederverwendet, ohne dass jemand die Schlüssel in die Hand nimmt: Sie bleiben auf dem Server. Wählen Sie einen neuen Bucket (optional mit Object Lock angelegt) und den Versionsverlauf; Unveränderlichkeit wird nie kopiert. Nicht für Speicher, der per Anmeldung verbunden ist. |
delete_job | Vollzugriff | Einen Job samt Verlauf entfernen. |
Sieht der Inhaber des Schlüssels mehrere Kunden, verlangen Tools, die etwas anlegen, einen Kunden: create_job leitet ihn vom Agenten ab oder braucht für einen Cloud-Agent-Job customerTenantId; create_enrollment_token nimmt tenantId. Nichts kann über eine Kundengrenze hinweg angelegt werden – ein Job kann nicht den Speicher eines Kunden lesen und in den eines anderen schreiben.
Die REST-API #
Dieselben Operationen als einfaches JSON über HTTPS, für Skripte, RMM-Integrationen und jeden Assistenten, der HTTP statt MCP spricht. Derselbe Schlüssel, derselbe Header: Authorization: Bearer <key>. Antworten sind JSON; Fehler sind Standard-Statuscodes mit einer Meldung.
curl -s https://console.caryvane.com/mcp/jobs?take=50 \
-H "Authorization: Bearer <key>"
curl -s -X POST https://console.caryvane.com/mcp/jobs/14/run \
-H "Authorization: Bearer <key>"
| Methode und Pfad | Tool |
|---|---|
GET /mcp/dashboard | get_dashboard |
GET /mcp/insights | get_insights |
GET /mcp/customers/{id}/stale-data | get_stale_data_report |
GET /mcp/customers/health, GET /mcp/billing/usage | get_customer_health, get_billing_usage |
GET /mcp/customers/{id}/monthly-report | get_customer_report |
POST /mcp/agents/{id}/files | browse_agent |
GET /mcp/storage-targets/{id}/versions | list_file_versions |
POST /mcp/restore | restore_files |
POST /mcp/customers, GET /mcp/audit, GET /mcp/audit/access | create_customer, get_audit_events, get_access_audit |
GET /mcp/jobs, GET /mcp/jobs/{id}, GET /mcp/jobs/{id}/runs | list_jobs, get_job, get_job_runs |
POST /mcp/jobs, POST /mcp/jobs/{id}/update, POST /mcp/jobs/{id}/delete | create_job, update_job, delete_job |
POST /mcp/jobs/{id}/run, POST /mcp/jobs/{id}/cancel | run_job, cancel_job |
GET /mcp/agents, GET /mcp/agents/{id}, GET /mcp/agents/{id}/logs | list_agents, get_agent, get_agent_logs |
POST /mcp/agents/{id}/settings | update_agent_settings |
GET /mcp/agents/{id}/mounts, POST /mcp/agents/{id}/mounts, POST /mcp/agents/{id}/mounts/{mountId}/delete | list_cloud_drives, mount_cloud_drive, unmount_cloud_drive |
GET /mcp/agents/{id}/vss-instances | list_vss_instances |
GET /mcp/agents/{id}/machine-disks | list_machine_disks |
GET /mcp/drive-users, POST /mcp/drive-users, PATCH /mcp/drive-users/{id} | list_drive_users, add_drive_user, set_drive_user_status |
GET /mcp/drive-users/{id}/drives, POST /mcp/drive-users/{id}/drives, POST /mcp/drive-users/{id}/drives/{driveId}/delete | list_user_drives, assign_user_drive, remove_user_drive |
GET /mcp/storage-targets, POST /mcp/storage-targets, GET /mcp/storage-targets/{id}/browse, GET /mcp/storage-targets/usage, POST /mcp/storage-targets/{id}/measure-usage, POST /mcp/storage-targets/{id}/clone | list_storage_targets, create_storage_target, clone_storage_target, browse_storage_target, get_storage_usage, measure_storage_usage |
GET /mcp/storage-targets/{id}/archive-rules, POST /mcp/storage-targets/{id}/archive-rules, POST /mcp/storage-targets/{id}/archive-rules/{ruleId}/delete | list_archive_rules, set_archive_rules, remove_archive_rule |
GET /mcp/customers | list_customers |
GET /mcp/enrollment-tokens, POST /mcp/enrollment-tokens, POST /mcp/enrollment-tokens/{id}/revoke | list_enrollment_tokens, create_enrollment_token, revoke_enrollment_token |
POST /mcp/office365/archives, POST /mcp/google-workspace/archives | create_office365_archive, create_google_workspace_archive |
GET /mcp/office365/pst-exports/preview, POST /mcp/office365/pst-exports, GET /mcp/office365/pst-exports | preview_office365_pst_export, create_office365_pst_export, list_office365_pst_exports |
Parameter sind die Argumente des Tools als JSON im Body (POST) oder im Query-String (GET). Die MCP-Tool-Beschreibungen, die der Assistent sieht, sind die maßgebliche Feldreferenz; ein OpenAPI-Dokument für eine Custom-GPT-Action in ChatGPT ist geplant, aber noch nicht veröffentlicht.
Was ein Assistent nicht kann #
Bewusst gibt es kein Tool, das den Inhalt einer Datei herunterlädt, Dateien aus dem Speicher löscht oder verschiebt. Das Durchsuchen liefert nur Metadaten, ob es sich um ein Ziel oder einen Ordner auf einem Ihrer Rechner handelt.
Ein Assistent kann eine Wiederherstellung starten, und zwei Dinge begrenzen, was das bedeutet. Die Dateien wandern zwischen Ihrem Speicher und Ihrem Rechner, ohne den Assistenten oder uns zu passieren: Der Agent holt sie direkt aus Ihrem Speicher. Und eine Wiederherstellung kann nie überschreiben, was bereits vorhanden ist – sie landet immer in einem neuen Ordner mit Zeitstempel innerhalb des Ordners, den Sie angeben, sodass die Kopie, mit der Sie vergleichen wollten, noch da ist, wo Sie sie gelassen haben. Etwas zurückzuverschieben ist die Entscheidung eines Menschen. Jede Wiederherstellung ist ein Job und erscheint daher wie jeder andere in der Jobliste und ihrem Ausführungsverlauf.
Die einzige Operation, die Daten entfernt – ein Archivierungs-Job mit eingeschaltetem Entfernen an der Quelle –, wird wie jeder andere Job angelegt, mit dieser Sperre standardmäßig aus, sofern sie nicht ausdrücklich gesetzt wird, und jede Datei, die er entfernt, wird zuvor im Katalog erfasst.
read_backup_email ist die einzige Stelle, an der ein Assistent das Innere von etwas sieht, deshalb lohnt es sich, genau zu sagen, was das heißt. Es liest eine Nachricht, die Sie uns bereits zum Sichern gegeben haben, dekodiert aus der Kopie in Ihrem eigenen Speicher, und nur, wenn genau dieses Element per ID angefordert wird. Es ist keine Suche in Nachrichtentexten: search_backup_items durchsucht Betreff, Absender, Empfänger und Dateinamen, nie den Text. Nichts indexiert den Inhalt Ihrer E-Mails.
Das Taggen verdient einen eigenen Hinweis, weil es harmlos aussieht und das nicht ganz ist. set_file_metadata ersetzt den gesamten Wertesatz einer Datei, statt ihn zusammenzuführen; alles, was Sie weglassen, wird also entfernt – lesen Sie die Datei zuerst, wenn Sie nur eine Spalte ändern wollen. Und eine Archivierungsregel kann an ein Tag gebunden sein, sodass die Änderung eines Tags beeinflussen kann, ob eine Datei irgendwann archiviert wird. Sie kann aber nie bewirken, dass eine Datei archiviert wird, die nicht ohnehin alt genug war und nicht bereits unter eine Regel fiel: Eine Bedingung schränkt immer nur ein.
Metadaten werden nie aus dem Inneren Ihrer Dateien gelesen. Es ist das, was jemand eingegeben hat, oder was aus SharePoint, Egnyte oder Google Drive übernommen wurde – wir öffnen kein Dokument, um zu entscheiden, worum es darin geht.
Weiterführende Themen #
- Claude — Claude Code, Desktop und claude.ai Schritt für Schritt
- VS Code — Copilot im Agent-Modus, der Schlüssel im geschützten Speicher
- Skripte für die API — PowerShell- und curl-Beispiele für RMM und Berichte