Un point de terminaison Zaru pour vos outils, profils et approbations

Aussi en: English, Español, Português, 日本語, Deutsch, 한국어, 简体中文, Italiano, हिन्दी · Tous les guides en français

Transparence : Zaru est développé par 100monkeys AI, Inc., lisez donc ce guide comme le récit de son fabricant. Il a été rédigé par l'un de nos agents d'IA à partir de la documentation de Zaru (en anglais), lue le 29 octobre 2026 (Connect Zaru to Any MCP Client, MCP Tools, Profiles, API Keys, The Vault, Calendar, Refusals and Errors), puis relu par l'entreprise ; cette version française est une traduction du guide original en anglais. Chaque commande, en-tête et message ci-dessous est copié de ces pages ; les citations restent en anglais, avec leur traduction à côté. Là où elles ne disent pas comment une chose fonctionne, nous le disons plutôt que de la décrire.

Votre boîte mail, votre agenda, un token GitHub et un token Carbon Forge peuvent se trouver dans Zaru, et Claude Code peut tous les atteindre par une seule adresse. Les tokens restent dans Zaru, un profil décide lesquels une clé peut toucher, et un appel qui enverrait ou modifierait quelque chose attend votre réponse dans Zaru Web. Ce guide va de zaru init jusqu'au premier appel en attente.

Étape 1. Connecter ce que vos outils utiliseront

Inscrivez-vous avec Get Zaru free ; seuls un nom et une adresse e-mail sont demandés. Dans le Vault, la page Connections connecte une boîte Google, Google Calendar, une boîte par IMAP et SMTP, ou un agenda par CalDAV. Un token GitHub ou un token MCP Carbon Forge s'enregistre avec New Credential. La documentation est nette sur la valeur : "No agent, operator, API key or other person is given the value." (Aucun agent, opérateur, clé d'API ni autre personne ne reçoit la valeur.)

Étape 2. Créer un profil

Une clé n'atteint rien tant que vous n'avez pas dit ce qu'elle peut atteindre. La page API Keys le dit au-dessus de sa liste : "A key reaches only the connections in the profile you choose for it; with no profile it reaches none." (Une clé n'atteint que les connexions du profil que vous choisissez pour elle ; sans profil, elle n'en atteint aucune.) Créez un profil avec les connexions et les outils que l'éditeur doit avoir ; Ne donner à chaque exécution Zaru que les connexions dont elle a besoin parcourt le formulaire.

Étape 3. Créer une clé d'API et choisir son profil

Ouvrez Settings → API Keys, cliquez sur New API Key, nommez-la, choisissez un préréglage de portée, choisissez le profil de la clé (None par défaut), choisissez une expiration et cliquez sur Create. "The key value is shown once." (La valeur de la clé n'est affichée qu'une fois.)

Étape 4. Ajouter le point de terminaison à Claude Code

Chaque client se connecte à une seule adresse, https://mcp.myzaru.com/mcp/v1, en StreamableHTTP, avec la clé comme token Bearer. Pour Claude Code, la documentation donne :

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

La même page donne la configuration pour Claude Desktop, Cursor, Windsurf, VS Code (GitHub Copilot) et Gemini CLI, et pour tout client qui parle StreamableHTTP.

Étape 5. Taper zaru init

Dans la session, dites à l'assistant :

zaru init

Il appelle l'outil zaru.init et adopte la persona de Zaru. zaru init agentic démarre dans un mode donné. C'est un outil du serveur MCP ; le zaru init du programme en ligne de commande, présenté dans le guide de la Zaru CLI, n'a aucun rapport et ne se connecte pas à Zaru Web.

Étape 6. Choisir un profil par connexion, si besoin

Le profil de la clé s'applique à chaque requête. Un client peut à la place envoyer l'en-tête x-zaru-contexts avec la seule clé réservée @profile :

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

Cet id est l'exemple de la documentation. Sur une clé, le @profile de la requête prend la place du profil propre de la clé pour cette requête, et les outils proposés deviennent ceux du profil. Toute autre forme reçoit 400.

La page Connect Zaru to Any MCP Client montre où va l'en-tête : "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." (Chaque client ci-dessus envoie un en-tête, Authorization, depuis sa configuration. Le même endroit accepte un second en-tête, x-zaru-contexts, qui choisit, pour chaque requête de cette connexion, lesquelles de vos connexions ses outils utilisent.) Dans Claude Code, un second --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>"}'

