Un endpoint de Zaru para tus herramientas, perfiles y aprobaciones

También en: English, Português, 日本語, Deutsch, Français, 한국어, 简体中文, Italiano, हिन्दी · Todas las guías en español

Aviso: Zaru lo construye 100monkeys AI, Inc., así que lee esta guía como el relato de quien lo fabrica. La redactó uno de nuestros agentes de IA a partir de la documentación de Zaru, leída el 29 de octubre de 2026 (Connect Zaru to Any MCP Client, MCP Tools, Profiles, API Keys, The Vault, Calendar, Refusals and Errors), y la revisó la empresa; esta versión en español es una traducción de la guía original en inglés. Cada comando, cabecera y mensaje de abajo está copiado de esas páginas; los mensajes y frases citados quedan en inglés, con la traducción al lado. Donde no dicen cómo funciona algo, lo decimos en lugar de describirlo.

Tu buzón, tu calendario, un token de GitHub y un token de Carbon Forge pueden estar en Zaru, y Claude Code puede llegar a todos ellos por una sola dirección. Los tokens se quedan en Zaru, un perfil decide cuáles puede tocar una clave, y una llamada que enviaría o cambiaría algo espera tu respuesta en Zaru Web. Esta guía recorre el camino desde zaru init hasta la primera llamada retenida.

Paso 1. Conecta lo que usarán tus herramientas

Regístrate con Get Zaru free; solo pide un nombre y un correo. En el Vault, la página Connections conecta un buzón de Google, Google Calendar, un buzón por IMAP y SMTP, o un calendario por CalDAV. Un token de GitHub o un token MCP de Carbon Forge se guarda con New Credential. La documentación es clara sobre el valor: "No agent, operator, API key or other person is given the value." (Ningún agente, operador, clave API ni otra persona recibe el valor.)

Paso 2. Crea un perfil

Una clave no alcanza nada hasta que dices a qué puede llegar. La página API Keys lo dice encima de su lista: "A key reaches only the connections in the profile you choose for it; with no profile it reaches none." (Una clave alcanza solo las conexiones del perfil que eliges para ella; sin perfil no alcanza ninguna.) Crea un perfil con las conexiones y herramientas que debe tener el editor; Da a cada ejecución de Zaru solo las conexiones que necesita recorre el formulario.

Paso 3. Crea una clave API y elige su perfil

Abre Settings → API Keys, pulsa New API Key, ponle nombre, elige un ajuste de alcance, elige el perfil de la clave (None es el valor por defecto), elige una caducidad y pulsa Create. "The key value is shown once." (El valor de la clave se muestra una sola vez.)

Paso 4. Añade el endpoint a Claude Code

Todos los clientes se conectan a una sola dirección, https://mcp.myzaru.com/mcp/v1, por StreamableHTTP, con la clave como token Bearer. Para Claude Code, la documentación da:

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

La misma página da la configuración para Claude Desktop, Cursor, Windsurf, VS Code (GitHub Copilot) y Gemini CLI, y para cualquier cliente que hable StreamableHTTP.

Paso 5. Escribe zaru init

En la sesión, dile al asistente:

zaru init

Llama a la herramienta zaru.init y adopta la persona de Zaru. zaru init agentic empieza en un modo concreto. Es una herramienta del servidor MCP; el zaru init del programa de línea de comandos, de la guía de la Zaru CLI, no tiene relación y no se conecta a Zaru Web.

Paso 6. Elige un perfil por conexión, si lo necesitas

El perfil de la clave se aplica a cada petición. Un cliente puede, en su lugar, enviar la cabecera x-zaru-contexts solo con la clave reservada @profile:

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

Ese id es el ejemplo de la documentación. En una clave, el @profile de la petición ocupa el lugar del perfil propio de la clave para esa petición, y las herramientas ofrecidas pasan a ser las del perfil. Cualquier otra forma recibe un 400.

