Ein Zaru-Endpunkt für Ihre Werkzeuge, Profile und Freigaben

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 Zaru-Dokumentation (auf Englisch), gelesen am 29. Oktober 2026 (Connect Zaru to Any MCP Client, MCP Tools, Profiles, API Keys, The Vault, Calendar, Refusals and Errors), entworfen, und das Unternehmen hat sie geprüft; diese deutsche Fassung ist eine Übersetzung der englischen Originalanleitung. Jeder Befehl, jeder Header und jede Meldung unten ist von diesen Seiten kopiert; Zitate bleiben auf Englisch, mit der Übersetzung daneben. Wo sie nicht sagen, wie etwas funktioniert, sagen wir das, statt es zu beschreiben.

Ihr Postfach, Ihr Kalender, ein GitHub-Token und ein Carbon-Forge-Token können in Zaru liegen, und Claude Code erreicht sie alle über eine einzige Adresse. Die Tokens bleiben in Zaru, ein Profil entscheidet, welche davon ein Schlüssel berühren darf, und ein Aufruf, der etwas senden oder ändern würde, wartet in Zaru Web auf Ihre Antwort. Diese Anleitung geht den Weg von zaru init bis zum ersten angehaltenen Aufruf.

Schritt 1. Verbinden, was Ihre Werkzeuge nutzen

Registrieren Sie sich mit Get Zaru free; verlangt werden nur ein Name und eine E-Mail-Adresse. Im Vault verbindet die Seite Connections ein Google-Postfach, Google Calendar, ein Postfach über IMAP und SMTP oder einen Kalender über CalDAV. Ein GitHub-Token oder ein Carbon-Forge-MCP-Token wird mit New Credential gespeichert. Zum Wert ist die Dokumentation eindeutig: "No agent, operator, API key or other person is given the value." (Kein Agent, kein Operator, kein API-Schlüssel und keine andere Person erhält den Wert.)

Schritt 2. Ein Profil anlegen

Ein Schlüssel erreicht nichts, bis Sie sagen, was er erreichen darf. Die Seite API Keys sagt es über ihrer Liste: "A key reaches only the connections in the profile you choose for it; with no profile it reaches none." (Ein Schlüssel erreicht nur die Verbindungen des Profils, das Sie für ihn wählen; ohne Profil erreicht er keine.) Legen Sie ein Profil mit den Verbindungen und Werkzeugen an, die der Editor haben soll; Jedem Zaru-Lauf nur die Verbindungen geben, die er braucht geht das Formular durch.

Schritt 3. Einen API-Schlüssel erstellen und sein Profil wählen

Öffnen Sie Settings → API Keys, klicken Sie auf New API Key, geben Sie einen Namen ein, wählen Sie eine Scope-Vorgabe, wählen Sie das Profil des Schlüssels (None ist voreingestellt), wählen Sie ein Ablaufdatum und klicken Sie auf Create. "The key value is shown once." (Der Wert des Schlüssels wird einmal angezeigt.)

Schritt 4. Den Endpunkt in Claude Code eintragen

Jeder Client verbindet sich mit einer Adresse, https://mcp.myzaru.com/mcp/v1, über StreamableHTTP, mit dem Schlüssel als Bearer-Token. Für Claude Code gibt die Dokumentation an:

claude mcp add zaru \
  --transport http \
  https://mcp.myzaru.com/mcp/v1 \
  --header "Authorization: Bearer YOUR_API_KEY"

Dieselbe Seite gibt die Einrichtung für Claude Desktop, Cursor, Windsurf, VS Code (GitHub Copilot) und Gemini CLI an, und für jeden Client, der StreamableHTTP spricht.

Schritt 5. zaru init eingeben

Sagen Sie dem Assistenten in der Sitzung:

zaru init

Er ruft das Werkzeug zaru.init auf und übernimmt die Zaru-Persona. zaru init agentic startet in einem bestimmten Modus. Das ist ein Werkzeug des MCP-Servers; das zaru init des Kommandozeilenprogramms aus der Anleitung zur Zaru CLI hat damit nichts zu tun und verbindet sich nicht mit Zaru Web.

Schritt 6. Bei Bedarf ein Profil pro Verbindung wählen

Das Profil des Schlüssels gilt für jede Anfrage. Ein Client kann stattdessen den Header x-zaru-contexts senden, allein mit dem reservierten Schlüssel @profile:

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

Diese id ist das Beispiel der Dokumentation. Bei einem Schlüssel tritt das @profile der Anfrage für diese Anfrage an die Stelle des eigenen Profils des Schlüssels, und die angebotenen Werkzeuge werden die des Profils. Jede andere Form wird mit 400 beantwortet.

Die Seite Connect Zaru to Any MCP Client zeigt, wohin der Header gehört: "Every client above sends one header, Authorization, from its configuration. The same place takes a second header, x-zaru-contexts, which chooses for every request of that connection which of your connections its tools use." (Jeder der Clients oben sendet einen Header, Authorization, aus seiner Konfiguration. Dieselbe Stelle nimmt einen zweiten Header auf, x-zaru-contexts, der für jede Anfrage dieser Verbindung wählt, welche Ihrer Verbindungen ihre Werkzeuge nutzen.) In Claude Code ein zweites --header:

claude mcp add zaru \
  --transport http \
  https://mcp.myzaru.com/mcp/v1 \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header 'x-zaru-contexts: {"@profile":"<profile id>"}'

Ein per JSON konfigurierter Client (Claude Desktop, Windsurf, VS Code) nimmt ihn als zweiten Eintrag unter headers auf. "The profile's id is the last part of the address of its page in Zaru Web, ask.myzaru.com/vault/profiles/<profile id>." (Die id eines Profils ist der letzte Teil der Adresse seiner Seite in Zaru Web.) Eines lässt die Dokumentation offen: "Whether a given client sends a header it was configured with on every request is the client's behaviour, not documented here." (Ob ein bestimmter Client einen konfigurierten Header bei jeder Anfrage sendet, ist Verhalten des Clients und hier nicht dokumentiert.)

Schritt 7. Einen Aufruf machen, der eine Verbindung nutzt

Dem Client werden die Werkzeuge der Verbindungsfamilien des Profils angeboten: die Mail-Werkzeuge für ein Postfach, die Kalender-Werkzeuge für einen Kalender und die Werkzeuge eines entfernten Servers für GitHub oder Carbon Forge. Ein Mail- oder Kalenderaufruf, der kein Postfach und kein Konto nennt, nimmt das einzige, sonst das neueste, und die Antwort nennt es in mailbox_name oder account_name. Über die Kalender-Werkzeuge sagt die Dokumentation: "Your Google token or your password never reaches an agent or the model." (Ihr Google-Token oder Ihr Passwort erreicht nie einen Agenten oder das Modell.)

Die Seite MCP Tools nennt sie: "The remote servers a person can connect today are GitHub and Carbon Forge (formerly Nuclear Notes)." (Die entfernten Server, die man heute verbinden kann, sind GitHub und Carbon Forge, früher Nuclear Notes.) Eigene SEAL-Gateways: in Kürze.

Schritt 8. Eine Ablehnung lesen

Wenn AEGIS by 100monkeys.ai, in der Beta, einen Aufruf ablehnt, erhält der Client ein gewöhnliches Werkzeugergebnis mit isError: true, das error.code, error.message und eine request_id enthält. Zwei Ablehnungen betreffen die Reichweite:

CREDENTIAL_BINDING_REQUIRED, bevor irgendetwas läuft. Bei einem Schlüssel ohne Profil: "This key reaches none of your connections. Choose a profile for it on the API keys page in Zaru Web, or name one in the request." (Dieser Schlüssel erreicht keine Ihrer Verbindungen. Wählen Sie auf der Seite für API-Schlüssel in Zaru Web ein Profil für ihn, oder nennen Sie eines in der Anfrage.) Für eine Familie, die Sie nie verbunden haben, nennt die Antwort die Seite Connections.
TOOL_NOT_IN_PROFILE: "This tool is not in the profile chosen for this conversation." (Dieses Werkzeug ist nicht im Profil, das für diese Unterhaltung gewählt wurde.)

Jede trägt error.needs, die Familie und die Seite in Zaru Web, die das Problem löst. Bei einem Lauf sagt die Karte in Zaru Web "This run has no profile that names your <family>." (Dieser Lauf hat kein Profil, das Ihre <family> nennt.) mit Open Profiles. Eine Richtlinien-Ablehnung ist deterministisch, ändern Sie also den Aufruf, statt ihn zu wiederholen.

Schritt 9. Einen angehaltenen Aufruf in Zaru Web beantworten

"Every tool that asks for approval waits at the person's approval gate, as a call from the chat does." (Jedes Werkzeug, das um Freigabe bittet, wartet an der Freigabeschranke der Person, wie es ein Aufruf aus dem Chat tut.) Der Aufruf antwortet {"status": "approval_pending", "approval_id", "summary", "message"}, dessen Meldung lautet: "This waits for your answer in Zaru Web, under Approvals." (Dies wartet in Zaru Web unter Approvals auf Ihre Antwort.) Beantworten Sie ihn auf der Seite Approvals; aegis.approval.status liest Ihre Antwort aus dem Client.

Die Seite MCP Tools führt auf, welche Aufrufe auf myzaru.com standardmäßig warten. Der Werkzeugkatalog markiert mail.send, mail.reply, mail.forward, mail.delete und mail.archive, und die vier Kalender-Schreibvorgänge, calendar.create, calendar.update, calendar.delete und calendar.respond. Die Konfiguration der Bereitstellung markiert vier GitHub-Schreibvorgänge, github.merge_pull_request, github.push_files, github.create_or_update_file und github.delete_file, dazu aegis.git.push und aegis.system.info. "No Carbon Forge tool waits: neither the catalogue nor the configuration marks one, so a Carbon Forge call the key's profile admits runs at once." (Kein Carbon-Forge-Werkzeug wartet: weder der Katalog noch die Konfiguration markiert eines, also läuft ein Carbon-Forge-Aufruf, den das Profil des Schlüssels zulässt, sofort.) Das Profilformular markiert jedes wartende Werkzeug mit "Needs your approval" (Braucht Ihre Freigabe). Eine dauerhafte Wahl "Always allow" (Immer erlauben) beantwortet seine Aufrufe ohne Rückfrage, das Warten ist also die Voreinstellung, kein Versprechen.