Empresas

O contêiner de equipe e faturamento: admins, membros, projetos associados e baixa reversível durante 30 dias.

Categoria: Projetos e empresas
Estado: Disponível
Requisitos: Uma conta ArduMaker com sessão iniciada; Para gerenciar membros: ser admin da empresa
Ferramentas MCP (Só leem): listar_empresas, ver_empresa, ver_estado_verificacion_empresa, listar_servicios_empresa, ver_consumo_periodo_empresa

O que permite fazer?

A empresa é o contêiner de tudo o que se contrata e paga na ArduMaker: VPS, domínios, correio, chaves de IA e projetos associados. Cada empresa tem admins e membros.

Criar uma empresa: quem a cria fica como membro e como admin.
Adicionar pessoas pelo nome de usuário, como membro ou como admin.
Promover ou rebaixar alguém entre admin e member.
Remover membros, ou sair da empresa.
Dar de baixa a empresa e restaurá-la a partir da lixeira durante 30 dias.

Quando convém usar?

Para separar a faturamento de clientes ou negócios diferentes.
Para dar acesso a uma equipe aos projetos associados a essa empresa.
Para que um agente MCP descubra o company_id que outras ferramentas pedem.

Como funciona na ArduMaker?

Ao criá-la, a ArduMaker valida o nome, adiciona quem a cria como membro e admin, e registra-a como cliente no processador de pagamentos. Tudo acontece em uma só transação: se o registro de pagamentos falhar, não fica uma empresa criada a meio.
Todo o admin é também membro: se alguém que não era membro for nomeado admin, é adicionado aos membros.
Só um admin adiciona pessoas, muda funções ou remove outros. Qualquer membro pode sair por conta própria.
A empresa nunca fica sem admin: rebaixar ou remover o último admin é rejeitado.

As empresas apagadas não são listadas, com uma exceção: as que foram dadas de baixa por falta de pagamento continuam visíveis para que o dono possa entrar e pagar.

O que muda realmente?

Criar: uma empresa nova com o criador como admin e o seu cliente no processador de pagamentos.
Associar a empresa a um projeto dá acesso a esse projeto aos seus membros (nível aportar) e aos seus admins.
Dar de baixa: primeiro tenta-se cobrar a dívida pendente; a empresa é marcada como apagada e fica 30 dias na lixeira. Os VPS que tinha são eliminados de verdade e não voltam ao restaurá-la.

Esquema

Pessoa: pede para criar a empresa
Validação: nome e dívidas noutras empresas
Empresa: criador como membro e admin
Processador de pagamentos: registro do cliente, na mesma transação

Criação de uma empresa

Resultado esperado

A empresa aparece na lista de quem a criou e dos seus membros, e fica disponível para associar a projetos e contratar serviços.

Erros e resolução

Mensagem	Causa
`name is required`	Tentou-se criar sem nome.
`Cannot create a new company while having 2 or more companies with pending debts`	A pessoa tem duas ou mais empresas com dívida acima do autorizado. Uma só não bloqueia.
`Only admins can add members`	Quem tenta adicionar alguém não é admin.
`At least one admin is required`	Tentou-se remover ou rebaixar o último admin.
`Cannot remove members while company has pending debts`	A empresa deve mais do que o autorizado.
`Company has pending debts and cannot be deleted`	A cobrança prévia à baixa não cobriu a dívida.

Relação com MCP

Um agente MCP vê as empresas da pessoa que o autorizou, com campos de resumo. Todas as ferramentas são só de leitura: um agente não cria empresas, não adiciona membros nem dá baixa de nada.

listar_empresas: id, nome, estado e função da pessoa em cada uma.
ver_empresa: perfil, admins e membros, sem dados de cobrança.
ver_estado_verificacion_empresa: se a empresa está verificada, sem os dados fiscais.
listar_servicios_empresa e ver_consumo_periodo_empresa: serviços ativos e movimentos de saldo.

Referência completa de cada ferramenta: /mcp/docs.