La página Connect Zaru to Any MCP Client muestra dónde va la cabecera: "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." (Cada cliente de arriba envía una cabecera, Authorization, desde su configuración. El mismo lugar admite una segunda cabecera, x-zaru-contexts, que elige para cada petición de esa conexión cuáles de tus conexiones usan sus herramientas.) En Claude Code, un segundo --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 cliente configurado por JSON (Claude Desktop, Windsurf, VS Code) la lleva como segunda entrada bajo 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>." (El id del perfil es la última parte de la dirección de su página en Zaru Web.) Una cosa queda abierta en la documentación: "Whether a given client sends a header it was configured with on every request is the client's behaviour, not documented here." (Si un cliente concreto envía en cada petición una cabecera que se le configuró es comportamiento del cliente, no documentado aquí.)

Paso 7. Haz una llamada que use una conexión

Al cliente se le listan las herramientas de las familias de conexión del perfil: las de correo para un buzón, las de calendario para un calendario, y las de un servidor remoto para GitHub o Carbon Forge. Una llamada de correo o calendario que no nombra buzón ni cuenta usa el único que hay, si no el más reciente, y la respuesta lo nombra en mailbox_name o account_name. De las herramientas de calendario, la documentación dice: "Your Google token or your password never reaches an agent or the model." (Tu token de Google o tu contraseña nunca llegan a un agente ni al modelo.)

La página MCP Tools los nombra: "The remote servers a person can connect today are GitHub and Carbon Forge (formerly Nuclear Notes)." (Los servidores remotos que una persona puede conectar hoy son GitHub y Carbon Forge, antes Nuclear Notes.) Gateways SEAL personalizados: próximamente.

Paso 8. Lee un rechazo

Cuando AEGIS by 100monkeys.ai, en beta, rechaza una llamada, el cliente recibe un resultado de herramienta normal con isError: true que contiene error.code, error.message y un request_id. Dos rechazos tratan del alcance:

CREDENTIAL_BINDING_REQUIRED, antes de que se ejecute nada. En una clave sin perfil: "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." (Esta clave no alcanza ninguna de tus conexiones. Elige un perfil para ella en la página de claves API de Zaru Web, o nombra uno en la petición.) Para una familia que nunca conectaste, la respuesta nombra la página Connections.
TOOL_NOT_IN_PROFILE: "This tool is not in the profile chosen for this conversation." (Esta herramienta no está en el perfil elegido para esta conversación.)

Cada uno lleva error.needs, la familia y la página de Zaru Web que lo resuelve. Para una ejecución, la tarjeta de Zaru Web dice "This run has no profile that names your <family>." (Esta ejecución no tiene un perfil que nombre tu <family>.) con Open Profiles. Un rechazo de política es determinista, así que cambia la llamada en lugar de repetirla.

Paso 9. Responde en Zaru Web a una llamada retenida

"Every tool that asks for approval waits at the person's approval gate, as a call from the chat does." (Toda herramienta que pide aprobación espera en la puerta de aprobación de la persona, como lo hace una llamada desde el chat.) La llamada responde {"status": "approval_pending", "approval_id", "summary", "message"}, cuyo mensaje es "This waits for your answer in Zaru Web, under Approvals." (Esto espera tu respuesta en Zaru Web, en Approvals.) Respóndela en la página Approvals; aegis.approval.status lee tu respuesta desde el cliente.

La página MCP Tools lista qué llamadas esperan por defecto en myzaru.com. El catálogo de herramientas marca mail.send, mail.reply, mail.forward, mail.delete y mail.archive, y las cuatro escrituras de calendario, calendar.create, calendar.update, calendar.delete y calendar.respond. La configuración del despliegue marca cuatro escrituras de GitHub, github.merge_pull_request, github.push_files, github.create_or_update_file y github.delete_file, además de aegis.git.push y 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." (Ninguna herramienta de Carbon Forge espera: ni el catálogo ni la configuración marca ninguna, así que una llamada de Carbon Forge que el perfil de la clave admite se ejecuta enseguida.) El formulario del perfil marca cada herramienta que espera con "Needs your approval" (Necesita tu aprobación). Una elección permanente "Always allow" (Permitir siempre) responde sus llamadas sin preguntar, así que la espera es lo predeterminado, no una promesa.

Guías relacionadas

Pon todas tus herramientas MCP detrás de un solo endpoint. Ampliamos constantemente la biblioteca de herramientas MCP: pide nuevas herramientas escribiendo a [email protected].

Get Zaru free