Bancos de dados da empresa

Conecte ferramentas internas ao banco de dados da empresa

Seus pedidos, clientes e estoque já estão em um banco de dados. Agora as ferramentas que sua equipe cria com IA podem trabalhar com esses dados ao vivo, atrás do login da sua empresa, sem copiar nada para uma planilha antes.

Resposta rápida

Um admin conecta o banco de dados uma vez com npx teamonly db add. Cada app que precisa dele adiciona uma linha ao teamonly.json. Postgres e MySQL funcionam, na nuvem ou dentro da sua rede, sem portas abertas. No plano Team e acima, e no teste grátis.

Plano Team e acima, e no teste grátis de 14 diasÚltima atualização

01Dois tipos

Onde está seu banco de dados?

Nos dois casos é um comando, e a senha vai direto para a Cloudflare. O TeamOnly não guarda a senha.

A

Na nuvem

Acessível pela internet, com SSL ativado. Supabase, Neon, Amazon RDS e Aurora, Google Cloud SQL, Azure Database, PlanetScale para MySQL, ou seu próprio servidor com endereço público.

npx teamonly db add crm --url postgres://reader@db.acme.com:5432/crm

A senha é pedida na hora. Ela não aparece na tela e não fica salva no seu computador.

B

Dentro da sua rede

Sem endereço público: um servidor no escritório, um banco de dados em uma rede privada na nuvem, uma máquina num armário. Um pequeno conector da Cloudflare roda em qualquer máquina que consiga alcançar o banco. O banco de dados precisa estar com SSL ativado. Um certificado autoassinado serve.

npx teamonly db tunnel

Ele mostra um comando para rodar nessa máquina. O conector só faz uma conexão de saída: sem portas abertas, sem mudanças no firewall, sem VPN.

02Passo a passo

Como conectar um banco de dados

Um admin faz os passos 1 e 2 uma vez. Depois disso, qualquer criador pode usar a conexão em um app.

  1. Use um usuário de banco só de leitura

    Peça a quem cuida do banco de dados um usuário que consiga ler as tabelas que seus apps precisam, e nada mais. Use um usuário que pode gravar só para um app que precisa mudar dados.

  2. Conecte (só admins)

    Na nuvem: npx teamonly db add crm --url postgres://reader@db.acme.com:5432/crm. Dentro da sua rede: rode npx teamonly db tunnel, rode o comando que ele mostra em uma máquina dentro da rede (por exemplo sudo cloudflared service install TOKEN, ou a linha de Docker que ele mostra), depois npx teamonly db add warehouse --private --host 10.0.4.12 --database wh --user reader. O TeamOnly verifica se consegue entrar antes de salvar a conexão. Ou use o painel: página Empresa (Company), “Bancos de dados da empresa” (Company databases), “Conectar um banco de dados” (Connect a database).

  3. Ative para um app

    Adicione "connections": ["warehouse"] ao teamonly.json do app e rode npx teamonly deploy. Apps que não listam uma conexão não conseguem alcançá-la.

  4. Use no código

    Na API do app, c.var.ctx.connection('warehouse').connectionString vai para o pacote postgres ou pg (mysql2 para MySQL). No seu computador, coloque WAREHOUSE_URL em .dev.vars apontando para uma cópia de teste.

Terminal~/orders-dashboard
npx teamonly db tunnelThe tunnel is ready. Start it on a machine inside your network that can reach the database:  Always on (Linux or Mac service): sudo cloudflared service install eyJh...It only makes an outgoing connection to Cloudflare: no open ports, no firewall changes.npx teamonly db add warehouse --private --host 10.0.4.12 --database wh --user readerDatabase password (not shown, not stored by TeamOnly):Connected "warehouse" (postgres reader@10.0.4.12/wh). The password went to Cloudflare Hyperdrive; TeamOnly does not keep it.npx teamonly deployConnected to the company database "warehouse" (c.var.ctx.connection('warehouse') in the API)Live at https://orders-dashboard.acme.teamonly.app

03O código

Como fica no app

Uma linha nas configurações do app e uma consulta normal na API. Sua ferramenta de IA escreve essa parte.

teamonly.json
{
  "name": "orders-dashboard",
  "connections": ["warehouse"]
}
.dev.vars (só no seu computador)
WAREHOUSE_URL=postgres://reader:test@localhost:5432/wh

As consultas saem do app pelo Cloudflare Hyperdrive, que mantém um conjunto de conexões perto do seu banco de dados. Use o postgres 3.4.5 ou mais recente.

src/worker/index.ts
import { Hono } from 'hono';
import postgres from 'postgres';
import { teamonly, type TeamOnly } from 'teamonly/server';

const app = new Hono<TeamOnly>();
app.use('*', teamonly());

app.get('/api/orders', async (c) => {
  const sql = postgres(c.var.ctx.connection('warehouse').connectionString, {
    max: 5,
    fetch_types: false,
  });
  const rows = await sql`
    select id, customer, total, status
    from orders
    where status = 'open'
    order by created_at desc
    limit 100`;
  return c.json(rows);
});

export default app;

04Peça à sua ferramenta de IA

O que digitar

