Como funciona a ArduMaker

O que faz cada ferramenta, o que muda no seu servidor e como verificar. Escrita a partir do código, para pessoas e agentes de IA.

Para agentes de IA

Cada documento existe também em Markdown, e o índice completo está em llms.txt. A referência de ferramentas MCP com os seus parâmetros está em /mcp/docs.

Referência MCP · llms.txt

Servidores e infraestrutura

VPS Linux com root, deploys, contêineres, bases de dados, rede e tudo o que corre no seu servidor.

  • Servidores VPS: Servidor Linux Ubuntu próprio com root, recursos do plano e controle total pelo painel ou via MCP.
  • Terminal web: Console do VPS no navegador que continua viva mesmo se você desconectar: tmux dentro do servidor, com permissões por usuário.
  • Docker: Daemon do Docker no VPS e apps como projetos Compose: imagem, registro privado, repo ou Compose, com HTTPS opcional.
  • Deploy do GitHub: Clona, faz o build e publica um repo do GitHub no VPS; deploy a cada push, histórico por fases e rollback.
  • n8n: n8n em modo fila sobre Docker, com workers, task runners, PostgreSQL e Redis próprios, HTTPS e atualizações com backup.
  • WordPress: Sites WordPress nativos com PHP-FPM e MySQL próprios, HTTPS, backups, staging, migração e edição completa via MCP.
  • WooCommerce: Loja WooCommerce no seu WordPress: produtos, pedidos, clientes, frete, impostos e relatórios, também via MCP.
  • Elementor: Editor visual Elementor no seu WordPress: páginas, modelos e estilos globais editáveis elemento por elemento via MCP.
  • PostgreSQL: Bancos PostgreSQL no VPS com usuário próprio de privilégio mínimo, TLS e acesso externo limitado por lista de IP.
  • MySQL: Bancos MySQL 8 ou MariaDB no VPS com conta própria que exige TLS, permissões só no seu banco e acesso externo por IP.
  • Redis: Redis nativo, um por VPS, com usuário ACL próprio, persistência RDB, TLS e acesso externo limitado por lista de IP.
  • Gerenciador de bancos de dados: Explore e edite PostgreSQL e MySQL do VPS pelo painel ou via MCP, por túnel privado, com proteções e auditoria.
  • Nginx: Proxy reverso em duas camadas: TLS no host e server blocks por domínio dentro do VPS, com teste e reversão automática.
  • Certificados SSL: HTTPS para cada domínio do VPS: curinga da zona da ArduMaker ou Let's Encrypt emitido ao ativar o domínio.
  • Domínios e DNS: Zonas DNS da empresa no Cloudflare, registros com proteções para MX, NS e apex, e subdomínios da zona da ArduMaker.
  • Firewall e portas: Redirecionamentos de porta do VPS, SSH com vencimento e listas de IP permitidos ou excluídos no firewall do host.
  • Serviços systemd: Criar, editar, controlar e apagar serviços systemd em um VPS, com reversão se não arrancarem e logs do journal.
  • Tarefas agendadas: Comandos com horário no VPS através de um serviço e um timer do systemd, com atalhos de minutos, execução manual e logs.
  • Cópias de segurança: Cópia completa e semanal de cada VPS sem o desligar, com 4 guardadas, cópia à mão e transferência com link de 72 horas.
  • Túneis SSH: Túnel SSH persistente entre dois VPS com autossh: um serviço do receptor fica no localhost do iniciador sem ser exposto.
  • Monitoramento: Estado do VPS medido pelo seu agente, logs de nginx, systemd e tarefas, rede em tempo real e uptime de 30 dias na página de estado.
  • Usuários Linux: Usuários do sistema no VPS com home privado, sudo opcional, mudança de senha forçada e exclusão com confirmação.

Inteligência artificial e agentes

