Organização e acesso

Tudo o que diz quem entra na organização e o que cada pessoa pode fazer fica em Organização, na barra lateral do painel. Cada tela tem um comando equivalente na CLI e uma ferramenta no MCP, e os três seguem as mesmas regras: um comando roda com a permissão de quem chama, e um agente conectado pelo MCP faz o que você pode fazer, nada além.

Resumo

Permissões padrão

Toda organização tem quatro permissões prontas:

Leitura não recebe as credenciais dos bancos, não usa o editor SQL e não navega pelas linhas das tabelas. Quem precisa ler dados usa Membro, ou uma permissão personalizada com base member e database:query.

Para ver a lista completa de ações e o que cada permissão padrão tem:

veloz roles permissions

Membros e convites

No painel: Organização > Membros. Proprietários e administradores convidam, mudam permissões e removem membros. Só um proprietário dá ou tira a permissão de proprietário, e a organização sempre mantém pelo menos um.

# Ver quem está na organização e os convites pendentes
veloz members list
 
# Convidar com uma permissão (padrão: member)
veloz members invite ana@aurora.local --role admin
 
# Reenviar o e-mail de um convite pendente
veloz members invite ana@aurora.local --resend
 
# Cancelar um convite (ID do convite ou e-mail convidado)
veloz members cancel-invite ana@aurora.local
 
# Mudar a permissão de um membro
veloz members role bruno@aurora.local viewer
 
# Remover um membro
veloz members remove bruno@aurora.local

• --role aceita owner, admin, member, viewer ou o nome de uma permissão personalizada.
• O convite mostra o link de entrada e se o e-mail foi enviado, para você repassar o link se precisar.
• Mudar a permissão encerra as sessões da pessoa, para a nova permissão valer na hora.
• O remove pede confirmação no terminal. Por agentes de IA, ele exige a confirmação do usuário em userConfirmation.

No MCP: members_list, members_invite, members_cancel_invite, members_role e members_remove.

Times

No painel: Organização > Times. Um time junta pessoas para receber acesso a pastas de projetos e para entrar nas políticas de acesso por tabela. Qualquer membro vê os times; proprietários e administradores os gerenciam.

veloz teams list
veloz teams create Dados
veloz teams rename Dados "Dados e BI"
 
# Adicionar e tirar pessoas (o acesso muda na hora)
veloz teams add "Dados e BI" ana@aurora.local
veloz teams remove "Dados e BI" ana@aurora.local
 
# Excluir o time: quem estava nele perde o acesso que vinha do time
veloz teams delete "Dados e BI"

No MCP: teams_list, teams_create, teams_rename, teams_add, teams_remove e teams_delete.

Permissões personalizadas

No painel: Organização > Permissões. Uma permissão personalizada parte de uma base (admin, member ou viewer) e lista as ações que ela dá, no formato recurso:ação. Ela nunca passa da base: o que a lista pedir além do que a base tem fica de fora.

veloz roles list
 
# Uma permissão para quem analisa dados: lê tudo e consulta os bancos
veloz roles create analista-dados --base member \
  --permission project:read \
  --permission service:read \
  --permission database:read \
  --permission database:query \
  --description "Lê projetos e consulta os bancos"
 
# --permission substitui a lista inteira
veloz roles update analista-dados --permission project:read --permission database:read
 
veloz roles delete analista-dados

• O nome aceita letras minúsculas, números, - e _.
• Uma permissão com base admin conta como administrador para as pastas: vê todos os projetos.
• Só dá para excluir uma permissão que nenhum membro, convite, pasta ou política de banco usa.
• Para dar a permissão a alguém: veloz members role ana@aurora.local analista-dados.

No MCP: roles_list, roles_permissions, roles_create, roles_update e roles_delete.

Pastas de projetos

No painel: Organização > Pastas, para proprietários e administradores. Uma pasta agrupa projetos e diz quais times têm acesso a eles e com qual permissão.

Como o acesso é calculado:

• Proprietários e administradores veem todos os projetos, com ou sem pasta.
• Projeto fora de pasta: vale a permissão da pessoa na organização.
• Pasta aberta: vale a permissão na organização, somada ao que os times da pessoa recebem na pasta. O acesso de um time só acrescenta.
• Pasta restrita: só proprietários, administradores e os times com acesso veem os projetos dela, e vale só o que o time recebe, mesmo que seja menos que a permissão na organização. Quem não está em nenhum time com acesso não vê a pasta.
• Uma pessoa em vários times com acesso à mesma pasta recebe a soma dos acessos.

veloz folders list
veloz folders create Financeiro --description "Cobrança e notas" --restricted
 
# Definir a lista completa de projetos da pasta (nome, slug ou ID)
veloz folders projects Financeiro cobranca notas-fiscais
 
# Mover projetos sem mexer no resto da pasta, ou tirar de qualquer pasta
veloz folders move relatorios --to Financeiro
veloz folders move relatorios --none
 
# Dar ou mudar o acesso de um time, e tirar
veloz folders grant Financeiro "Dados e BI" viewer
veloz folders revoke Financeiro "Dados e BI"
 