Un client configuré en JSON (Claude Desktop, Windsurf, VS Code) le prend comme seconde entrée sous headers. "The profile's id is the last part of the address of its page in Zaru Web, ask.myzaru.com/vault/profiles/<profile id>." (L'id du profil est la dernière partie de l'adresse de sa page dans Zaru Web.) Une chose reste ouverte dans la documentation : "Whether a given client sends a header it was configured with on every request is the client's behaviour, not documented here." (Savoir si un client donné envoie à chaque requête un en-tête qu'on lui a configuré relève du comportement du client, non documenté ici.)

Étape 7. Faire un appel qui utilise une connexion

Le client reçoit la liste des outils des familles de connexion du profil : les outils mail pour une boîte, les outils agenda pour un agenda, et les outils d'un serveur distant pour GitHub ou Carbon Forge. Un appel mail ou agenda qui ne nomme ni boîte ni compte utilise le seul existant, sinon le plus récent, et la réponse le nomme dans mailbox_name ou account_name. Des outils agenda, la documentation dit : "Your Google token or your password never reaches an agent or the model." (Votre token Google ou votre mot de passe n'atteint jamais un agent ni le modèle.)

La page MCP Tools les nomme : "The remote servers a person can connect today are GitHub and Carbon Forge (formerly Nuclear Notes)." (Les serveurs distants qu'une personne peut connecter aujourd'hui sont GitHub et Carbon Forge, anciennement Nuclear Notes.) Passerelles SEAL personnalisées : bientôt disponibles.

Étape 8. Lire un refus

Quand AEGIS by 100monkeys.ai, en bêta, refuse un appel, le client reçoit un résultat d'outil ordinaire avec isError: true contenant error.code, error.message et un request_id. Deux refus portent sur la portée :

CREDENTIAL_BINDING_REQUIRED, avant que quoi que ce soit ne s'exécute. Sur une clé sans 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." (Cette clé n'atteint aucune de vos connexions. Choisissez-lui un profil sur la page des clés d'API dans Zaru Web, ou nommez-en un dans la requête.) Pour une famille que vous n'avez jamais connectée, la réponse nomme la page Connections.
TOOL_NOT_IN_PROFILE : "This tool is not in the profile chosen for this conversation." (Cet outil n'est pas dans le profil choisi pour cette conversation.)

Chacun porte error.needs, la famille et la page de Zaru Web qui règle le problème. Pour une exécution, la carte de Zaru Web dit "This run has no profile that names your <family>." (Cette exécution n'a aucun profil qui nomme votre <family>.) avec Open Profiles. Un refus de politique est déterministe : changez l'appel plutôt que de le répéter.

Étape 9. Répondre dans Zaru Web à un appel en attente

"Every tool that asks for approval waits at the person's approval gate, as a call from the chat does." (Tout outil qui demande une approbation attend à la porte d'approbation de la personne, comme un appel venu du chat.) L'appel répond {"status": "approval_pending", "approval_id", "summary", "message"}, dont le message est "This waits for your answer in Zaru Web, under Approvals." (Ceci attend votre réponse dans Zaru Web, sous Approvals.) Répondez sur la page Approvals ; aegis.approval.status lit votre réponse depuis le client.

La page MCP Tools liste les appels qui attendent par défaut sur myzaru.com. Le catalogue d'outils marque mail.send, mail.reply, mail.forward, mail.delete et mail.archive, et les quatre écritures d'agenda, calendar.create, calendar.update, calendar.delete et calendar.respond. La configuration du déploiement marque quatre écritures GitHub, github.merge_pull_request, github.push_files, github.create_or_update_file et github.delete_file, ainsi que aegis.git.push et 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." (Aucun outil Carbon Forge n'attend : ni le catalogue ni la configuration n'en marque un, donc un appel Carbon Forge que le profil de la clé admet s'exécute aussitôt.) Le formulaire du profil marque chaque outil qui attend avec "Needs your approval" (Nécessite votre approbation). Un choix permanent "Always allow" (Toujours autoriser) répond à ses appels sans demander : l'attente est donc le comportement par défaut, pas une promesse.

Guides liés

Placez tous vos outils MCP derrière un seul point de terminaison. Nous enrichissons sans cesse la bibliothèque d'outils MCP : demandez de nouveaux outils en écrivant à [email protected].

Get Zaru free