O servidor MCP, as suas permissões e os serviços de IA: router de modelos, pesquisa e revisão de código.

  • Servidor MCP: Servidor MCP com OAuth e aprovação humana para que agentes de IA operem a ArduMaker, com perfis, repetições seguras e limites.
  • Permissões do agente MCP: O que pode fazer um agente MCP: permissões do seu humano, alcance por projeto e VPS, só leitura e operações sempre proibidas.
  • Router IA: Chaves OpenRouter em nome da empresa, com consumo cobrado do saldo da ArduMaker e pausa automática por saldo negativo.
  • Search API: API de pesquisa web para apps e agentes: search, extract, crawl, map e pedidos em paralelo, cobrados do saldo da empresa.
  • Chaves de IA: Criar chaves do Router IA com teto de gasto, token visível uma única vez, limites para empresas novas, revogação e reativação.
  • Code checker: Binário `ardumaker check`: regras do padrão da ArduMaker sobre o repositório, hooks de Git e saída JSON para CI e agentes de IA.
  • Auditoria de agentes: Registro de cada chamada de um agente MCP com o resultado, operações em curso e histórico de comandos, sem salvar valores.

Projetos e empresas

O espaço de cada empresa: projetos, etapas, tarefas, arquivos, permissões e assinaturas.

  • Empresas: O contêiner de equipe e faturamento: admins, membros, projetos associados e baixa reversível durante 30 dias.
  • Projetos e quadro kanban: Projetos com etapas e tarefas em um quadro de seis colunas, avanço calculado e apagamento reversível.
  • Etapas: Fases que agrupam tarefas, com ordem, dependências, coluna no quadro e avanço médio.
  • Tarefas: Tarefas com responsável, horas, datas, prioridade e comentários, que se agendam sozinhas no horário do responsável.
  • Checklists: Passos dentro de uma tarefa que calculam o avanço sozinhos e podem citar anexos do projeto.
  • Dependências: Que etapa ou tarefa espera por qual: sem ciclos, ordenam o quadro e fixam a partir de que dia se agenda uma tarefa.
  • Calendário de projeto: O cronograma do projeto com cada tarefa no horário real do responsável e as reuniões da equipe.
  • Anexos: Links, arquivos e notas do projeto em pastas, com comentários, anexos secretos e transferências autenticadas.
  • Notas e especificações: Notas de texto do projeto para specs, decisões e acessos, com arquivos associados e leitura via MCP.
  • Modelos de projeto: O molde de uma empresa para os seus projetos: funções, regulamentos, pastas e notas copiados ao criar cada um.
  • Funções e permissões: Funções por projeto com cinco níveis em catorze seções, que recortam o acesso sem nunca acrescentar permissões.
  • Auditoria de ações: O histórico de cada projeto: quem criou, editou, apagou, restaurou ou purgou o quê e quando, pessoas e agentes MCP.
  • Assinatura de documentos: Regulamentos de projeto e documentos assinados com nome e rubrica, com versões imutáveis e PDF verificável.
  • Gestão económica: Orçamento, acordos, cobranças, pagamentos e despesas do projeto, com cada pessoa a ver só o que a sua função abre.

Reuniões e produtividade

Agenda, reuniões com o Google, gravações, transcrições e resumos.

  • Links para agendar: Um link público para que qualquer pessoa reserve um horário livre na sua agenda ou na de um projeto, com Meet e avisos.
  • Google Calendar: Sincronização nos dois sentidos com o Google Calendar: eventos que reduzem a disponibilidade e tarefas que aparecem no seu calendário.
  • Google Meet: Um link do Google Meet gerado ao criar eventos, reuniões de projeto ou reservas, compartilhado por todos os participantes.
  • Disponibilidade compartilhada: Cruza a disponibilidade real de várias pessoas para encontrar um horário comum, sem mostrar o que ocupa a agenda de ninguém.
  • Gravação de reuniões: Grave reuniões a partir do Chrome e guarde-as no perfil ou em um projeto, com permissões, cortes e apagamento a 30 dias.
  • Transcrição: Transcrição de reuniões gravadas por janelas de um minuto, com pesquisa, correções e exportação.
  • Resumos com IA: Rascunho de cada reunião com resumo, decisões, requisitos e possíveis tarefas, cada ponto com o seu minuto.
  • Acordos para tarefas: Converte uma possível tarefa do resumo de uma reunião em uma tarefa do projeto, ligada ao minuto em que foi dita.

