Conectar Supabase

Este guia conduz você por toda a jornada completa: preparar uma conta e um projeto no Supabase, autorizar a organização correta, conectar o projeto, verificar se a conexão funcionou e desconectá-lo quando necessário.

Como a conexão funciona

Cada projeto do Supabase pertence a uma organização, que controla quem pode acessar e gerenciar os projetos dentro dela. Quando você conecta o Supabase ao Atoms, primeiro autoriza o Atoms a acessar a organização que deseja usar e, em seguida, seleciona um projeto dessa organização para conectar.

Cada projeto Atoms pode ser conectado a um projeto Supabase por vez. No entanto, o mesmo projeto Supabase pode ser conectado a mais de um projeto Atoms.

Supabase e Atoms Cloud são opções alternativas de backend. Você não pode conectar ambos ao mesmo projeto Atoms ao mesmo tempo.

Antes de começar

Antes de conectar o Supabase, certifique-se de que:

• Você é o proprietário do Espaço de Trabalho do Atoms que contém o projeto. Somente o proprietário do espaço de trabalho pode autorizar, conectar ou desconectar o Supabase.
• Você tem uma conta Supabase ou está pronto para criar uma durante a configuração.
• Você tem permissão para autorizar a organização do Supabase e acessar o projeto com o qual deseja se conectar.
• O Agente terminou sua tarefa atual e o Modo Corrida está desativado.
• Seu navegador permite janelas pop-up do Atoms.
• Seu projeto Atoms ainda não está conectado ao Atoms Cloud.

Se você estiver tentando essa conexão pela primeira vez, considere usar um projeto de teste enquanto aprende o processo.

Nunca cole uma senha do Supabase, chave de API, token de acesso ou outra credencial no Chat.

Conectar Supabase

Abra o conector do Supabase

1. Abra o projeto que deseja conectar.
2. Clique no nome do projeto, no canto superior direito do painel de chat.
3. Selecione Connectors no menu suspenso que aparece.
4. Encontre Supabase na lista de conectores disponíveis e clique em connect.

Você também pode abrir Settings → Connectors → Supabase e selecionar Connect.

Abra Settings → Connectors e selecione Connect para Supabase.

Autorizar o Atoms no Supabase

Se Organizations já mostrar a organização do Supabase que você deseja usar, ela já foi autorizada. Você pode continuar em Escolher o projeto Supabase.

1. O Atoms abre uma janela de autorização do Supabase. Entre na conta Supabase à qual deseja se conectar ou crie uma nova conta, se necessário.
2. Verifique se você entrou na conta Supabase correta e, em seguida, selecione a organização à qual deseja dar acesso ao Atoms.
3. Revise as permissões solicitadas pelo Atoms. Para ver todas as permissões, selecione Show detailed permissions. Se concordar, selecione Authorize Atoms.
4. Volte ao Atoms e aguarde a mensagem Connect success.
5. No Atoms, abra Connectors → Supabase e confirme que a organização aparece em Organizations.

O Atoms solicita acesso de leitura e gravação a Banco de Dados, Secrets, Auth, Edge Functions, Environment, Projects, PostgREST e Storage. Ele também solicita acesso de leitura a Organizations e Domains. Essas permissões permitem que o Atoms conecte e gerencie os serviços compatíveis do Supabase usados pelo seu projeto.

Essa autorização se aplica à organização Supabase selecionada e não se limita ao projeto Supabase que você conectará depois ao projeto Atoms atual. O Atoms não pode acessar organizações ou projetos aos quais a própria conta Supabase conectada não tenha acesso, e as permissões do Supabase podem impor restrições adicionais.

Revise a organização e as permissões antes de autorizar o Atoms.

Escolher o projeto Supabase

1. Em Organizations, expanda a organização que você autorizou.
2. Em Projects, encontre o projeto Supabase ativo que deseja conectar.
3. Se a organização de que você precisa não estiver listada, selecione New Organization e autorize-a. Isso não cria uma nova organização no Supabase; isso permite que você autorize outra organização que já existe na sua conta Supabase.
4. Se você ainda não tiver um projeto, selecione Create Project e crie um no Supabase. Aguarde até que o projeto esteja ativo e pronto para uso, depois volte ao Atoms e selecione Update para atualizar a lista de projetos.
5. Ao lado do projeto que deseja usar, selecione Connect.

Escolha um projeto Supabase da organização autorizada.

Confirmar o projeto

1. Na janela de confirmação, verifique a organização e o projeto mostrados em Supabase Project.
2. Se necessário, use Supabase Dashboard ou View Tables para confirmar que você selecionou o projeto correto.
3. Selecione Connect.
4. O Atoms adiciona um item de conexão do Supabase ao Chat do projeto. Mantenha a página aberta e aguarde a conclusão antes de pedir ao Agente para criar um banco de dados, autenticação, armazenamento ou recurso de backend.

