Empresas

El contenedor de equipo y facturación: admins, miembros, proyectos asociados y baja reversible por 30 días.

Categoría: Proyectos y empresas
Estado: Disponible
Requisitos: Una cuenta de ArduMaker con sesión iniciada; Para gestionar miembros: ser admin de la empresa
Herramientas MCP (Solo leen): listar_empresas, ver_empresa, ver_estado_verificacion_empresa, listar_servicios_empresa, ver_consumo_periodo_empresa

¿Qué permite hacer?

La empresa es el contenedor de todo lo que se contrata y se paga en ArduMaker: VPS, dominios, correo, claves de IA y proyectos asociados. Cada empresa tiene admins y miembros.

Crear una empresa: quien la crea queda como miembro y como admin.
Sumar personas por nombre de usuario, como miembro o como admin.
Subir o bajar a alguien entre admin y member.
Quitar miembros, o salir uno mismo de la empresa.
Dar de baja la empresa y restaurarla desde la papelera durante 30 días.

¿Cuándo conviene usarlo?

Para separar la facturación de clientes o de negocios distintos.
Para dar acceso a un equipo a los proyectos asociados a esa empresa.
Para que un agente MCP descubra el company_id que piden otras herramientas.

¿Cómo funciona en ArduMaker?

Al crearla, ArduMaker valida el nombre, agrega a quien la crea como miembro y admin, y la da de alta como cliente en el procesador de pagos. Todo ocurre en una sola transacción: si el alta de pagos falla, no queda una empresa a medio crear.
Todo admin es también miembro: si se nombra admin a alguien que no era miembro, se lo agrega a los miembros.
Solo un admin suma gente, cambia roles o quita a otros. Cualquier miembro puede salir por su cuenta.
La empresa nunca se queda sin admin: bajar o quitar al último admin se rechaza.

Las empresas borradas no se listan, con una excepción: las que se dieron de baja por falta de pago siguen visibles para que su dueño pueda entrar a pagar.

¿Qué cambia realmente?

Crear: una empresa nueva con su creador como admin y su cliente en el procesador de pagos.
Asociar la empresa a un proyecto da acceso a ese proyecto a sus miembros (nivel aportar) y a sus admins.
Dar de baja: primero se intenta cobrar la deuda pendiente; la empresa se marca como borrada y queda 30 días en la papelera. Los VPS que tenía se eliminan de verdad y no vuelven al restaurarla.

Esquema

Persona: pide crear la empresa
Validación: nombre y deudas en otras empresas
Empresa: creador como miembro y admin
Procesador de pagos: alta del cliente, en la misma transacción

Alta de una empresa

Resultado esperado

La empresa aparece en el listado de quien la creó y de sus miembros, y queda disponible para asociarla a proyectos y contratar servicios.

Errores y resolución

Mensaje	Causa
`name is required`	Se intentó crear sin nombre.
`Cannot create a new company while having 2 or more companies with pending debts`	La persona tiene dos o más empresas con deuda por encima de lo autorizado. Una sola no frena.
`Only admins can add members`	Quien intenta sumar a alguien no es admin.
`At least one admin is required`	Se intentó quitar o bajar al último admin.
`Cannot remove members while company has pending debts`	La empresa debe más de lo autorizado.
`Company has pending debts and cannot be deleted`	El cobro previo a la baja no cubrió la deuda.

Relación con MCP

Un agente MCP ve las empresas de la persona que lo autorizó, con campos de resumen. Todas las herramientas son de solo lectura: un agente no crea empresas, no suma miembros ni da de baja nada.

listar_empresas: id, nombre, estado y rol de la persona en cada una.
ver_empresa: perfil, admins y miembros, sin datos de cobro.
ver_estado_verificacion_empresa: si la empresa está verificada, sin los datos fiscales.
listar_servicios_empresa y ver_consumo_periodo_empresa: servicios activos y movimientos de saldo.

Referencia completa de cada herramienta: /mcp/docs.