Comunicação

Email profissional, webmail, API de email e WhatsApp Business.

  • Email profissional: Caixas de correio com o domínio da sua empresa, com DNS guiado (MX, SPF, DKIM, DMARC) e um plano por caixa.
  • Webmail: Ler, enviar e organizar o email de uma caixa no navegador, com pastas, filtros e aliases.
  • SMTP e IMAP: Usar as caixas da ArduMaker em qualquer cliente de email via IMAP (993) e SMTP (587).
  • API de email: Enviar e ler email a partir de um programa com uma chave `am_`, através de uma fila com turnos por empresa.
  • Aliases de email: Endereços extra que reencaminham para uma caixa, aliases temporários e reencaminhamentos ao nível do domínio.
  • Contas bot: Endereços de email para programas, com caixa real e token próprio, usados com a API de email.
  • WhatsApp Business API: Enviar e receber WhatsApp a partir dos números da empresa, com sandbox de testes e transcrição de áudios.
  • Webhooks de WhatsApp: Reencaminhar as mensagens e estados do WhatsApp para um URL próprio, de imediato, com espera ou por intervalos.
  • Histórico de chats: As conversas de WhatsApp de cada número, com mensagens, arquivos, estados e transcrições.

Pagamentos e administração

Saldo, recargas, faturamento, planos, membros, sessões e avisos.

  • Saldo por empresa: Cada empresa tem um saldo próprio, soma dos seus movimentos, com cobrança automática e uma margem negativa autorizada.
  • Recargas de saldo: Carregar saldo na empresa com o seu meio de pagamento: cobra-se primeiro e só se correr bem é somado ao saldo.
  • Recarga automática: Uma regra por empresa: se o saldo descer abaixo de um mínimo, cobra-se um montante fixo ao meio de pagamento.
  • Faturamento: Dados fiscais da empresa, histórico de movimentos e faturas em PDF dos pagamentos.
  • Consumo de serviços: Que serviços a empresa tem contratados, a que preço, o que consome por uso e como pagar meses antecipadamente.
  • Planos de VPS: Os planos que definem CPU, RAM e disco de cada VPS, quem os pode escolher e como se muda de plano.
  • Gestão de membros: Adicionar pessoas à empresa, dar-lhes papel de admin ou membro e removê-las, com regras que protegem a conta.
  • Sessões e dispositivos: Uma sessão por dispositivo, com o seu IP, fecho individual ou em massa, bloqueio de IPs e autorização do CLI com código.
  • Notificações: Os emails da plataforma por categoria: quem os recebe, com que frequência e como se escolhem ou desligam.

Comunidade e serviços adicionais

Perfis, blog, programas para criadores, escolas e o resto da conta.

  • Perfis públicos: Uma página pública por pessoa com a sua atividade na ArduMaker, integrações e blogs.
  • Blog pessoal: Escrever e publicar artigos por seções, com arquivos e tradução para espanhol, inglês e português.
  • Programa de criadores: Para quem recomenda a ArduMaker: candidatura, link de referência, comissão mensal, cashback para referidos e serviços grátis.
  • Programa de embaixadores: A categoria do programa de colaboradores com mais benefícios: maior comissão, mais serviços grátis e mais crédito de consumo.
  • Escolas: Programa para instituições de ensino: planos acordados para alunos, links de convite, carteira e comissão.
  • Desenvolvimento sob medida: Serviço comercial da ArduMaker para construir software sob medida dentro da empresa do cliente.
  • Autenticação externa: Entrar e ligar a conta com Google, GitHub ou 42, com regras claras para juntar ou mover contas.
  • Lixo: O que é apagado em um projeto ou em uma empresa pode ser restaurado durante 30 dias antes de ser eliminado de vez.