Saltar al contenido

Herramientas · Miembros

Herramientas MCP para miembros: listar y buscar miembros, invitar a una persona o a una clase entera, cambiar roles, quitar a alguien de la comunidad, organizar grupos y etiquetas y montar el organigrama.

Quién está en la comunidad y cómo se organiza: listar y buscar miembros, invitar a una persona o a una clase entera, cambiar roles, quitar a alguien, crear grupos, poner etiquetas e indicar quién depende de quién en el organigrama.

Invitar y cambiar un rol ocurren en la primera llamada, como en el panel; como la invitación envía un correo de verdad, el asistente muestra antes quién lo va a recibir. Solo quitar a un miembro y eliminar un grupo o una etiqueta piden tu confirmación en dos pasos. Consulta Dinero y confirmación.

Cada herramienta lleva un sello: Solo consulta no cambia nada, Modifica crea o cambia algo al momento, y Pide confirmación solo actúa después de tu sí a un resumen. Consulta Dinero y confirmación.

En resumen

HerramientaQué haceRol mínimoTipo
list_membersMiembros con rol y fecha de entradaModeradorSolo consulta
invite_memberInvita a una persona, con rol, grupos y etiquetasAdministradorModifica
invite_membersInvita hasta 100 personas a la vez, con el resultado línea a líneaAdministradorModifica
update_member_roleCambia el rol de un miembroAdministradorModifica
remove_memberSaca a una persona de la comunidadAdministradorPide confirmación
list_groupsGrupos, con color, líder, grupo padre y cuántas personasModeradorSolo consulta
create_groupCrea un grupo de miembrosModeradorModifica
update_groupRenombra o cambia un grupoModeradorModifica
delete_groupElimina un grupo; las personas siguen en la comunidadModeradorPide confirmación
update_group_membersPone o quita personas de un grupoModeradorModifica
list_tagsEtiquetas en uso, con color y cuántas personasModeradorSolo consulta
update_member_tagsPone o quita etiquetas a una o más personasModeradorModifica
update_tagRenombra una etiqueta o cambia su colorModeradorModifica
delete_tagQuita una etiqueta de todas las personasModeradorPide confirmación
get_org_chartQuién depende de quién, con los gruposModeradorSolo consulta
set_managerIndica de quién depende una personaModeradorModifica
list_activity_logsQuién hizo qué: equipo, asistente y miembrosAdministradorSolo consulta

list_members

Solo consulta

Listar miembros. Los miembros, con rol y fecha de entrada. Rol mínimo: moderador.

ParámetroTipoObligatorioDescripción
searchtextoNoParte del nombre o del correo
roleowner, admin, moderator, member, financeNoUn solo rol
sort_byjoinedAt, lastSeenAt, displayName, role, fullNameNojoinedAt para "quién ha entrado", lastSeenAt para "quién ha aparecido"
orderasc, descNoAscendente o descendente
page, limitnúmeroNoPaginación

Devuelve: los perfiles (nombre visible, nombre, rol, fecha de entrada, avatar) y la paginación.

Pídelo así: "¿Quién ha entrado en la comunidad en los últimos 7 días?" · "¿Quiénes son los moderadores?"

invite_member

Modifica

Invitar a una persona. Invita a una persona a la comunidad, con nombre, rol, grupos y etiquetas. Rol mínimo: administrador.

ParámetroTipoObligatorioDescripción
emailcorreoSíEl correo de la persona
nametexto, de 2 a 100NoEl nombre completo. Sin él, el nombre sale del correo
rolemember, moderator, admin, financeNoPor defecto: member. Nadie entra como propietario por invitación
groupslista de nombres o ids, hasta 20NoLos grupos en los que entra la persona (de list_groups)
tagslista de textos, hasta 20NoLas etiquetas de la persona

Devuelve: la invitación enviada: quién la recibió, con qué rol, grupos y etiquetas.

Pídelo así: "Invita a [email protected] como moderadora, en el grupo Clase de marzo."

Notas: la invitación envía un correo de verdad en la primera llamada; el asistente muestra antes quién lo va a recibir. Quien no tiene cuenta recibe el enlace para definir la contraseña; quien ya tiene cuenta recibe el aviso de que ha sido añadido. Consulta Invitar miembros.

invite_members

Modifica

Invitar a una clase. Invita hasta 100 personas a la vez, cada una con su propio nombre, rol, grupos y etiquetas, o con un valor por defecto para todas. Rol mínimo: administrador.