Confirme o projeto Supabase selecionado antes de conectar.

Verificar se a conexão funcionou

1. Abra Settings → Connectors → Supabase.
2. Confirme que a organização correta e o projeto Supabase correto aparecem como conectados.
3. Selecione Dashboard ou Tables e verifique se isso abre o mesmo projeto no Supabase.

O painel do projeto conectado também pode incluir links para Manage Users, SQL Editor, Edge Functions e Manage Secrets. Você só precisa usar as áreas relevantes para os recursos que está criando.

Revise o projeto Supabase conectado e seus links de gerenciamento.

Testar se seu app consegue salvar dados

Conectar o Supabase não adiciona, por si só, um recurso de banco de dados ao seu app. No Chat, peça ao Agente para criar o recurso que você deseja e usar o projeto Supabase conectado para armazenar os dados dele. Depois que o Agente terminar, teste toda a jornada.

1. No Chat, descreva o recurso que você deseja, quais informações ele deve salvar e onde os usuários devem ver essas informações novamente. Diga ao Agente para usar o projeto Supabase conectado.
2. Aguarde o Agente terminar de criar o recurso.
3. No Visualizador de App, use o recurso como um usuário usaria e insira dados de teste inofensivos. Não use informações pessoais, confidenciais ou sensíveis.
4. Atualize o Visualizador de App ou reabra o recurso. Confirme que as informações salvas permanecem e aparecem no lugar correto.
5. Abra Settings → Connectors → Supabase, selecione Tables e confirme que o registro correspondente aparece na tabela correta.

Se o recurso permitir que os usuários editem ou excluam informações salvas, teste essas ações também e confirme que os resultados estão corretos tanto no app quanto no Supabase. Se as alterações feitas diretamente no Supabase aparecem imediatamente no app depende de como o app foi criado.

Desconectar Supabase

Desconecte o Supabase quando não quiser mais que o projeto Atoms atual use o projeto Supabase conectado.

1. Abra Settings → Connectors → Supabase.
2. Confirme que você está visualizando a conexão do projeto Atoms correto.
3. Selecione Disconnect Project.
4. Aguarde a conclusão do item de desconexão do Supabase no Chat.
5. Reabra Connectors → Supabase e confirme que o projeto não aparece mais como conectado.

Desconectar remove a conexão do projeto Atoms atual. Isso não exclui o projeto Supabase nem seus dados, e não remove a autorização da organização Supabase.

Quaisquer recursos no seu projeto Atoms que dependam do Supabase podem parar de funcionar depois que você o desconectar. Se seu app já estiver publicado, talvez seja necessário atualizar a versão publicada antes que a alteração entre em vigor. Teste tanto seu projeto quanto o app em produção após desconectar.

Desconectar o Supabase de um projeto Atoms não afeta outros projetos Atoms conectados ao mesmo projeto Supabase.

FAQ

Por que minha conexão com o Supabase parou de funcionar?

1. Abra o Supabase Dashboard e verifique o status do projeto afetado. Um projeto do Plano Gratuito com baixa atividade pode ser pausado após um período de sete dias.
2. Se ele estiver pausado, selecione Resume project e aguarde até que o Supabase informe que ele está ativo.
3. Volte ao Atoms, abra o painel de Connectors do projeto e verifique a conexão com o Supabase. Tente novamente a ação que falhou uma vez.
4. Se o Supabase já estiver ativo, capture o erro exato do Atoms ou do Supabase e verifique se a conexão aparece como desconectada ou expirada. Reconecte apenas quando o status indicar que isso é necessário.

Não altere chaves nem crie um projeto substituto até saber a causa e ter protegido os dados existentes. Se a falha continuar, entre em contato com o Suporte com o Chat Link, horário e fuso horário, status da conexão e captura de tela do erro sem dados sensíveis.

Referência externa: Supabase — Project Pausing

Como reconecto um projeto Supabase que foi pausado?

1. Entre na organização Supabase correta e abra o projeto pausado.
2. Selecione Resume project e aguarde até que o status fique ativo. A orientação atual do Supabase diz que projetos do Plano Gratuito com baixa atividade podem ser pausados após um período de sete dias de baixa atividade.
3. Volte ao Atoms e abra o painel de Connectors do projeto. Confirme que o Supabase está conectado e tente novamente a operação afetada.
4. Se o Atoms ainda mostrar o conector como desconectado ou expirado, reconecte-o e conclua a autorização solicitada.

Não crie um novo projeto Supabase nem altere credenciais até que os dados existentes estejam protegidos. Se a reconexão falhar, forneça ao Suporte o Chat Link, o status do projeto Supabase, horário e fuso horário, e uma captura de tela do erro sem dados sensíveis.

Referência externa: Supabase — Project Pausing