Gestão de membros
Adicionar pessoas à empresa, dar-lhes papel de admin ou membro e removê-las, com regras que protegem a conta.
- Categoria: Pagamentos e administração
- Estado: Disponível
- Requisitos: Ser admin da empresa para adicionar, mudar papéis ou remover outros; A pessoa já tem de ter conta na ArduMaker
- Ferramentas MCP (Só leem):
ver_empresa,listar_empresas
O que permite fazer?
| Papel | O que pode |
|---|---|
| Admin | Tudo o que um membro pode, mais gerenciar pessoas, pagamentos, dados fiscais e regras da empresa. |
| Membro | Usar os recursos da empresa e ver o saldo e o consumo. |
Quando convém usar?
Ao montar a equipe da empresa, ao delegar a administração ou quando alguém deixa de trabalhar nela.
Como funciona na ArduMaker?
- Um admin adiciona uma pessoa pelo nome de usuário, como membro ou diretamente como admin.
- Um admin muda o papel entre
adminemember. - Um admin remove outra pessoa; qualquer pessoa pode sair sozinha sem pedir autorização.
- Fica sempre pelo menos um admin: o último não pode ser despromovido nem removido.
- Com a empresa em dívida acima do autorizado, não se pode remover pessoas: primeiro paga-se.
O que muda realmente?
Muda quem pertence à empresa e com que papel. Um admin conta sempre também como membro. Quem sai perde o acesso aos recursos da empresa.
Resultado esperado
A lista da empresa mostra admins e membros sem repetir ninguém. Os avisos de faturamento chegam aos admins e aos membros que um admin adicione a essa categoria nas notificações.
Erros e resolução
- `user_not_found`: não há conta com esse nome de usuário.
- `at_least_one_admin_is_required`: tentou-se deixar a empresa sem admins.
- `cannot_remove_members_while_company_has`: a empresa tem dívida pendente.
- 403 `only_admins_can_...`: a ação é só para admins.
Relação com MCP
Um agente pode ver as empresas e quem são os admins e membros, mas não pode adicionar, remover nem mudar papéis. Ver /mcp/docs.
| Tipo | Ferramentas |
|---|---|
| Leitura | listar_empresas, ver_empresa |