Jedem Zaru-Lauf nur die Verbindungen geben, die er braucht

Auch auf: English, Español, Português, 日本語, Français, 한국어, 简体中文, Italiano, हिन्दी · Alle Anleitungen auf Deutsch

Offenlegung: Zaru wird von 100monkeys AI, Inc. entwickelt, lesen Sie diese Anleitung also als Bericht des Herstellers. Einer unserer KI-Agenten hat sie aus der Seite Profiles der Zaru-Dokumentation (auf Englisch), gelesen am 29. Oktober 2026, und aus den Formulierungen dieser Website entworfen, und das Unternehmen hat sie geprüft; diese deutsche Fassung ist eine Übersetzung der englischen Originalanleitung. Jede unten zitierte Regel und Meldung stammt von dieser Seite; Zitate bleiben auf Englisch, mit der Übersetzung daneben. Wo sie nicht sagt, wie etwas funktioniert, sagen wir das, statt es zu beschreiben.

Sobald Zaru Ihr Postfach, Ihren Kalender und ein GitHub-Token hält, stellt sich die Frage, welche davon eine bestimmte Unterhaltung, ein Lauf oder ein Zeitplan berühren darf. Ein Profil beantwortet sie mit einer Wahl: eine benannte Menge Ihrer Verbindungen und der Werkzeuge, die sie nutzen dürfen. Ein Lauf ohne Profil und ohne gewählte Verbindungen erreicht keine davon. Diese Anleitung legt ein Profil an, grenzt seine Werkzeuge ein und nutzt es in einem Chat, einem Zeitplan und einem MCP-Client.

Was ein Profil ist

Die Dokumentation: Ein Profil ist "your own named set of connections (a mailbox, a calendar account, a Carbon Forge (formerly Nuclear Notes) token, a GitHub token and so on, any number of any kind) with a list of the tools they may use, and optional defaults." (Ihre eigene benannte Menge von Verbindungen, etwa ein Postfach, ein Kalenderkonto, ein Carbon-Forge-Token, früher Nuclear Notes, ein GitHub-Token, beliebig viele jeder Art, mit einer Liste der Werkzeuge, die sie nutzen dürfen, und optionalen Standardwerten.) Die Regel, die es nützlich macht, steht auf der Seite Profiles selbst über der Liste: "A run, a schedule or an API key reaches only the connections a profile names. Without one it reaches none." (Ein Lauf, ein Zeitplan oder ein API-Schlüssel erreicht nur die Verbindungen, die ein Profil nennt. Ohne Profil erreicht er keine.)

Schritt 1. Ein Konto anlegen und verbinden, was Sie nutzen

Klicken Sie auf Get Zaru free; für die Registrierung genügen ein Name und eine E-Mail-Adresse. Verbinden Sie E-Mail und Kalender im Vault, wie die Website es beschreibt. Ein Profil kann nur Verbindungen aufführen, die Sie bereits haben, also zuerst verbinden.

Schritt 2. Vault, Profiles öffnen

Die Liste liegt unter /vault/profiles und zeigt jedes Profil mit seinen Verbindungen und der Zahl seiner Werkzeuge. Klicken Sie auf New profile. Dasselbe Formular bearbeitet ein Profil später.

Schritt 3. Es nach einer Aufgabe benennen und seine Verbindungen wählen

Ein Name hat 1 bis 64 Zeichen und ist unter Ihren Profilen eindeutig. Benennen Sie es nach der Arbeit, nicht nach dem Konto: Das Beispiel der Dokumentation heißt "Fundraising". Haken Sie dann die Verbindungen an, die die Aufgabe braucht; das Formular gruppiert sie nach Typ. Eine Verbindung, die Sie später widerrufen oder löschen, bleibt als removed aufgeführt, und das Profil meldet "A connection in this profile was removed." (Eine Verbindung in diesem Profil wurde entfernt.)

Schritt 4. Die Werkzeuge eingrenzen

Jeder Eintrag ist ein genauer Werkzeugname wie mail.reply oder eine Familie in der Form <family>.*, etwa carbon-forge.*. Eine leere Liste bedeutet "All tools these connections allow" (alle Werkzeuge, die diese Verbindungen erlauben). Das Beispielprofil der Dokumentation erlaubt:

"tools": ["carbon-forge.*", "mail.draft", "mail.reply", "mail.list", "mail.read"]

Das Formular markiert ein Werkzeug, das auf Ihre Freigabe wartet, mit "Needs your approval" (braucht Ihre Freigabe). Ein Profil grenzt nur ein: Ein Eintrag, den Ihr Tarif nicht erlaubt, wird abgelehnt mit "A profile can only narrow the tools your plan allows; <pattern> is not one of them." (Ein Profil kann die Werkzeuge Ihres Tarifs nur eingrenzen; <pattern> gehört nicht dazu.)

