ZaruDa a cada ejecución de Zaru solo las conexiones que necesita
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 página Profiles de la documentación de Zaru, leída el 29 de octubre de 2026, y de los textos de este sitio, y la revisó la empresa; esta versión en español es una traducción de la guía original en inglés. Cada regla y mensaje citado abajo es de esa página, en inglés con la traducción al lado. Donde no dice cómo funciona algo, lo decimos en lugar de describirlo.
Cuando Zaru ya tiene tu buzón, tu calendario y un token de GitHub, la pregunta es a cuáles puede llegar una conversación, una ejecución o una tarea programada concreta. Un perfil lo responde con una sola elección: un conjunto con nombre de tus conexiones y las herramientas que pueden usar. Una ejecución sin perfil y sin conexiones elegidas no llega a ninguna. Esta guía crea un perfil, acota sus herramientas y lo usa en un chat, una tarea programada y un cliente MCP.
Qué es un perfil
La documentación: un perfil es "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." (tu propio conjunto con nombre de conexiones, como un buzón, una cuenta de calendario, un token de Carbon Forge, antes Nuclear Notes, o un token de GitHub, en cualquier número y de cualquier tipo, con una lista de las herramientas que pueden usar y valores por defecto opcionales). La regla que lo hace útil está impresa encima de la lista en la propia página Profiles: "A run, a schedule or an API key reaches only the connections a profile names. Without one it reaches none." (Una ejecución, una tarea programada o una clave de API solo llega a las conexiones que nombra un perfil. Sin perfil no llega a ninguna).
Paso 1. Crea una cuenta y conecta lo que usas
Pulsa Get Zaru free; para registrarte basta un nombre y un correo. Conecta tu correo y tu calendario desde el Vault, como describe el sitio. Un perfil solo puede incluir conexiones que ya tienes, así que conecta primero.
Paso 2. Abre Vault, Profiles
La lista está en /vault/profiles y muestra cada perfil con sus conexiones y su número de herramientas. Pulsa New profile. El mismo formulario edita un perfil más tarde.
Paso 3. Ponle el nombre de un trabajo y elige sus conexiones
Un nombre tiene de 1 a 64 caracteres y es único entre tus perfiles. Ponle el nombre del trabajo, no de la cuenta: el ejemplo de la propia documentación se llama "Fundraising". Luego marca las conexiones que el trabajo necesita; el formulario las agrupa por tipo. Una conexión que revoques o borres más tarde sigue en la lista como removed, y el perfil dice "A connection in this profile was removed." (Se eliminó una conexión de este perfil).
Paso 4. Acota las herramientas
Cada entrada es un nombre exacto de herramienta, como mail.reply, o una familia escrita <family>.*, como carbon-forge.*. Una lista vacía significa "All tools these connections allow" (todas las herramientas que permiten estas conexiones). El perfil de ejemplo de la documentación permite:
"tools": ["carbon-forge.*", "mail.draft", "mail.reply", "mail.list", "mail.read"]El formulario marca con "Needs your approval" (necesita tu aprobación) la herramienta que espera tu visto bueno. Un perfil solo acota: una entrada que tu plan no permite se rechaza con "A profile can only narrow the tools your plan allows; <pattern> is not one of them." (Un perfil solo puede acotar las herramientas que permite tu plan; <pattern> no es una de ellas).
Paso 5. Ten claro lo que el perfil no cambia
Un perfil gobierna las herramientas de las familias de sus conexiones: mail.*, calendar.* y la familia del proveedor para todo lo demás, como github.*. Herramientas como fs.*, cmd.run o web.* no dependen del perfil; las decide solo el contexto de seguridad. Y una herramienta permitida sigue pasando por la puerta de aprobación. mail.send, mail.reply, mail.forward, mail.delete y mail.archive esperan tu respuesta diga lo que diga el perfil. Así, un perfil con mail.reply y sin mail.send deja que una ejecución responda en un hilo, cada respuesta esperándote, y rechaza al instante un mensaje nuevo.
Paso 6. Añade los valores por defecto
Tres campos opcionales ahorran escritura: un repository por defecto, uno de tus enlaces a repositorios git; un workspace de Carbon Forge por defecto, que se usa "when a Carbon Forge call names none" (cuando una llamada a Carbon Forge no nombra ninguno); e instructions para las conversaciones con este perfil, de 4.000 caracteres como máximo. Zaru recibe el nombre del perfil, su workspace y tus instrucciones.
Paso 7. Elígelo en una conversación
Abre el panel de conversación encima del campo del chat. Su sección Context enumera None, luego Profiles y luego tus conexiones por tipo. Elegir un perfil borra las conexiones elegidas, y la línea encima del campo dice "Profile: <name>". El perfil se guarda con la conversación, así que los turnos siguientes y las ejecuciones que inicien lo usan. Una ejecución lleva un perfil o conexiones elegidas, nunca ambos: "Choose one profile, or choose connections without a profile; not both." (Elige un perfil, o elige conexiones sin perfil; no ambas cosas).
Paso 8. Úsalo en una tarea programada y en una clave de API
El formulario de tareas programadas guarda un perfil o conexiones elegidas, nunca ambos, y el repositorio y el workspace del perfil rellenan el formulario. En Settings → API Keys, la fila de cada clave elige su perfil, con None primero. Una clave sin perfil no llega a ninguna de tus conexiones.
Paso 9. Elígelo desde un cliente MCP
Un cliente envía el perfil en cada petición de su conexión, en una cabecera que lleva solo la clave reservada @profile:
x-zaru-contexts: {"@profile":"0000daeb-ae45-4d06-9712-9d498a653b24"}Ese id es el del ejemplo de la documentación; usa el id de tu propio perfil. @profile junto a cualquier otra clave recibe 400.
Paso 10. Lee un rechazo
Cada llamada gobernada se comprueba contra el perfil tal como está en ese momento. Una herramienta fuera de él se rechaza con TOOL_NOT_IN_PROFILE: "This tool is not in the profile chosen for this run." (Esta herramienta no está en el perfil elegido para esta ejecución). Zaru Web muestra una tarjeta que enlaza al perfil, para que añadas la herramienta o la dejes fuera. Una ejecución iniciada por otra nunca llega más allá de las conexiones que eligió esa otra. Una elección "Always allow" (permitir siempre) hecha en una ejecución con perfil vale solo para ese perfil, y borrar el perfil la revoca.
Lo que la documentación no dice
- Dónde encontrar el id de un perfil para la cabecera MCP. La respuesta REST lo incluye; la página no dice si Zaru Web lo muestra.
- Cómo se elige un perfil en los ajustes de un cliente MCP concreto. Se da la forma de la cabecera, no la configuración de un cliente.
- Si editar un perfil cambia una ejecución ya en marcha. Las llamadas se comprueban "as it stands at that moment" (tal como está en ese momento), pero las conexiones pasan a ser de la ejecución al empezar.
- Este sitio no menciona los perfiles; la documentación es la única fuente.
Guías relacionadas
- Configura un asistente Zaru que gestione tu correo y tu calendario con aprobaciones, que conecta el buzón y el calendario que luego acota un perfil.
- Preguntas frecuentes de Zaru
Crea un perfil por trabajo y empieza con las mínimas herramientas.