Organizacion y Equipos

La organizacion es el espacio de trabajo principal en Almirant. Todos los proyectos, miembros, integraciones y configuraciones pertenecen a una organizacion. Dentro de la organizacion, puedes gestionar equipos para organizar el trabajo de forma mas granular.

Que es una organizacion

Una organizacion en Almirant representa tu empresa, equipo o grupo de trabajo. Es el contenedor de nivel superior que agrupa:

• Proyectos -- Todos los proyectos creados pertenecen a una organizacion.
• Miembros -- Las personas que tienen acceso a la organizacion y sus proyectos.
• Integraciones -- Las conexiones con servicios externos (GitHub, Vercel, Telegram).
• Proveedores de IA -- La configuracion de proveedores y cuotas de inteligencia artificial.
• API Keys -- Los tokens de acceso para integraciones externas y MCP.

Configurar la organizacion

Para acceder a la configuracion de tu organizacion:

1. Haz clic en el nombre de tu organizacion en el menu lateral.
2. Selecciona Configuracion o accede directamente desde Settings.

Datos de la organizacion

Campo	Descripcion	Obligatorio
Nombre	Nombre de la organizacion que aparece en toda la plataforma	Si
Logo	Imagen representativa de la organizacion	No
Slug	Identificador unico en la URL de la organizacion	Si

Para actualizar los datos:

1. Accede a Configuracion > General.
2. Modifica los campos deseados.
3. Guarda los cambios.

Gestion de miembros

Los miembros son las personas que tienen acceso a la organizacion y pueden trabajar en sus proyectos.

Invitar miembros

1. Accede a Configuracion > Miembros.
2. Haz clic en Invitar miembro.
3. Introduce el email del nuevo miembro.
4. Selecciona el rol que tendra en la organizacion.
5. Envia la invitacion.

El miembro recibira un email con un enlace para unirse a la organizacion. Si ya tiene cuenta en Almirant, se le agregara directamente. Si no, debera crear una cuenta primero.

Roles de miembros

Almirant define roles para controlar el nivel de acceso de cada miembro:

Rol	Permisos
Owner	Control total sobre la organizacion. Puede gestionar miembros, configuracion, facturacion y eliminar la organizacion
Admin	Puede gestionar miembros, proyectos, integraciones y configuracion. No puede eliminar la organizacion
Member	Puede trabajar en proyectos asignados, crear y editar work items, usar AI Planning y agentes

Principio de minimo privilegio

Asigna el rol mas restrictivo que permita a cada miembro realizar su trabajo. Reserva el rol de Owner para 1-2 personas y Admin para team leads.

Ver miembros activos

La lista de miembros muestra:

• Nombre y email de cada miembro.
• Rol asignado.
• Fecha de incorporacion.
• Estado de la invitacion (pendiente, aceptada).

Modificar rol de un miembro

1. Accede a Configuracion > Miembros.
2. Busca al miembro en la lista.
3. Haz clic en el selector de rol.
4. Selecciona el nuevo rol.
5. Confirma el cambio.

Eliminar un miembro

1. Accede a Configuracion > Miembros.
2. Busca al miembro en la lista.
3. Haz clic en Eliminar o en el icono de eliminacion.
4. Confirma la eliminacion.

aviso

Eliminar a un miembro revoca su acceso inmediatamente. Los work items asignados al miembro mantendran la asignacion historica pero el miembro dejara de recibir notificaciones. Reasigna los work items activos antes de eliminar al miembro.

Equipos

Los equipos permiten agrupar miembros dentro de una organizacion para facilitar la asignacion de trabajo y la comunicacion.

Crear un equipo

1. Accede a Configuracion > Equipos.
2. Haz clic en Crear equipo.
3. Define un nombre para el equipo (por ejemplo: "Frontend", "Backend", "QA").
4. Agrega miembros al equipo seleccionandolos de la lista de miembros de la organizacion.
5. Guarda el equipo.

Uso de equipos

Los equipos son utiles para:

• Asignacion rapida -- Asignar work items a un equipo completo en lugar de a miembros individuales.
• Filtrado -- Filtrar el board por equipo para ver solo las tareas de un grupo especifico.
• Visibilidad -- Entender rapidamente quien forma parte de cada area funcional.

Transferir proyectos entre organizaciones

Si tienes acceso a multiples organizaciones, puedes transferir proyectos de una a otra. Consulta la seccion de transferencia de proyectos para mas detalles.

Para Developers

Herramientas MCP

Los siguientes tools estan disponibles via MCP para gestionar miembros:

Tool	Descripcion	Parametros principales
list_members	Lista los miembros de la organizacion	organizationId

Ejemplo: Listar miembros

Tool: list_members
Parametros:
  organizationId: "uuid-de-la-organizacion"

Devuelve la lista de miembros con su nombre, email, rol y estado.

Rutas de la aplicacion

Ruta	Descripcion
/settings	Configuracion general de la organizacion
/settings/members	Gestion de miembros
/settings/teams	Gestion de equipos