Diga o nome da conexão e das tabelas. Sua ferramenta de IA faz o resto.

  • Um painel com dados ao vivo

    “Claude, crie um painel com a tabela orders do nosso warehouse; use a conexão warehouse. Mostre os pedidos por dia nos últimos 30 dias, os 20 maiores clientes e uma tabela com busca dos pedidos em aberto.”

  • Uma consulta para a equipe de suporte

    “Crie uma consulta de clientes na conexão crm. Busca por nome, e-mail ou número da conta, e mostre os pedidos recentes do cliente. Só leitura: sem edições.”

  • Anotações ao lado dos dados da empresa

    “Mantenha o warehouse só de leitura. Deixe as pessoas adicionarem anotações e marcações a um pedido, e salve isso no banco de dados do próprio app, com quem escreveu.”

05Para TI

O que a TI vê e controla

  • Só admins adicionam conexões

    Uma conexão dá aos apps acesso ao vivo, então só os admins da empresa podem adicionar ou remover uma. Os criadores podem usar uma conexão, não criar.

  • Quais apps usam qual banco de dados

    O painel lista cada conexão e os apps que a usam. A página de cada app lista os bancos de dados da empresa que ele alcança. Uma conexão não pode ser removida enquanto algum app ainda a usa.

  • O TeamOnly nunca guarda a senha

    Ela vai direto para o Cloudflare Hyperdrive. O TeamOnly guarda o nome, o host, o banco de dados e o usuário, nunca a senha, e nunca os seus dados.

  • O banco de dados decide o que os apps podem fazer

    Os apps podem fazer exatamente o que o usuário do banco pode fazer. Um usuário só de leitura significa apps só de leitura, diga o código o que disser.

  • Nenhum acesso de entrada à sua rede

    Para um banco de dados privado, o conector liga para fora, para a Cloudflare. Nada novo fica escutando na sua rede, e você corta tudo parando esse único serviço.

  • Continua atrás do login da empresa

    Cada requisição a um app é verificada primeiro contra o login da sua empresa, e cada app só alcança as conexões que lista.

06Comparado

Qual a diferença para o Retool?

No Retool você adiciona seu banco de dados como um “resource” e monta telas sobre ele no editor do Retool. Seu firewall precisa deixar o Retool alcançar o banco, e um banco em rede privada é alcançado por um túnel SSH até um bastion host que você mantém. O plano Team do Retool cobra por cada pessoa que abre um app: $10 por mês por criador e $5 por usuário interno, com cobrança anual. No TeamOnly o app é código comum que sua ferramenta de IA escreve, um banco de dados privado se conecta com um conector só de saída, e quem só usa os apps não paga.

Verificado em 27 de outubro de 2026. Fontes: Retool: Connect to PostgreSQL, Retool: SSH tunnels, preços do Retool. Mais opções comparadas: alternativas ao Retool.

07FAQ

Perguntas frequentes

Todas as perguntas e respostas

Funciona com MySQL?

Sim. Postgres e MySQL funcionam, incluindo o PlanetScale para MySQL. Use --url mysql://... ao adicionar, e o pacote mysql2 no app.

Consigo conectar o Supabase?

Sim. O Supabase é Postgres. Adicione com a string de conexão do painel do Supabase, usando um usuário de banco com só o acesso que seus apps precisam. O app continua usando o login da empresa, não o login do Supabase.

Nossos dados passam pelos servidores do TeamOnly?

Não. As consultas saem do código do app, que roda na Cloudflare, pelo Cloudflare Hyperdrive até o seu banco de dados. O TeamOnly guarda só os detalhes da conexão (nome, host, banco de dados, usuário). Não guarda a senha nem os seus dados.

Os apps podem gravar no banco de dados?

Sim, se o usuário do banco puder. Recomendamos um usuário só de leitura para a maioria dos apps, e um usuário separado que só possa gravar nas tabelas que um app precisa mudar.

É seguro rodar o conector dentro da nossa rede?

Ele é o cloudflared, o conector da própria Cloudflare. Ele só faz uma conexão de saída para a Cloudflare, então você não abre portas nem muda regras de firewall. Só os apps que listam a conexão conseguem alcançar o banco de dados por ele, e só depois do login da empresa. Mantenha o token dele em sigilo e pare o serviço para cortar o acesso.

Quanto custa?

Os bancos de dados da empresa fazem parte do plano Team ($249 por mês para criadores e apps ilimitados) e do Business, e você pode experimentar no teste grátis de 14 dias. Não há cobrança por conexão nem por pessoa que usa os apps. Eles não estão no plano Builder.

Acesso antecipado

Coloque sua primeira ferramenta no ar esta semana.

O TeamOnly está em acesso antecipado, e todos os planos já estão abertos. Compartilhe um app com até 5 pessoas de graça, teste o Builder grátis por 14 dias, ou assine. Em qualquer caso, sua empresa fica pronta na hora, e três comandos colocam seu primeiro app no ar.

Comece grátisOu assine agora

Sem cartão no plano Free nem no teste. Planos pagos a partir de $19 por mês, cancele quando quiser.

Ainda não? Receba novidades

Use seu e-mail corporativo. Escrevemos pouco, e só quando há novidade que valha a pena.

Dúvidas vão para hello@teamonly.dev, e uma pessoa responde.