Organização e equipes

A organização é o espaço de trabalho principal no Almirant. Todos os projetos, membros, integrações e configurações pertencem a uma organização. Dentro da organização, você pode gerenciar equipes para organizar o trabalho de forma mais granular.

O que é uma organização

Uma organização no Almirant representa sua empresa, equipe ou grupo de trabalho. É o contêiner de nível superior que reúne:

• Projetos -- Todos os projetos criados pertencem a uma organização.
• Membros -- As pessoas que têm acesso à organização e aos seus projetos.
• Integrações -- As conexões com serviços externos (GitHub, Vercel, Telegram).
• Provedores de IA -- A configuração dos provedores e cotas de inteligência artificial.
• API Keys -- Os tokens de acesso para integrações externas e MCP.

Configurar a organização

Para acessar as configurações da sua organização:

1. Clique no nome da organização no menu lateral.
2. Selecione Configurações ou acesse diretamente em Settings.

Dados da organização

Campo	Descrição	Obrigatório
Nome	Nome da organização exibido em toda a plataforma	Sim
Logo	Imagem representativa da organização	Não
Slug	Identificador único na URL da organização	Sim

Para atualizar os dados:

1. Acesse Configurações > Geral.
2. Modifique os campos desejados.
3. Salve as alterações.

Gerenciar membros

Os membros são as pessoas que têm acesso à organização e podem trabalhar nos seus projetos.

Convidar membros

1. Acesse Configurações > Membros.
2. Clique em Convidar membro.
3. Informe o e-mail do novo membro.
4. Selecione o papel que ele terá na organização.
5. Envie o convite.

O membro receberá um e-mail com um link para entrar na organização. Se ele já tiver uma conta no Almirant, será adicionado diretamente. Caso contrário, deverá criar uma conta primeiro.

Papéis dos membros

O Almirant define papéis para controlar o nível de acesso de cada membro:

Papel	Permissões
Owner	Controle total sobre a organização. Pode gerenciar membros, configurações, faturamento e excluir a organização
Admin	Pode gerenciar membros, projetos, integrações e configurações. Não pode excluir a organização
Member	Pode trabalhar em projetos atribuídos, criar e editar work items, usar AI Planning e agentes

Princípio do menor privilégio

Atribua o papel mais restritivo que permita a cada membro realizar o trabalho. Reserve o papel de Owner para uma ou duas pessoas e Admin para team leads.

Ver membros ativos

A lista de membros mostra:

• Nome e e-mail de cada membro.
• Papel atribuído.
• Data de entrada.
• Status do convite (pendente, aceito).

Alterar o papel de um membro

1. Acesse Configurações > Membros.
2. Encontre o membro na lista.
3. Clique no seletor de papel.
4. Selecione o novo papel.
5. Confirme a alteração.

Remover um membro

1. Acesse Configurações > Membros.
2. Encontre o membro na lista.
3. Clique em Remover ou no ícone de remoção.
4. Confirme a remoção.

aviso

Remover um membro revoga imediatamente seu acesso. Os work items atribuídos ao membro manterão o histórico de atribuição, mas ele deixará de receber notificações. Reatribua os work items ativos antes de remover o membro.

Equipes

As equipes permitem agrupar membros em uma organização para facilitar a atribuição de trabalho e a comunicação.

Criar uma equipe

1. Acesse Configurações > Equipes.
2. Clique em Criar equipe.
3. Defina um nome para a equipe (por exemplo, "Frontend", "Backend", "QA").
4. Adicione membros à equipe selecionando-os na lista de membros da organização.
5. Salve a equipe.

Uso das equipes

As equipes são úteis para:

• Atribuição rápida -- Atribuir work items a uma equipe inteira em vez de a membros individuais.
• Filtragem -- Filtrar o board por equipe para ver apenas as tarefas de um grupo específico.
• Visibilidade -- Entender rapidamente quem faz parte de cada área funcional.

Transferir projetos entre organizações

Se você tiver acesso a várias organizações, poderá transferir projetos de uma para outra. Consulte a seção transferência de projetos para mais detalhes.

Para desenvolvedores

Ferramentas MCP

As seguintes tools estão disponíveis via MCP para gerenciar membros:

Tool	Descrição	Parâmetros principais
list_members	Lista os membros da organização	organizationId

Exemplo: listar membros

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

Retorna a lista de membros com nome, e-mail, papel e status.

Rotas da aplicação

Rota	Descrição
/settings	Configurações gerais da organização
/settings/members	Gerenciamento de membros
/settings/teams	Gerenciamento de equipes