ParámetroTipoObligatorioDescripción
peoplelista de 1 a 100SíCada persona con email (obligatorio), name, role, groups y tags
rolemember, moderator, admin, financeNoEl rol de quien no tenga uno propio. Por defecto: member
groupslista, hasta 20NoLos grupos de quien no tenga los suyos
tagslista, hasta 20NoLas etiquetas de quien no tenga las suyas

Devuelve: el resultado línea a línea: invitada, ya era miembro (already_member) o error, con el motivo.

Pídelo así: "Invita a estas 30 personas como miembros, todas en el grupo Clase de marzo: [lista de nombres y correos]."

Notas: los correos salen en la primera llamada, por eso el asistente muestra la lista antes de invitar. Cada línea sale bien o falla por sí sola: quien ya es miembro no detiene al resto. Para más de 100 personas, el asistente divide la lista. Consulta la receta Invitar a una clase.

update_member_role

Modifica

Cambiar el rol de alguien. Cambia el rol de un miembro. Rol mínimo: administrador.

ParámetroTipoObligatorioDescripción
membertextoSíEl id del perfil (de list_members) o el correo de la persona
rolemember, moderator, admin, financeSíEl rol nuevo

Devuelve: el perfil con el rol nuevo.

Pídelo así: "Asciende a [email protected] a moderadora."

Notas: cambia lo que la persona puede hacer al momento; para deshacerlo, pide el rol anterior. El rol del propietario solo lo cambia otro propietario. Consulta Roles y permisos.

remove_member

Pide confirmación

Quitar miembro. Saca a una persona de la comunidad. Rol mínimo: administrador.

ParámetroTipoObligatorioDescripción
membertextoSíEl id del perfil (de list_members) o el correo de la persona

Devuelve: en la primera llamada, el nombre, el correo y el rol de la persona, y el código de confirmación.

Pídelo así: "Saca a [email protected] de la comunidad."

Notas: los certificados de la persona siguen siendo válidos. Solo un propietario quita a otro propietario, y nadie se quita a sí mismo por aquí. Consulta Gestionar miembros.

list_groups

Solo consulta

Listar grupos. Los grupos de miembros (departamentos, clases, equipos), con color, líder, grupo padre y cuántas personas tiene cada uno. Rol mínimo: moderador.

Parámetros: ninguno.

Devuelve: los grupos, con id, nombre, color, líder, grupo padre y número de personas.

Pídelo así: "¿Qué grupos tiene la comunidad y cuántas personas hay en cada uno?"

create_group

Modifica

Crear grupo. Crea un grupo de miembros. Rol mínimo: moderador.

ParámetroTipoObligatorioDescripción
nametextoSíÚnico en la comunidad
descriptiontexto simpleNoSin formato: las marcas de Markdown se eliminan
colorcolor en hexNoEj.: #2563EB
parent_groupnombre o idNoEl grupo de arriba (dirección → área → equipo)

Devuelve: el grupo creado, con el id.

Pídelo así: "Crea el grupo Clase de marzo, azul, dentro de Alumnos."

Consulta Grupos y organigrama.

update_group

Modifica

Renombrar o cambiar grupo. Cambia el nombre, la descripción, el color o el grupo padre de un grupo. Rol mínimo: moderador.

ParámetroTipoObligatorioDescripción
groupnombre o idSíEl grupo
nametextoNoEl nombre nuevo
descriptiontexto simpleNoSin formato: las marcas de Markdown se eliminan
colorcolor en hexNo
parent_groupnombre o idNoEl nuevo grupo de arriba

Devuelve: el grupo actualizado.

Pídelo así: "Renombra el grupo Clase de marzo a Clase 2026.1."

delete_group

Pide confirmación

Eliminar grupo. Elimina un grupo. Rol mínimo: moderador.

ParámetroTipoObligatorioDescripción
groupnombre o idSíEl grupo

Devuelve: en la primera llamada, el resumen (el grupo y cuántas personas tiene) y el código; en la segunda, la eliminación.

Pídelo así: "Elimina el grupo Clase de 2024."

Notas: las personas salen del grupo, pero siguen en la comunidad; los grupos que estaban debajo suben un nivel.

update_group_members

Modifica

Poner o quitar personas de un grupo. Añade o quita personas de un grupo, sin tocar sus otros grupos. Rol mínimo: moderador.

ParámetroTipoObligatorioDescripción
groupnombre o idSíEl grupo
addlista de ids de perfil o correosNoQuién entra
removelista de ids de perfil o correosNoQuién sale

Devuelve: el resultado persona a persona.

Pídelo así: "Pon en el grupo Mentoría a todos los que han comprado la mentoría este mes."

list_tags

Solo consulta

