# Gestão de membros

Adicionar pessoas à empresa, dar-lhes papel de admin ou membro e removê-las, com regras que protegem a conta.

Fonte: https://ardumaker.com/pt/docs/gestion-de-miembros/

- 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 `admin` e `member`.
- 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](https://ardumaker.com/pt/docs/notificaciones).

## 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](https://ardumaker.com/pt/mcp/docs).

| Tipo | Ferramentas |
| --- | --- |
| Leitura | `listar_empresas`, `ver_empresa` |

## Funcionalidades relacionadas

- [Empresas](https://ardumaker.com/pt/docs/empresas/)
- [Funções e permissões](https://ardumaker.com/pt/docs/roles-y-permisos/)
- [Saldo por empresa](https://ardumaker.com/pt/docs/saldo-por-empresa/)
- [Notificações](https://ardumaker.com/pt/docs/notificaciones/)