veloz folders update Financeiro --no-restricted
 
# Excluir a pasta: os projetos ficam visíveis para toda a organização
veloz folders delete Financeiro

Um projeto fica em uma pasta só. O grant aceita admin, member, viewer ou uma permissão personalizada.

No MCP: folders_list, folders_create, folders_update, folders_projects, folders_move, folders_grant, folders_revoke e folders_delete.

Acesso por tabela nos bancos

Disponível para bancos PostgreSQL. No painel: Organização > Bancos mostra todos os bancos PostgreSQL da organização por pasta e projeto, com as políticas de cada um; a aba Acesso de cada banco cria e edita as políticas. Para proprietários e administradores.

Uma política de acesso diz quais tabelas uma permissão ou um time pode ler ou alterar:

• Quem se encaixa em alguma política recebe um login próprio no banco, limitado às tabelas que as suas políticas liberam, somadas.
• Quem não se encaixa em nenhuma política continua com o acesso que a sua permissão dá ao banco.
• Proprietários e administradores nunca são restringidos.
• Uma tabela nova fica fechada para quem está restrito até a próxima sincronização.

Cada regra (--rule) tem o formato schema.tabela=none|read|write, e * cobre todas as tabelas do schema.

# Visão geral: bancos, políticas e quem está restrito
veloz db policies overview
 
# Políticas de um banco
veloz db policies list pedidos-db --project loja
 
# Leitura em tudo do schema public, menos a tabela de clientes, para o time Suporte
veloz db policies create pedidos-db suporte-leitura --project loja \
  --rule "public.*=read" --rule "public.clientes=none" \
  --team Suporte
 
# O que uma pessoa pode fazer em cada tabela, e o que o banco libera agora
veloz db policies test pedidos-db ana@aurora.local --project loja --table public.clientes
 
# Cada lista (--rule, --role, --team) substitui a lista inteira
veloz db policies update pedidos-db suporte-leitura --project loja --role analista-dados
 
# Aplicar de novo depois de uma falha
veloz db policies sync pedidos-db --project loja
 
# Excluir: quem a política limitava volta ao acesso da sua permissão
veloz db policies delete pedidos-db suporte-leitura --project loja

O test diz se a pessoa está restrita, se é proprietário ou administrador, ou se nenhuma política a alcança, e mostra, tabela por tabela, o que as políticas dão e o que o banco libera agora.

No MCP: db_policies_overview, db_policies_list, db_policies_create, db_policies_update, db_policies_delete, db_policies_sync e db_policies_test.

Atividade

No painel: Organização > Atividade, para proprietários e administradores. É o registro de quem fez o quê na organização: deploys, variáveis, projetos e serviços, bancos, domínios, membros e acesso, e cobrança.

• A linha do tempo agrupa por dia e por pessoa, e junta em uma linha só as ações repetidas no mesmo alvo ("fez 12 deploys em api"), que abrem com um clique.
• Os filtros (pessoa, categoria, projeto, origem e período) ficam no endereço da página, para você compartilhar a mesma visão. O período padrão é dos últimos 30 dias.
• Membros ativos mostra quem mais agiu no período; clicar em alguém filtra só as ações da pessoa.
• Cada ação mostra a origem: Painel, CLI, MCP ou API.
• Variáveis de ambiente aparecem pelo nome, nunca pelo valor.

# As ações mais recentes
veloz audit list
 
# O que uma pessoa fez nas últimas 24 horas
veloz audit list --member bruno@aurora.local --since 24h
 
# Deploys de um projeto em um intervalo de datas
veloz audit list --category deploys --project loja --since 2026-10-01 --until 2026-10-15
 
# Só o que veio de agentes pelo MCP, em JSON
veloz audit list --source mcp --json

• --category aceita deploys, variaveis, projetos, bancos, dominios, acesso e cobranca.
• --action aceita nomes separados por vírgula; um prefixo como deploy pega todas as ações de deploy.
• --since e --until aceitam 30m, 24h, 7d ou uma data como 2026-10-01.
• --limit vai até 200 (padrão 50). Quando há mais ações, a saída mostra o comando da página seguinte, com os mesmos filtros e o --cursor.

No MCP: audit_list, uma ferramenta só de leitura. É o caminho para um agente responder "quem mudou isso?" ou "quem fez o último deploy em api?".

Site e ícone

No painel: Organização > Geral, para proprietários e administradores. Com o site da organização definido, a Veloz busca o ícone do site e o mostra no lugar do ícone padrão: no seletor de organizações, na barra lateral e na página da organização.

veloz orgs update --website example.com
 
# Remover o site e o ícone
veloz orgs update --website ""

• O site fica guardado como https:// e o domínio; caminhos são ignorados.
• Endereços que não são públicos, como um IP ou localhost, são recusados.
• O ícone aparece em alguns instantes; veloz orgs list mostra o site e o ícone.

No MCP: orgs_update.

Próximos passos

• CLI Reference, todos os comandos
• MCP & Agentes IA, para conectar um agente à sua organização
• Segurança, como a Veloz protege seus dados
• Bancos de dados, credenciais, editor SQL e backups