Ferramentas · Membros
Ferramentas MCP para membros: listar e buscar membros, convidar uma pessoa ou uma turma inteira, trocar papéis, remover alguém da comunidade, organizar grupos e tags e montar o organograma.
Quem está na comunidade e como ela se organiza: listar e buscar membros, convidar uma pessoa ou uma turma inteira, trocar papéis, remover alguém, criar grupos, marcar tags e dizer quem responde a quem no organograma.
Convidar e trocar um papel acontecem na primeira chamada, como no painel; como o convite manda e-mail de verdade, o assistente mostra antes quem vai receber. Só a remoção de um membro e as exclusões de grupo e de tag pedem a sua confirmação em duas etapas. Ver Dinheiro e confirmação.
Cada ferramenta traz um selo: Só consulta não muda nada, Altera cria ou muda algo na hora, e Pede confirmação só age depois do seu sim a um resumo. Ver Dinheiro e confirmação.
Em resumo
| Ferramenta | O que faz | Papel mínimo | Tipo |
|---|---|---|---|
list_members | Membros com papel e data de entrada | Moderador | Só consulta |
invite_member | Convida uma pessoa, com papel, grupos e tags | Administrador | Altera |
invite_members | Convida até 100 pessoas de uma vez, com o resultado linha a linha | Administrador | Altera |
update_member_role | Troca o papel de um membro | Administrador | Altera |
remove_member | Tira uma pessoa da comunidade | Administrador | Pede confirmação |
list_groups | Grupos, com cor, líder, grupo pai e quantas pessoas | Moderador | Só consulta |
create_group | Cria um grupo de membros | Moderador | Altera |
update_group | Renomeia ou muda um grupo | Moderador | Altera |
delete_group | Exclui um grupo; as pessoas ficam na comunidade | Moderador | Pede confirmação |
update_group_members | Põe ou tira pessoas de um grupo | Moderador | Altera |
list_tags | Tags usadas, com cor e quantas pessoas | Moderador | Só consulta |
update_member_tags | Marca ou desmarca tags em uma ou mais pessoas | Moderador | Altera |
update_tag | Renomeia ou muda a cor de uma tag | Moderador | Altera |
delete_tag | Tira uma tag de todas as pessoas | Moderador | Pede confirmação |
get_org_chart | Quem responde a quem, com os grupos | Moderador | Só consulta |
set_manager | Diz a quem uma pessoa responde | Moderador | Altera |
list_activity_logs | Quem fez o quê: equipe, assistente e membros | Administrador | Só consulta |
list_members
Só consulta
Listar membros. Os membros, com papel e data de entrada. Papel mínimo: moderador.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
search | texto | Não | Parte do nome ou do e-mail |
role | owner, admin, moderator, member, finance | Não | Só um papel |
sort_by | joinedAt, lastSeenAt, displayName, role, fullName | Não | joinedAt para "quem entrou", lastSeenAt para "quem apareceu" |
order | asc, desc | Não | Crescente ou decrescente |
page, limit | número | Não | Paginação |
Devolve: os perfis (nome de exibição, nome, papel, data de entrada, avatar) e a paginação.
Peça assim: "Quem entrou na comunidade nos últimos 7 dias?" · "Quem são os moderadores?"
invite_member
Altera
Convidar uma pessoa. Convida uma pessoa para a comunidade, com nome, papel, grupos e tags. Papel mínimo: administrador.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
email | Sim | O e-mail da pessoa | |
name | texto, de 2 a 100 | Não | O nome completo. Sem ele, o nome sai do e-mail |
role | member, moderator, admin, finance | Não | Padrão: member. Ninguém entra como proprietário por convite |
groups | lista de nomes ou ids, até 20 | Não | Os grupos em que a pessoa entra (de list_groups) |
tags | lista de textos, até 20 | Não | As tags da pessoa |
Devolve: o convite feito: quem recebeu, com que papel, grupos e tags.
Peça assim: "Convide a [email protected] como moderadora, no grupo Turma de março."
Notas: o convite manda um e-mail de verdade na primeira chamada; o assistente mostra antes quem vai receber. Quem não tem conta recebe o link para definir a senha; quem já tem conta recebe o aviso de que foi adicionado. Ver Convidar membros.
invite_members
Altera
Convidar uma turma. Convida até 100 pessoas de uma vez, cada uma com o próprio nome, papel, grupos e tags, ou com um padrão para todos. Papel mínimo: administrador.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
people | lista de 1 a 100 | Sim | Cada pessoa com email (obrigatório), name, role, groups e tags |
role | member, moderator, admin, finance | Não | O papel de quem não tiver um próprio. Padrão: member |
groups | lista, até 20 | Não | Os grupos de quem não tiver os próprios |
tags | lista, até 20 | Não | As tags de quem não tiver as próprias |
Devolve: o resultado linha a linha: convidada, já era membro (already_member) ou erro, com o motivo.
Peça assim: "Convide estas 30 pessoas como membros, todas no grupo Turma de março: [lista de nomes e e-mails]."
Notas: os e-mails saem na primeira chamada, por isso o assistente mostra a lista antes de convidar. Cada linha dá certo ou falha sozinha: quem já é membro não para o resto. Para mais de 100 pessoas, o assistente divide em partes. Ver a receita Convidar uma turma.
update_member_role
Altera
Trocar o papel de alguém. Muda o papel de um membro. Papel mínimo: administrador.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
member | texto | Sim | O id do perfil (de list_members) ou o e-mail da pessoa |
role | member, moderator, admin, finance | Sim | O papel novo |
Devolve: o perfil com o papel novo.
Peça assim: "Promova a [email protected] a moderadora."
Notas: muda o que a pessoa pode fazer na hora; para desfazer, peça o papel antigo. O papel do proprietário só outro proprietário muda. Ver Papéis e permissões.
remove_member
Pede confirmação
Remover membro. Tira uma pessoa da comunidade. Papel mínimo: administrador.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
member | texto | Sim | O id do perfil (de list_members) ou o e-mail da pessoa |
Devolve: na primeira chamada, o nome, o e-mail e o papel da pessoa, e o código de confirmação.
Peça assim: "Tire o [email protected] da comunidade."
Notas: os certificados da pessoa continuam válidos. Só um proprietário remove outro proprietário, e ninguém remove a si mesmo por aqui. Ver Gerenciar membros.
list_groups
Só consulta
Listar grupos. Os grupos de membros (departamentos, turmas, squads), com cor, líder, grupo pai e quantas pessoas cada um tem. Papel mínimo: moderador.
Parâmetros: nenhum.
Devolve: os grupos, com id, nome, cor, líder, grupo pai e o número de pessoas.
Peça assim: "Quais grupos a comunidade tem, e quantas pessoas em cada um?"
create_group
Altera
Criar grupo. Cria um grupo de membros. Papel mínimo: moderador.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
name | texto | Sim | Único na comunidade |
description | texto simples | Não | Sem formatação: marcas de Markdown são tiradas |
color | cor em hex | Não | Ex.: #2563EB |
parent_group | nome ou id | Não | O grupo acima (diretoria → área → squad) |
Devolve: o grupo criado, com o id.
Peça assim: "Crie o grupo Turma de março, azul, dentro de Alunos."
Ver Grupos e organograma.
update_group
Altera
Renomear ou mudar grupo. Muda o nome, a descrição, a cor ou o grupo pai de um grupo. Papel mínimo: moderador.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
group | nome ou id | Sim | O grupo |
name | texto | Não | O nome novo |
description | texto simples | Não | Sem formatação: marcas de Markdown são tiradas |
color | cor em hex | Não | |
parent_group | nome ou id | Não | O novo grupo acima |
Devolve: o grupo atualizado.
Peça assim: "Renomeie o grupo Turma de março para Turma 2026.1."
delete_group
Pede confirmação
Excluir grupo. Exclui um grupo. Papel mínimo: moderador.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
group | nome ou id | Sim | O grupo |
Devolve: na primeira chamada, o resumo (o grupo e quantas pessoas tem) e o código; na segunda, a exclusão.
Peça assim: "Exclua o grupo Turma de 2024."
Notas: as pessoas saem do grupo, mas continuam na comunidade; os grupos que estavam abaixo dele sobem um nível.
update_group_members
Altera
Pôr ou tirar pessoas de um grupo. Acrescenta ou tira pessoas de um grupo, sem mexer nos outros grupos delas. Papel mínimo: moderador.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
group | nome ou id | Sim | O grupo |
add | lista de ids de perfil ou e-mails | Não | Quem entra |
remove | lista de ids de perfil ou e-mails | Não | Quem sai |
Devolve: o resultado pessoa por pessoa.
Peça assim: "Ponha no grupo Mentoria todos os que compraram a mentoria este mês."
list_tags
Só consulta
Listar tags de membros. As tags usadas na comunidade, com cor e quantas pessoas têm cada uma. Papel mínimo: moderador.
Parâmetros: nenhum.
Devolve: as tags, com nome, cor e número de pessoas.
Peça assim: "Quais tags existem, e quantas pessoas em cada uma?"
update_member_tags
Altera
Marcar ou desmarcar tags. Acrescenta e tira tags de uma ou mais pessoas, mantendo as outras tags delas. Papel mínimo: moderador.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
members | lista de ids de perfil ou e-mails | Sim | As pessoas |
add | lista de tags | Não | As tags que entram |
remove | lista de tags | Não | As tags que saem |
Devolve: o resultado pessoa por pessoa.
Peça assim: "Marque a [email protected] e o [email protected] com a tag Mentor."
Notas: tags de sistema, como Palestrante, não se marcam à mão. Ver Tags.
update_tag
Altera
Renomear ou colorir tag. Renomeia uma tag em todas as pessoas que a têm e muda a cor dela. Papel mínimo: moderador.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
tag | texto | Sim | A tag |
new_name | texto | Não | O nome novo |
color | cor em hex | Não |
Devolve: a tag atualizada.
Peça assim: "Troque a tag Mentor por Mentora e deixe roxa."
delete_tag
Pede confirmação
Excluir tag. Tira uma tag de todas as pessoas que a têm. Papel mínimo: moderador.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
tag | texto | Sim | A tag |
Devolve: na primeira chamada, o resumo e o código; na segunda, a exclusão.
Peça assim: "Exclua a tag Evento 2024."
Notas: as pessoas continuam na comunidade; só a tag sai.
get_org_chart
Só consulta
Ver organograma. Quem responde a quem, com os grupos de cada pessoa. Papel mínimo: moderador.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
root_member | id de perfil ou e-mail | Não | Quem fica no topo |
group | nome ou id | Não | Desenha só esse grupo |
depth | número | Não | Quantos níveis descer |
Devolve: a árvore, pessoa por pessoa, com o gestor e os grupos.
Peça assim: "Mostre o organograma da área de Produto."
Ver Grupos e organograma.
set_manager
Altera
Definir a quem a pessoa responde. Diz quem é o gestor de uma pessoa no organograma, ou tira o gestor. Papel mínimo: moderador.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
member | id de perfil ou e-mail | Sim | A pessoa |
manager | id de perfil ou e-mail | Não | A quem ela responde |
no_manager | sim ou não | Não | true tira o gestor |
Devolve: a pessoa com o gestor novo.
Peça assim: "O Bruno passa a responder à Ana."
Notas: um ciclo (A responde a B, que responde a A) é recusado. O organograma não dá nenhuma permissão: quem pode o quê continua sendo o papel.
list_activity_logs
Só consulta
Registros de atividade. Quem fez o quê na comunidade, dos mais recentes para os mais antigos: a mesma linha do tempo da aba Membros › Logs. Papel mínimo: administrador (proprietário ou administrador).
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
source | team, assistant, members | Não | Equipe (as ações sobre assinaturas: cancelar, reativar, desconto, cortesia, extensão, adicional, link de pagamento), assistente (o que um assistente de IA fez pelo MCP, inclusive conexões autorizadas e desconectadas) ou membros (as ações que dão pontos no ranking). Sem ele, as três |
profile | id de perfil, e-mail ou link do app | Não | Só o que essa pessoa fez |
from, to | data ISO 8601 | Não | O período. Uma data sem hora em to vale o dia inteiro |
page, limit | números | Não | Até 100 por página |
Devolve: cada registro com quando, quem, a ação (no seu idioma), sobre o quê e os detalhes: o antes e depois de uma ação da equipe, o resultado de uma chamada do assistente (concluída, erro, recusada ou aguardando confirmação) ou os pontos de uma ação de membro. Os argumentos das chamadas do assistente vêm resumidos, sem códigos de confirmação nem imagens.
Peça assim: "Quem cancelou a assinatura da Ana?" · "O que o assistente fez ontem?" · "O que a [email protected] fez esta semana?"
Notas: se uma chamada do assistente falhou, a resposta sugere get_connection_diagnostics; com uma pessoa no filtro, sugere member_activity. Um perfil ou link de outra comunidade é recusado.