Listar etiquetas de miembros. Las etiquetas usadas en la comunidad, con color y cuántas personas tiene cada una. Rol mínimo: moderador.

Parámetros: ninguno.

Devuelve: las etiquetas, con nombre, color y número de personas.

Pídelo así: "¿Qué etiquetas existen y cuántas personas tiene cada una?"

update_member_tags

Modifica

Poner o quitar etiquetas. Añade y quita etiquetas a una o más personas, manteniendo sus otras etiquetas. Rol mínimo: moderador.

ParámetroTipoObligatorioDescripción
memberslista de ids de perfil o correosSíLas personas
addlista de etiquetasNoLas etiquetas que entran
removelista de etiquetasNoLas etiquetas que salen

Devuelve: el resultado persona a persona.

Pídelo así: "Pon la etiqueta Mentor a [email protected] y a [email protected]."

Notas: las etiquetas de sistema, como Ponente, no se ponen a mano. Consulta Etiquetas.

update_tag

Modifica

Renombrar o cambiar el color de una etiqueta. Renombra una etiqueta en todas las personas que la tienen y cambia su color. Rol mínimo: moderador.

ParámetroTipoObligatorioDescripción
tagtextoSíLa etiqueta
new_nametextoNoEl nombre nuevo
colorcolor en hexNo

Devuelve: la etiqueta actualizada.

Pídelo así: "Cambia la etiqueta Mentor por Mentora y ponla morada."

delete_tag

Pide confirmación

Eliminar etiqueta. Quita una etiqueta de todas las personas que la tienen. Rol mínimo: moderador.

ParámetroTipoObligatorioDescripción
tagtextoSíLa etiqueta

Devuelve: en la primera llamada, el resumen y el código; en la segunda, la eliminación.

Pídelo así: "Elimina la etiqueta Evento 2024."

Notas: las personas siguen en la comunidad; solo sale la etiqueta.

get_org_chart

Solo consulta

Ver organigrama. Quién depende de quién, con los grupos de cada persona. Rol mínimo: moderador.

ParámetroTipoObligatorioDescripción
root_memberid de perfil o correoNoQuién queda arriba
groupnombre o idNoDibuja solo ese grupo
depthnúmeroNoCuántos niveles bajar

Devuelve: el árbol, persona a persona, con su responsable y sus grupos.

Pídelo así: "Muéstrame el organigrama del área de Producto."

Consulta Grupos y organigrama.

set_manager

Modifica

Definir de quién depende una persona. Indica el responsable de una persona en el organigrama, o lo quita. Rol mínimo: moderador.

ParámetroTipoObligatorioDescripción
memberid de perfil o correoSíLa persona
managerid de perfil o correoNoDe quién depende
no_managersí o noNotrue quita el responsable

Devuelve: la persona con el nuevo responsable.

Pídelo así: "Bruno pasa a depender de Ana."

Notas: un ciclo (A depende de B, que depende de A) se rechaza. El organigrama no da ningún permiso: lo que cada uno puede hacer sigue siendo su rol.

list_activity_logs

Solo consulta

Registros de actividad. Quién hizo qué en la comunidad, de lo más reciente a lo más antiguo: la misma línea de tiempo de la pestaña Miembros › Registros. Rol mínimo: administrador (propietario o administrador).

ParámetroTipoObligatorioDescripción
sourceteam, assistant, membersNoEquipo (las acciones sobre suscripciones: cancelar, reactivar, descuento, cortesía, extensión, adicional, enlace de pago), asistente (lo que un asistente de IA hizo por el MCP, incluidas las conexiones autorizadas y desconectadas) o miembros (las acciones que dan puntos en el ranking). Sin él, las tres
profileid de perfil, correo o enlace de la appNoSolo lo que hizo esa persona
from, tofecha ISO 8601NoEl periodo. Una fecha sin hora en to vale el día entero
page, limitnúmerosNoHasta 100 por página

Devuelve: cada registro con cuándo, quién, la acción (en tu idioma), sobre qué y los detalles: el antes y después de una acción del equipo, el resultado de una llamada del asistente (completada, error, rechazada o esperando confirmación) o los puntos de una acción de un miembro. Los argumentos de las llamadas del asistente vienen resumidos, sin códigos de confirmación ni imágenes.

Pídelo así: "¿Quién canceló la suscripción de Ana?" · "¿Qué hizo el asistente ayer?" · "¿Qué hizo [email protected] esta semana?"

Notas: si una llamada del asistente falló, la respuesta sugiere get_connection_diagnostics; con una persona en el filtro, sugiere member_activity. Un perfil o enlace de otra comunidad se rechaza.

Relacionados