# SweetHive — Cómo funciona SweetHive — y cómo sacarle el máximo partido. Un único archivo markdown con toda la guía — dáselo a ChatGPT, Claude o a cualquier asistente y pregúntale cómo usar SweetHive e impulsar tu actividad. Source: https://docs.sweethive.com/es/ (generated from the official SweetHive documentation). --- # Qué es SweetHive SweetHive es un espacio de trabajo donde cada lugar de trabajo tiene su propio contexto y su propio alcance. En lugar de un único chat gigante, la información se organiza en un **árbol de contextos**, y quién ve qué lo deciden los **grupos** — no largas listas de destinatarios. ## Los tres bloques fundamentales - **Hive** — un espacio de trabajo (una empresa, un proyecto, una escuela, un museo, una familia). Todo vive dentro de un hive. - **Contexto** — un nodo dentro de un hive. Los contextos forman un árbol: un contexto puede contener subcontextos, con toda la profundidad que necesites (p. ej. *WEREA SRL → Administración → Personas → Nóminas*). - **Grupo** — un conjunto de personas. Los grupos se asocian a los contextos y controlan la visibilidad: solo ves un contexto si uno de tus grupos está **activo** en él. ## Cómo fluye la visibilidad La visibilidad fluye **hacia abajo** en el árbol: el acceso a un contexto también cubre los contextos que contiene. Un mensaje que escribes en un contexto, dirigido a un grupo, es visible para ese grupo en ese contexto y en todo lo que hay debajo — nunca más allá. > **La regla de oro:** nada es visible para alguien a menos que un grupo al que pertenece > esté activo en ese contexto. Esto es lo que mantiene separadas con seguridad, en un > mismo hive, a audiencias con distintos niveles de confianza (personal, socios, clientes). ## Qué vive en un contexto Más allá de los mensajes, cada contexto agrega su contenido en apps integradas — **Galería** (imágenes y vídeo), **Notas**, **Tareas**, **Agenda** (eventos), **AnyDocs** (archivos y enlaces) — y puede alojar apps personalizadas instaladas por un administrador. Todo obedece la misma ley de visibilidad. ## Dónde encaja la IA SweetHive está construido para trabajar con asistentes de IA: puedes conectar tu propio agente (Claude, un agente de tipo OpenClaw o cualquier asistente compatible con MCP) con un token acotado que nunca supera tu propia visibilidad, chatear con él desde dentro de SweetHive y descargar toda esta guía como un único archivo markdown para enseñarle a cualquier IA cómo funciona SweetHive — consulta [Usar SweetHive con IA](/es/use-sweethive-with-ai/). --- # Inicio rápido ## Iniciar sesión Ve a [sweethive.com](https://sweethive.com) e inicia sesión con tu correo electrónico (o teléfono) y contraseña. SweetHive usa un inicio de sesión único en toda la familia de productos, así que la misma cuenta funciona en la app web, las apps móviles y los productos satélite. En **iOS y Android** la app de SweetHive te conecta con las mismas credenciales — consulta [Apps móviles](/es/mobile/). ## La página de inicio: Mi SweetHive Tras iniciar sesión llegas a **Mi SweetHive**, tu panel personal: - **Invitaciones** — hives a los que te han invitado; acepta para unirte. - **Hives** — todos los hives a los que perteneces, con **Crear nuevo** para empezar el tuyo. - **Contextos** — acceso rápido a los contextos que usas. - **Conectores** — los servicios externos (Gmail, Google Calendar, Google Drive, …) que has conectado; consulta [Conectores](/es/connectors/). - El **feed de actividad** — los mensajes compartidos con tus grupos en todos tus hives. ## Cómo orientarte - La **barra superior** muestra dónde estás (ruta hive → contexto) y aloja **Escribir un mensaje** y la **búsqueda**. - La **barra de iconos** de la izquierda cambia entre las áreas del hive actual: Contextos, Grupos, Personas, Apps, Agentes, Conectores, Notificaciones. - El **panel de mensajes** está acoplado junto al contenido y siempre sigue el contexto en el que estás: muestra el feed del subárbol del contexto actual. ## Tus primeros pasos 1. **Únete a un hive o crea uno** — acepta una invitación o [crea un hive](/es/create-a-hive/) con el asistente guiado. 2. **Abre un contexto** y lee su panel: descripción, subcontextos, grupos activos, apps, personas. 3. **Escribe un mensaje** — elige el contexto y los grupos de destino, adjunta lo que necesites y envía. Consulta [Mensajes](/es/messages/). 4. **Instala la app móvil** — SweetHive está en el App Store y Google Play; consulta [Apps móviles](/es/mobile/). ## Idiomas SweetHive habla **English, Italiano, Français, Deutsch y Español**. Configura tu idioma en *Ajustes → Perfil → Preferencias* — la app (y los enlaces a esta documentación) lo seguirán. --- # Crear un hive Cualquiera puede crear un hive. La persona que lo crea se convierte en su primer administrador, con un **grupo Admin** creado automáticamente. La creación es un **asistente guiado** que te ayuda a diseñar un entorno completo — contextos y grupos — antes de que se cree nada. Empieza desde **Mi SweetHive → Hives → Crear nuevo**. ## Paso 1 — Crear Elige qué quieres construir: **Empresa**, **Equipo**, **Escuela** o **Proyecto** en SweetHive — o un **Museo** (AerariumChain) / **Academia** (WiredExperience) en las plataformas satélite. Tu elección ajusta el resto del asistente. ## Paso 2 — Plan Elige quién es el propietario del hive: - **Personal** — el hive vive en tu cuenta personal y en su plan (gratuito). - **Organización** — el hive pertenece a una de tus organizaciones y funciona con el plan de la organización. Consulta [Ajustes](/es/settings/) para crear organizaciones y gestionar planes. ## Paso 3 — Plantilla Elige una estructura inicial del catálogo de plantillas de tu clúster, o empieza **En blanco**. Tu propósito del paso 1 preselecciona una plantilla adecuada cuando la hay. Una plantilla describe un entorno listo para usar: el árbol de contextos, los grupos y qué grupos están activos en cada lugar. ## Paso 4 — Entorno Este es el corazón del asistente: un **editor de árbol** completo donde das forma al entorno antes de que exista. Puedes: - **añadir, renombrar y eliminar contextos**, anidados con toda la profundidad que necesites; - **añadir, renombrar y eliminar grupos**; - **activar o desactivar qué grupos están activos en cada contexto** — decidiendo, nodo a nodo, quién verá qué. Tómate tu tiempo aquí: un árbol bien diseñado significa que la visibilidad se cuidará sola más adelante. ## Paso 5 — Detalles Ponle nombre al hive, añade una descripción opcional e importa una **imagen de portada** — arrastra para reposicionar, haz zoom con el control deslizante; SweetHive la redimensiona por ti. Si el entorno que has construido merece reutilizarse, marca **«guardar este entorno como plantilla reutilizable»** y se incorporará a tu catálogo de plantillas para la próxima vez. **Crear** aplica todo el árbol editado en una única operación atómica — los contextos, los grupos y las activaciones cobran vida a la vez, y aterrizas en el nuevo hive como su administrador. > **Consejo:** diseña los grupos en torno a *audiencias* (Personal, Proveedores, > Clientes, Dirección), no en torno a organigramas. Dirigirás mensajes a audiencias > todos los días. --- # Contextos Los contextos organizan un hive en un árbol. Cada contexto tiene su propio panel, su propio feed, sus propias apps — y su propia audiencia, decidida por los grupos activos en él. ## Crear un contexto Solo un administrador del hive puede crear contextos — el botón **Crear nuevo** aparece en el panel del contexto cuando tienes derechos de administrador allí. 1. Abre el contexto dentro del cual quieres crear (o la raíz del hive). 2. En la tarjeta **Contextos internos**, elige **Crear nuevo**. 3. Opcionalmente importa y recorta una imagen de portada. 4. Ponle nombre, añade una descripción y luego **Crear**. El nuevo contexto se abre automáticamente. Un contexto nuevo hereda el grupo **Admin** del hive, así que los administradores pueden gestionarlo de inmediato. Activa grupos de miembros para abrirlo a más personas. ## El panel del contexto Al abrir un contexto se muestra: - **Descripción y portada** — para qué sirve este lugar. - **Contextos internos** — los subcontextos que puedes ver. - **Grupos activos** — quién puede ver este contexto. Los administradores activan y desactivan grupos aquí; consulta [Grupos](/es/groups/). - **Apps** — las apps integradas más las apps personalizadas instaladas aquí; consulta [Apps integradas](/es/built-in-apps/). - **Personas** — quién está efectivamente en este contexto, a través de sus grupos activos. El **panel de mensajes** acoplado junto al panel muestra el feed de este contexto *y de todo lo que hay debajo* — los mensajes publicados más abajo en el árbol también afloran aquí, y puedes filtrarlos (consulta [Mensajes](/es/messages/)). ## Moverse por el árbol La **ruta de navegación** de la barra superior muestra el camino desde la raíz del hive hasta donde estás; **Subir** asciende un nivel. El elemento **Contextos** de la barra de iconos lista el subárbol del contexto actual. > **Consejo de diseño:** un contexto es un *lugar*, no una etiqueta de tema. Si un > conjunto de información tiene su propia audiencia o su propio ciclo de vida — un > proyecto, un departamento, un cliente — merece su propio contexto. --- # Grupos Un grupo es un conjunto de personas con nombre (p. ej. *Admin*, *Fundadores*, *DevGroup*, *Proveedores*). Los grupos pertenecen a un hive y se asocian a los contextos para conceder visibilidad. Son lo único que decide quién ve qué. ## Crear un grupo 1. En un hive, abre **Grupos** desde la barra de iconos. 2. Elige **Crear** y dale al grupo un nombre y una descripción. 3. Añade personas al grupo. ## Editar quién está en un grupo Desde la página **Grupos**, abre un grupo y elige **Editar usuarios** — un editor de dos columnas muestra quién está *dentro* del grupo y quién más está en el hive. Mueve personas dentro y fuera y **Guardar**; su visibilidad en todos los contextos donde el grupo está activo se actualiza de inmediato. También puedes trabajar desde el lado de la persona: en la página **Personas**, usa **⋮ → Cambiar grupos** de una persona para ajustar todas sus pertenencias de una vez. ## Activar un grupo en un contexto Un contexto muestra sus **Grupos activos** en el panel. Activar un grupo en un contexto es lo que hace que ese contexto (y todo lo que hay debajo) sea visible para los miembros del grupo. Desactiva un grupo para retirar ese acceso al instante. > Como la visibilidad fluye hacia abajo, activa un grupo **tan arriba en el árbol como > deba llegar el acceso — y no más arriba.** ## Patrones habituales - **Grupo Admin** — creado automáticamente con el hive; activo allí donde los administradores necesitan gestionar. - **Un grupo por audiencia** — Personal, Clientes, Proveedores, Dirección. Los mensajes se dirigen entonces a cada audiencia con un solo chip. - **Círculos de proyecto** — un grupo por equipo de proyecto, activo solo en el contexto del proyecto; el resto del hive permanece invisible para ellos. - **Acceso temporal** — activa un grupo mientras dure una colaboración y luego desactívalo. No hace falta limpiar permisos individuales. --- # Personas e invitaciones Abre **Personas** desde la barra de iconos para ver quién está en el hive. Desde aquí invitas a personas nuevas y gestionas a las que ya están dentro. ## Invitar a alguien 1. Elige **Invitar personas** y envía una invitación por correo electrónico. 2. La persona invitada la ve en **Mi SweetHive → Invitaciones** y acepta para unirse. 3. Una vez dentro, añádela a los [grupos](/es/groups/) adecuados — hasta entonces solo verá lo que permita la pertenencia predeterminada. ## Gestionar a una persona - **⋮ → Cambiar grupos** — ajusta exactamente lo que puede ver, en todos los grupos desde un único diálogo. - **Quitar del hive** — revoca todo su acceso de una vez. ## Qué ve un miembro nuevo Nada, hasta que un grupo al que pertenece esté activo en un contexto. Esto es así por diseño: puedes invitar con seguridad a un cliente o a un colaborador externo al hive, y solo verá los contextos que abras a su grupo. > **Consejo:** primero invita, luego coloca. Es normal que un miembro nuevo vea un hive > casi vacío hasta que lo hayas añadido a sus grupos. --- # Mensajes Los mensajes se escriben siempre **en un contexto** y se dirigen **a uno o más grupos** — así es como SweetHive mantiene el alcance bajo control. El mensaje (y cualquier adjunto) es visible para esos grupos en ese contexto y por debajo, nunca más allá. ## Escribir y compartir 1. Abre el contexto en el que quieres publicar. 2. Elige **Escribir un mensaje** (barra superior) o **Escribir** en el panel del contexto. 3. Confirma el contexto y elige los grupos de destino mostrados como chips. 4. Escribe tu mensaje. Añade imágenes, archivos, un enlace, una tarea, un evento o una nota desde el selector de adjuntos. 5. **Enviar.** Los destinatarios lo ven en su flujo de actividad; tú puedes ver quién lo ha visto. **Responde** para mantener un hilo unido. Un mensaje solo puede ser visto por personas que compartan uno de sus grupos — no hay forma de filtrarlo más allá. ## Contenido y adjuntos - Las **imágenes y los vídeos** también aparecen en la app **Galería** del contexto. - Los **archivos y enlaces** aparecen en **AnyDocs**. Haz clic en cualquier contenido para abrirlo a pantalla completa, con el mensaje original al lado. - Las **notas** son documentos que puedes editar; aparecen en la app **Notas**. - Las **tareas** y los **eventos** llegan a **Tareas** y **Agenda**. - El contenido de tus [conectores](/es/connectors/) — un mensaje de Gmail, un evento de calendario, un archivo de Drive — puede compartirse en un contexto como una tarjeta enriquecida. ## Buscar y filtrar el feed El panel de mensajes sigue el contexto en el que estás y muestra el feed de todo su subárbol. Para encontrar cosas: - **Buscar mensajes** desde la barra superior busca en el texto del feed. - Los **filtros** acotan el feed por: - **rango de fechas** — desde/hasta; - **autor** — solo mensajes de las personas seleccionadas; - **tipo de contenido** — mensajes con imágenes, archivos, enlaces, tareas, eventos o notas; - **subcontextos** — incluir todo el subárbol o solo el contexto actual. Los filtros se combinan, y el filtro activo siempre es visible encima del feed — límpialo con un clic. ## Notificaciones Los mensajes nuevos para tus grupos generan notificaciones dentro de la app (la página **Notificaciones** las recoge todas) y **notificaciones push** en las apps móviles. Tocar una notificación push abre el mensaje exacto en su contexto. --- # Apps en un contexto Cada contexto agrega su contenido en **apps integradas**, y un administrador del hive puede instalar **apps personalizadas** encima. Las apps ven los datos a través de la misma ley de alcance que todo lo demás: solo lo que puede ver la persona que las usa, nunca más allá. ## Las apps integradas | App | Qué recopila | |---|---| | **Galería** | todas las imágenes y vídeos publicados en el subárbol del contexto | | **Notas** | documentos editables creados desde el redactor | | **Tareas** | tareas adjuntas a mensajes, con su estado | | **Agenda** | eventos adjuntos a mensajes, en un calendario | | **AnyDocs** | todos los archivos y enlaces, en un único lugar con búsqueda | Ábrelas desde la tarjeta **Apps** del panel del contexto. El contenido se abre a pantalla completa con el mensaje original al lado, para que nada pierda su contexto. ## Instalar una app personalizada (administradores) 1. Abre el contexto y busca la tarjeta **Apps** en el panel. 2. Elige **Añadir app** (visible para los administradores). 3. Elige una app del catálogo y pulsa **Añadir**. Aparece en *Apps instaladas*. 4. Ábrela desde la tarjeta Apps — las apps **embebidas** se muestran en el propio lugar; las apps **externas** se abren en una ventana nueva (o en el navegador integrado en móvil). Elimina una app en cualquier momento desde su menú — su acceso se detiene de inmediato. ## Familias de apps profesionales SweetHive también aloja familias de apps de producción usadas por miles de organizaciones — por ejemplo, los registros documentales y de formación de **Safety-BI** (**DocBI**, **Document BI**, **Records**, **DBI Global**), usados para certificados por empleado, gestión documental por contexto y expedientes de empleados. Si tu organización las usa, aparecen en la tarjeta Apps del contexto como cualquier otra app. ¿Quieres construir tu propia app? Consulta la [guía para desarrolladores](/es/build-an-app/). --- # Conectores Los **conectores** traen tus servicios externos a SweetHive para que su contenido pueda compartirse en los contextos con la misma visibilidad basada en grupos que todo lo demás. Abre el hub desde **Mi SweetHive → Conectores** o desde el elemento **Conectores** de la barra de iconos. ## Disponibles hoy - **Gmail** — explora tu bandeja de entrada (solo lectura) y comparte un correo en un contexto como una tarjeta enriquecida. - **Google Calendar** — explora tus próximos eventos (solo lectura) y comparte un evento en un contexto. - **Google Drive** — explora tus archivos (solo lectura) y comparte una tarjeta de archivo en un contexto. Drive comparte la misma conexión de Google que Gmail y Calendar. Más conectores — Outlook, Dropbox, OneDrive, Slack, Telegram, Trello, Asana, Jira, GitHub — están en la hoja de ruta y aparecen en el hub como **próximamente**. ## Conectar Google 1. Abre **Conectores → Gmail** (o Google Drive). 2. Elige **Conectar** — se abre una ventana de consentimiento de Google; aprueba los permisos de solo lectura. 3. Tus correos / eventos / archivos aparecen en la página del conector, en solo lectura. **Privacidad por diseño:** - El acceso es de **solo lectura** — SweetHive nunca envía correos, crea eventos ni modifica archivos en tu nombre. - Tus tokens de Google se almacenan **solo en el servidor** y nunca llegan al navegador. - Desconecta en cualquier momento desde la página del conector; el acceso se detiene de inmediato. - Si se añade una nueva capacidad al conector de Google (como ocurrió con Drive), simplemente se te pedirá reconectar una vez para conceder el permiso de lectura adicional. ## Compartir en un contexto Cada correo, evento o archivo de un conector tiene una acción **Compartir**: 1. Elige **Compartir** en el elemento. 2. Selecciona el **hive → contexto → grupos** en el diálogo de compartir. 3. Envía — el elemento aterriza en el feed del contexto como una tarjeta enriquecida (asunto/remitente para el correo, título/hora para los eventos, nombre/tipo para los archivos), visible solo para los grupos a los que lo dirigiste. Este es el puente entre tus herramientas personales y los contextos de tu equipo: en lugar de reenviar un correo, lo *colocas* donde corresponde. --- # Ajustes Abre **Ajustes** desde tu avatar en la barra superior. Ajustes tiene hoy tres secciones principales — Perfil, Plan y facturación, y Organizaciones — con más (pedidos, proveedores) en camino. ## Perfil Todo sobre ti: - **Identidad** — nombre, avatar (sube y recorta), datos de contacto, dirección, enlaces sociales. - **Preferencias** — incluido tu **idioma** (English, Italiano, Français, Deutsch, Español); toda la app lo sigue al instante. - **Contraseña** — cámbiala con tu contraseña actual. - **Visibilidad** — cada campo del perfil lleva su propio ajuste de visibilidad, así que tú decides qué pueden ver los demás miembros. Cada tarjeta se guarda de forma independiente — edita y luego **Guardar** en esa tarjeta. ## Plan y facturación Tu cuenta personal lleva su propio plan (gratuito por defecto); cada **organización** lleva el suyo — normalmente de pago. Los hives y los recursos se asignan a ti *o* a una organización. - **Plan actual** — con medidores en vivo de miembros y almacenamiento. - **Planes disponibles** — mejora mediante el pago seguro de Stripe; la facturación también puede hacerse por transferencia bancaria donde esté habilitada. - **Métodos de pago** — tarjetas guardadas, tarjeta predeterminada, eliminar. - **Datos de facturación** — datos de factura (razón social, NIF/IVA, dirección) usados en los recibos. - **Historial de pagos** — cada pago con recibos y facturas descargables. ## Organizaciones Una organización es una entidad legal/de facturación que puede ser propietaria de hives y recursos. - **Crear** una organización (elige un nombre de usuario único; obtiene su propio clúster de negocio). - **Perfil y facturación** — la identidad y los datos de facturación de la organización. - **Administradores** — dos roles de administrador: los administradores *globales* lo gestionan todo, los administradores *financieros* gestionan la facturación. Añade o quita a cualquiera de los dos. - **Plan y cuota** — el plan de la organización, el uso de miembros/almacenamiento, sus propias tarjetas y su historial de pagos. Cuando [creas un hive](/es/create-a-hive/) con un plan de **Organización**, es la organización la propietaria — y son su plan, sus miembros y su almacenamiento los que cuentan. --- # Apps móviles SweetHive está disponible como app nativa para **iOS** y **Android**, con la misma cuenta y los mismos datos que la app web. ## Descargar - **iPhone / iPad** — busca **SweetHive** en el **App Store**. - **Android** — busca **SweetHive** en **Google Play**. Inicia sesión con el mismo correo electrónico (o teléfono) y contraseña que usas en [sweethive.com](https://sweethive.com). Todo funciona igual que en la web: los contextos, los grupos, los mensajes, las apps y los conectores siguen las mismas reglas de visibilidad en todas partes. --- # Usar SweetHive con IA SweetHive está diseñado para trabajar *con* tu asistente de IA, sea cual sea el que uses. Hay dos niveles: enseñarle a una IA **sobre** SweetHive y conectar una IA **a** tu SweetHive. ## 1. Enséñale a tu IA sobre SweetHive (la guía .md) Toda esta documentación está disponible como **un archivo markdown por idioma**: **[Descargar la guía de SweetHive (.md)](/downloads/sweethive-guide.es.md)** Dale ese archivo a ChatGPT, Claude, Copilot o cualquier asistente — adjúntalo a un chat, a un proyecto o al conocimiento de un asistente personalizado — y sabrá al instante cómo funciona SweetHive: hives, contextos, grupos, visibilidad, mensajes, conectores, ajustes, apps. Luego pregúntale cosas como: - *«Basándote en esta guía, diseña una estructura de hive para mi estudio de arquitectura con personal, consultores externos y clientes.»* - *«¿Qué grupos debería crear para que los proveedores vean la logística pero nunca los precios?»* - *«Redacta el mensaje de actualización semanal para mi DevGroup y dime en qué contexto publicarlo.»* - *«¿Cómo puede mi equipo usar los conectores para dejar de reenviar correos de un lado a otro?»* - *«Audita este plan: ¿quién vería qué si activo “Clientes” en la raíz del proyecto?»* Cada página de este sitio también está disponible como markdown en bruto — añade `.md` a la URL de cualquier artículo (p. ej. `/es/messages.md`) — y los rastreadores de IA pueden descubrirlo todo a través de [`/llms.txt`](/llms.txt). ## 2. Conecta una IA a tu SweetHive Más allá de saber *sobre* SweetHive, tu asistente puede leer de forma segura (y, si se lo permites, publicar en) tus hives reales: - [Conectar un agente](/es/connect-an-agent/) — emite un token de acceso acotado desde SweetHive; funciona con Claude Desktop, Claude Code, agentes de tipo OpenClaw y cualquier asistente compatible con MCP. - [Chatear con tu agente](/es/chat-with-your-agent/) — habla con tu agente conectado desde dentro de SweetHive. Entonces tus preguntas dejan de ser hipotéticas: - *«¿Qué ha cambiado en el Proyecto A esta semana?»* - *«Resume las tareas abiertas en Administración → Personas.»* - *«Redacta una actualización de estado para el DevGroup en Gigapixel.»* ## Potencia tu actividad — una receta 1. **Descarga la guía** de arriba y dásela a tu asistente una sola vez. 2. **Diseña con ella** — deja que proponga tu árbol de contextos y tus grupos; construye el resultado con el [asistente de creación de hives](/es/create-a-hive/). 3. **Conéctalo** con un token de solo lectura a tus contextos de trabajo. 4. **Conviértelo en un hábito** — puesta al día matutina («¿qué hay de nuevo para mí?»), resúmenes semanales, actualizaciones redactadas que apruebas antes de publicar. Tu IA conoce el método; tu SweetHive guarda los hechos — acotados, seguros y siempre bajo tu control. --- # SweetHive Agents Node El **SweetHive Agents Node** es una app de escritorio para macOS y Windows que ejecuta tus agentes de SweetHive **en tu propio ordenador**. Tus agentes responden con modelos de IA ejecutados en local — los prompts y el contenido nunca salen de tu máquina durante la inferencia — y la app también puede conectar asistentes como **Claude** o **ChatGPT** a tu contenido de SweetHive mediante MCP. > ¿Usas OpenClaw? Sigue funcionando como runtime alternativo: lee los mismos > bundles de configuración. El Agents Node simplemente lo convierte todo en una > instalación guiada. ## Instalación 1. Descarga la app: - [macOS (Apple Silicon)](https://downloads.sweethive.com/agents-node/mac/SweetHive-Agents-Node-arm64.dmg) - [macOS (Intel)](https://downloads.sweethive.com/agents-node/mac/SweetHive-Agents-Node-x64.dmg) - [Windows](https://downloads.sweethive.com/agents-node/win/SweetHive-Agents-Node-Setup.exe) 2. Ábrela, lee y **acepta los términos**. 3. **Inicia sesión con tu cuenta de SweetHive** (mismo correo y contraseña que en la app web). La app se actualiza sola automáticamente. Las builds de macOS están firmadas y notarizadas por Apple, así que se abren sin avisos. ## Añadir agentes de contexto Un *agente de contexto* es una conexión limitada a las colmenas y contextos que elijas — nunca ve más de lo que ves tú. Puedes crearlo desde cualquiera de los dos lados, y ambos quedan sincronizados: - **Desde la app** — *Context agents → New context agent*: ponle nombre, elige las colmenas, la capacidad y la caducidad. Aparece al instante en SweetHive → **Mis agentes**. - **Desde SweetHive web** — *Mis agentes → Conectar un agente*: crea el token, descarga el bundle de configuración e impórtalo en la app (*Context agents → Import config bundle*). Chatea con tus agentes desde **Mis agentes** en SweetHive — las respuestas se generan en tu ordenador. Consulta [Chatea con tu agente](/es/chat-with-your-agent/). ## Modelos locales El runtime de IA viene **integrado en la app** — no hay nada más que instalar. La pestaña *Modelos locales* muestra un catálogo organizado por tipo de máquina, con una recomendación para **tu** ordenador: un clic instala un modelo (con progreso en vivo), un clic lo desinstala, y los instalados llevan una insignia. En *Ajustes → Carpetas de almacenamiento* eliges dónde guardar modelos, archivos temporales y bibliotecas de herramientas. ## Conectar Claude o ChatGPT La pestaña *Conectar apps de IA* convierte el nodo en un servidor MCP para tu asistente — ahora con **configuración en un clic**: - **Conectar Claude Code** — localiza la CLI `claude` y registra el nodo automáticamente; abre una nueva sesión y pregunta por tu contenido de SweetHive. - **Conectar Claude Desktop** — escribe la entrada en la configuración de Claude Desktop por ti; reinicia Claude Desktop y las herramientas están ahí. - **Opciones para desarrolladores** — el fragmento JSON y un endpoint MCP HTTP local protegido con secreto para otros clientes. ## SweetHive Desktop — chatea con tu ordenador La pestaña Chat incluye **SweetHive Desktop**: conversaciones con la propia máquina, organizadas como un chat de IA moderno (lista de hilos con título, *Nueva conversación*). Las respuestas salen de tu modelo local predeterminado y tus datos se quedan en el ordenador; las conversaciones se sincronizan con tu cuenta, así que también puedes abrirlas **desde SweetHive web** (*Mis agentes → SweetHive Desktop*) y hablar con tu ordenador en remoto — responde en segundos siempre que la app esté abierta. ## Privacidad y control - Los tokens tienen alcance limitado, caducan y se pueden revocar en cualquier momento desde **Mis agentes**. - Los secretos se cifran con el llavero del sistema operativo. - La inferencia de los modelos se ejecuta íntegramente en tu máquina. --- # Conectar un agente Puedes conectar un asistente de IA local — Claude Desktop, Claude Code, un agente de tipo OpenClaw o cualquier agente compatible con MCP — a SweetHive. Se conecta con un **token de acceso acotado** que nunca supera lo que tú puedes ver, y que puedes revocar en cualquier momento. ## Crear una conexión 1. Abre **Mis agentes** desde la barra de inicio (o *Ajustes → Agentes conectados*). 2. Elige **Conectar un agente**. 3. Ponle nombre, elige los **hives y contextos** a los que puede acceder, elige una **capacidad** y una **caducidad**. 4. Crea el token. **Cópialo (se muestra una sola vez)** o descarga el paquete de configuración. 5. Registra el conector en tu agente local usando el paquete — consulta la [configuración del conector MCP](/es/mcp-connector/). ## Capacidades | Capacidad | El agente puede | |---|---| | **Lectura** (predeterminada) | leer elementos y buscar dentro de su alcance | | **Lectura + borrador** | además, preparar borradores para que tú los envíes | | **Lectura + publicación** | además, publicar posts y respuestas en tu nombre — antes confirma contigo el texto exacto en el chat | ## Qué permanece seguro - El alcance del token se **cruza con tu visibilidad en vivo en cada petición**. Sal de un grupo y el token pierde ese acceso en el mismo instante. - **La solo lectura es lo predeterminado.** Publicar requiere un token de Lectura + publicación, y el agente confirma contigo el texto exacto en el chat antes de publicar. - Todo lo que publica un agente conectado se atribuye **«a través de ti»** y obedece el mismo destino por grupos que cualquier mensaje. - **Revoca** un token con un clic desde su tarjeta — el acceso se detiene de inmediato. - La tarjeta de cada token muestra cuándo se usó por última vez y cuánto ha leído, y los administradores del hive pueden permitir, restringir a solo lectura o bloquear por completo los agentes externos en su hive. > Tu agente se ejecuta **fuera** de SweetHive. Todo lo que el token pueda leer, trátalo > como si estuviera en tu máquina — así que acota bien su alcance: los contextos que > necesita, nada más. ## Observa a tus agentes en acción La página **Mis agentes** lista cada token con su alcance, capacidad, caducidad y un indicador **en línea** en vivo (el agente se ha conectado recientemente). Desde un contexto también puedes ver cuáles de tus agentes lo cubren actualmente. --- # Chatear con tu agente Una vez que un agente está [conectado](/es/connect-an-agent/), no tienes que salir de SweetHive para usarlo: la app **Chat con el agente** te da una conversación directa con él. ## Dónde chatear - Desde **Mis agentes** — abre el chat de cualquier agente conectado. - Desde un **contexto** que el agente cubre — el banner lo muestra conectado, con el chat en un popup a un clic. - Desde la app **Agents Node** en tu ordenador. Es **una sola conversación por agente**: la abras donde la abras, continúas el mismo hilo. ## Cómo funciona - Escribes un mensaje; el agente confirma al instante que lo ha recibido (ves un indicador de escritura mientras trabaja) y la respuesta se genera **en tu propio ordenador** con el Agents Node — el punto verde significa conectado. - El agente responde **con su propia voz, solo a ti** — una respuesta de chat no es una publicación en el feed del contexto. - Si el agente tiene un token de **Lectura + publicación**, puede publicar posts y respuestas reales en sus contextos **en tu nombre**. Siempre te muestra el texto exacto y espera tu sí en el chat antes de publicar; la publicación respeta tus grupos de destino. > ¿Prefieres hablar con tu **ordenador** en vez de con un agente de contexto? > Mira *SweetHive Desktop* en la página [Agents Node](/es/agents-node/) — > mismo chat, modelos locales, accesible en remoto. ## Cosas buenas que preguntar - *«Ponme al día de este contexto desde ayer.»* - *«¿Qué tareas siguen abiertas en el Proyecto A?»* - *«Redacta una breve actualización para el DevGroup sobre el lanzamiento — yo la reviso.»* - *«¿Qué contextos han tenido más actividad esta semana?»* > El chat está limitado por el token del agente: solo puede hablar de lo que su alcance — > cruzado con **tu** visibilidad en vivo — le permite ver. --- # SweetHive y la EU AI Act > **IA por diseño. Gobernanza por diseño. Privacidad por diseño.** SweetHive se diseñó desde el principio como una plataforma colaborativa nativa de IA — no como una herramienta de colaboración tradicional a la que se añadió la IA más tarde. Su arquitectura se alinea de forma natural con muchos de los principios fundamentales de la **EU AI Act (Regulation (EU) 2024/1689)**: gobernanza, supervisión humana, seguridad, privacidad y acceso controlado a la información. El cumplimiento depende, en última instancia, de los modelos de IA concretos y de los casos de uso que despliega cada organización. Lo que SweetHive aporta es una base técnica que simplifica considerablemente el cumplimiento de la AI Act. ## IA acotada por diseño La AI Act anima a las organizaciones a minimizar el acceso innecesario a los datos y a reducir el impacto potencial de los sistemas de IA. SweetHive implementa este principio en el núcleo de su arquitectura. Cada agente de IA opera dentro de un alcance estrictamente definido: - solo los hives, [contextos](/es/contexts/) y subcontextos concedidos de forma explícita; - solo la información que ya es visible para el usuario que hace la petición; - solo para las capacidades asignadas a su token. En cada petición, los permisos efectivos son la **intersección** de: - los permisos actuales del usuario; - el alcance configurado del token. Por lo tanto, un asistente de IA **nunca puede acceder a información más allá de lo que su propietario puede ver en ese momento**. Si un usuario pierde el acceso a un contexto o a un [grupo](/es/groups/), todos los agentes conectados pierden ese mismo acceso al instante — sin necesidad de regenerar el token. ## Principio de mínimo privilegio Cada conexión a SweetHive sigue el **principio de mínimo privilegio**, un principio de seguridad fundamental recomendado en los marcos europeos de ciberseguridad y gobernanza de la IA. Los agentes reciben solo los permisos mínimos necesarios para su tarea. Las capacidades disponibles son: - **Lectura** - **Lectura + borrador** - **Lectura + publicación** Las organizaciones deciden qué capacidades se permiten dentro de cada hive, y los administradores pueden restringir o desactivar por completo los agentes de IA externos. Consulta [Conectar un agente](/es/connect-an-agent/) para saber cómo se asignan las capacidades y el alcance. ## Supervisión humana Un requisito clave de la AI Act es que las personas mantengan el control de las decisiones y acciones asistidas por IA. SweetHive está diseñado en torno a este principio. Un agente puede redactar mensajes, resúmenes o informes, pero **la publicación de contenido siempre permanece bajo control humano**. Para los agentes con capacidad de **Lectura + publicación**: - se muestra al usuario el mensaje exacto; - la publicación requiere confirmación explícita; - todo mensaje publicado se atribuye como enviado **a través del usuario**. Se trata de un verdadero flujo de trabajo **human-in-the-loop**, no de publicación autónoma. ## Privacidad por diseño La privacidad está integrada en toda la plataforma: - tokens de acceso acotados; - revocación inmediata de tokens; - evaluación de permisos en vivo; - conectores de solo lectura por defecto; - almacenamiento cifrado de secretos; - gestión de credenciales en el servidor; - inferencia de IA local opcional a través de [SweetHive Agents Node](/es/agents-node/). Cuando se usan modelos locales, los prompts y los datos permanecen en el ordenador del usuario durante la inferencia — lo que reduce considerablemente el riesgo para la privacidad y las transferencias de datos. ## Conexiones de IA seguras SweetHive expone sus capacidades de IA a través de conectores seguros y compatibles con MCP. Cada conexión de IA utiliza: - tokens acotados; - caducidad configurable; - revocación en cualquier momento; - permisos basados en capacidades; - verificación continua de permisos. Un token filtrado nunca expone una cuenta entera. Su alcance queda limitado al ámbito configurado, a los permisos actuales del propietario y a las capacidades asignadas. ## Transparencia Los usuarios siempre saben: - qué agentes de IA están conectados; - a qué contextos pueden acceder; - qué capacidades tienen; - cuándo se usaron por última vez; - si están actualmente en línea. Las organizaciones mantienen plena visibilidad y control sobre los sistemas de IA conectados. ## Auditabilidad SweetHive ofrece funciones de rendición de cuentas que respaldan los requisitos de gobernanza: - último uso del token; - información sobre capacidades; - fechas de caducidad; - estado en línea; - revocación de tokens con un solo clic; - atribución de los posts generados por IA. Estos mecanismos ayudan a las organizaciones a construir flujos de trabajo de IA auditables y a demostrar control operativo. ## Seguridad consciente del contexto A diferencia de los sistemas de chat tradicionales, donde una IA suele recibir acceso a grandes colecciones de documentos, SweetHive organiza la información en contextos jerárquicos protegidos por grupos. La visibilidad siempre fluye a través de la estructura organizativa. Esto limita de forma natural la exposición de la IA y reduce drásticamente la fuga accidental de información. El resultado es un sistema de IA que entiende el contexto organizativo **sin** necesitar acceso ilimitado al conocimiento de la organización. ## Alineación con la EU AI Act SweetHive está diseñado para respaldar muchos de los principios que promueve la EU AI Act: | Principio de la AI Act | Implementación en SweetHive | |---|---| | Minimización de datos | Contextos acotados y visibilidad basada en grupos | | Supervisión humana | Confirmación del usuario antes de que la IA publique | | Mínimo privilegio | Tokens acotados basados en capacidades | | Transparencia | Agentes conectados y permisos visibles | | Rendición de cuentas | Seguimiento de tokens y atribución de la IA | | Privacidad por diseño | Inferencia local, acceso acotado, conectores seguros | | Seguridad por diseño | Aplicación dinámica de permisos y revocación inmediata | ## Aviso de cumplimiento La EU AI Act regula el **despliegue y uso** de los sistemas de IA, y no las plataformas de colaboración en sí. SweetHive proporciona una arquitectura que respalda la gobernanza de la IA y el cumplimiento normativo, pero las obligaciones aplicables a un despliegue concreto dependen, en última instancia, de: - los modelos de IA que se utilicen; - el caso de uso previsto; - los procesos de gobernanza de la organización; - la normativa nacional y europea aplicable. Las organizaciones que despliegan IA en escenarios de alto riesgo deben complementar las salvaguardas técnicas de SweetHive con procedimientos adecuados de gestión de riesgos, documentación, monitorización y gobernanza, tal como exige la AI Act. ## Diseñado para una IA responsable En lugar de tratar la IA como un chatbot aislado con acceso amplio al conocimiento de la organización, SweetHive integra la IA en un entorno de colaboración seguro donde cada acción se rige por las mismas reglas de visibilidad, permisos y estructura organizativa en las que los usuarios ya confían. El resultado es una IA que es: - **segura por diseño** - **privada por diseño** - **gobernada por diseño** - **controlada por humanos por diseño** - **lista para la adopción de IA empresarial** --- # Construir una app Los desarrolladores pueden construir apps personalizadas para SweetHive — una pequeña vista de datos embebida en un contexto, o un producto completo en su propia URL. Registras la app una vez, recibes credenciales de cliente y construyes con el **App SDK**. ## Dos tipos de app | | **Embebida** | **Externa** | |---|---|---| | Dónde se ejecuta | dentro de la interfaz del contexto de SweetHive (un iframe aislado) | su propia URL / dominio, lanzada desde SweetHive | | Ideal para | vistas de datos, formularios, paneles acotados a un contexto | productos completos con su propia interfaz | Ambas se autentican de la misma manera: un **token acotado de corta duración**, limitado en el servidor por el alcance de la instalación **y** la visibilidad en vivo de quien la usa. Tu app nunca ve más de lo que puede ver la persona que la está usando, y el acceso se revoca en el instante en que lo pierde. ## Registrar y construir 1. Abre **Desarrollador → Apps** desde el menú de usuario. 2. Elige **Registrar app**: ponle nombre, elige *Embebida* o *Externa*, configura la URL, el icono y la capacidad. 3. Guarda el **client ID y el secreto** (se muestran una sola vez). 4. **Descarga la guía de desarrollo del SDK (.md)** — el contrato completo: el handshake del iframe, la autenticación, la API de datos acotada, las pruebas y la publicación. Ponla en tu repositorio y construye con tu asistente de programación con IA. También disponible aquí: [SWEETHIVE_APP_SDK.md](/downloads/SWEETHIVE_APP_SDK.md). 5. Pon la app en **Activa** para que los administradores de hive puedan instalarla desde *Contexto → Apps → Añadir app*. ## Cómo funciona el estándar - Las **apps embebidas** se ejecutan en un iframe aislado y reciben un token acotado de corta duración mediante un handshake de `postMessage` — nunca una cookie, así que también funciona en las apps móviles. Tu app debe permitir que SweetHive la enmarque (una CSP `frame-ancestors` que incluya los orígenes de las apps móviles — la guía del SDK da la cabecera exacta). - Las **apps externas** se abren en su propia URL con un lanzamiento firmado; en móvil se abren en el navegador nativo integrado en la app. - Cada llamada de datos está limitada en el servidor por el alcance de la instalación cruzado con la visibilidad en vivo de quien la usa — la misma ley, la misma auditoría que cualquier actor de SweetHive. ## Apps externas y hubs Una app externa es un producto completo en su propia URL. SweetHive muestra una tarjeta de inicio; al hacer clic la app se abre con un **inicio firmado** y crea su propia sesión — en móvil, en el navegador nativo integrado. Las apps externas en un origen autorizado también pueden iniciar la sesión de los usuarios directamente con su cuenta de SweetHive (**SSO**): con una sesión de SweetHive activa no se pide contraseña; de lo contrario el usuario inicia sesión en la página de acceso de SweetHive y vuelve directamente a la app. Solicita la autorización del origen al registrar la app. ### Hubs multi-hive: una shell, muchas apps Un producto que gestiona varios hives desde una sola interfaz sigue el **estándar hub shell** — una shell reutilizable modelada por un manifest: - La **shell** proporciona, una sola vez para cada app: el acceso SSO, el selector de hive arriba a la derecha, la gestión de Equipo e Invitaciones, el tema claro/oscuro y la barra lateral plegable. - El **manifest** (guardado con el registro de la app) declara la marca y las entradas del panel izquierdo. Cada entrada abre una vista integrada en la shell o — la parte clave — **cualquier app embebida de SweetHive renderizada en un frame, sin cambios**: una sola build sirve la interfaz del contexto y el hub. - Cambiar de hive redefine el alcance de todo: la shell resuelve la instalación de la app en el hive seleccionado y recarga la vista activa, de modo que cada pantalla sigue al hive — incluidos los estados vacíos para hives donde la app no está instalada. La guía del SDK contiene el contrato completo: el esquema del manifest, el handshake de las vistas y los errores a evitar. ## Probar y publicar Registra tu app con una URL de localhost, instálala en un contexto de prueba, y el handshake entrega un token acotado real contra tus datos. Cuando esté lista, ponla en **Activa** — y desactívala en cualquier momento; las instalaciones se detienen de inmediato. --- # Configuración del conector MCP SweetHive expone su Agent Client API como un **servidor MCP**. Cualquier agente compatible con MCP — Claude Desktop, Claude Code, Cowork, agentes de tipo OpenClaw y otros — se conecta con un único **token de acceso acotado** que emites desde SweetHive. Un servidor, un modelo de token, todos los clientes. Primero, [crea un token](/es/connect-an-agent/) en **Mis agentes → Conectar un agente** y descarga el paquete de configuración (contiene tu `endpoint` y tu `token`). ## Qué obtiene tu agente | Herramienta | Hace | |---|---| | `whoami` | el alcance efectivo del token, su capacidad y su propietario | | `contexts` | el árbol de hives/contextos concedido | | `items` | elementos recientes de un contexto y su subárbol | | `search` | buscar mensajes, notas y archivos en los contextos concedidos | | `post_message` | publicar en un contexto (solo tokens de *Lectura + publicación*; la primera publicación pide tu confirmación) | | `chat_pull` / `chat_reply` | el [chat dentro de SweetHive](/es/chat-with-your-agent/) contigo | ## Configura tu cliente **Conector local (stdio)** — funciona hoy con Claude Desktop, Claude Code y cualquier cliente MCP por stdio. Instala el conector empaquetado de SweetHive y luego añade: ```json { "mcpServers": { "sweethive": { "command": "node", "args": ["/absolute/path/to/sweethive-connector/dist/index.js"], "env": { "SWEETHIVE_ENDPOINT": "https://sweethive.com/server/web", "SWEETHIVE_TOKEN": "shv_..." } } } } ``` **Remoto (HTTP transmitible)** — donde el endpoint MCP alojado esté habilitado, apunta tu cliente a él con el token como credencial Bearer: ```json { "mcpServers": { "sweethive": { "url": "https://sweethive.com/mcp", "headers": { "Authorization": "Bearer shv_..." } } } } ``` Tu agente ya puede responder a cosas como *«¿qué ha cambiado en el Proyecto A esta semana?»* o *«redacta una actualización de estado para el DevGroup»*. ## Notas - La **capacidad** (Lectura / Lectura + borrador / Lectura + publicación) queda fijada en el token; la solo lectura es lo predeterminado. - **La revocación y los cambios de grupo surten efecto de inmediato** — no hay alcance en caché. Una configuración filtrada expone un alcance limitado y anulable, nunca las credenciales de tu cuenta. - El contenido que llega desde un agente externo se trata como no confiable: no puede llevar menciones privilegiadas ni invocar agentes internos de SweetHive, y está limitado en frecuencia por token.