Schritt 5. Wissen, was das Profil nicht ändert

Ein Profil regelt die Werkzeuge der Familien seiner Verbindungen: mail.*, calendar.* und für alles andere die Familie des Anbieters, etwa github.*. Werkzeuge wie fs.*, cmd.run oder web.* regelt kein Profil; über sie entscheidet allein der Sicherheitskontext. Und ein erlaubtes Werkzeug trifft trotzdem auf das Freigabe-Gate. mail.send, mail.reply, mail.forward, mail.delete und mail.archive warten auf Ihre Antwort, was immer das Profil sagt. Ein Profil mit mail.reply und ohne mail.send lässt einen Lauf also in einem Thread antworten, wobei jede Antwort auf Sie wartet, und lehnt eine neue Nachricht sofort ab.

Schritt 6. Die Standardwerte ergänzen

Drei optionale Felder sparen Tipparbeit: ein Standard-repository, eine Ihrer Git-Repository-Bindungen; ein Standard-Workspace von Carbon Forge, genutzt "when a Carbon Forge call names none" (wenn ein Carbon-Forge-Aufruf keinen nennt); und instructions für Unterhaltungen mit diesem Profil, höchstens 4.000 Zeichen. Zaru erfährt den Namen des Profils, seinen Workspace und Ihre Anweisungen.

Schritt 7. Es in einer Unterhaltung wählen

Öffnen Sie das Unterhaltungsfeld über der Chat-Eingabe. Sein Abschnitt Context führt None, dann Profiles, dann Ihre Verbindungen nach Typ. Die Wahl eines Profils hebt gewählte Verbindungen auf, und die Zeile über der Eingabe lautet "Profile: <name>". Das Profil wird mit der Unterhaltung gespeichert, sodass spätere Runden und die Läufe, die sie starten, es nutzen. Ein Lauf trägt ein Profil oder gewählte Verbindungen, nie beides: "Choose one profile, or choose connections without a profile; not both." (Wählen Sie ein Profil oder Verbindungen ohne Profil, nicht beides.)

Schritt 8. Es für einen Zeitplan und einen API-Schlüssel nutzen

Das Zeitplan-Formular speichert ein Profil oder gewählte Verbindungen, nie beides, und Repository und Workspace eines Profils füllen das Formular. Unter Settings → API Keys wählt die Zeile jedes Schlüssels sein Profil, None zuerst. Ein Schlüssel ohne Profil erreicht keine Ihrer Verbindungen.

Schritt 9. Es in einem MCP-Client wählen

Ein Client sendet das Profil bei jeder Anfrage seiner Verbindung, in einem Header, der allein den reservierten Schlüssel @profile enthält:

x-zaru-contexts: {"@profile":"0000daeb-ae45-4d06-9712-9d498a653b24"}

Diese ID ist das Beispiel der Dokumentation; nehmen Sie die ID Ihres eigenen Profils. @profile neben einem anderen Schlüssel wird mit 400 beantwortet.

Schritt 10. Eine Ablehnung lesen

Jeder geregelte Aufruf wird gegen das Profil geprüft, so wie es in diesem Moment ist. Ein Werkzeug außerhalb davon wird mit TOOL_NOT_IN_PROFILE abgelehnt: "This tool is not in the profile chosen for this run." (Dieses Werkzeug ist nicht in dem Profil, das für diesen Lauf gewählt wurde.) Zaru Web zeigt eine Karte mit einem Link zum Profil, sodass Sie das Werkzeug hinzufügen oder weglassen können. Ein Lauf, den ein anderer Lauf gestartet hat, reicht nie über die Verbindungen hinaus, die jener Lauf gewählt hat. Eine Wahl "Always allow" (immer erlauben) in einem Lauf mit Profil gilt nur für dieses Profil, und das Löschen des Profils widerruft sie.

Was die Dokumentation nicht sagt

Wo man die ID eines Profils für den MCP-Header findet. Die REST-Antwort enthält sie; ob Zaru Web sie zeigt, sagt die Seite nicht.
Wie ein Profil in den Einstellungen eines MCP-Clients gewählt wird. Die Form des Headers ist angegeben, nicht die Konfiguration eines Clients.
Ob die Bearbeitung eines Profils einen laufenden Lauf ändert. Aufrufe werden "as it stands at that moment" (so, wie es in diesem Moment ist) geprüft, aber die Verbindungen werden beim Start zu denen des Laufs.
Diese Website erwähnt Profile nicht; die Dokumentation ist die einzige Quelle.