Conecte serviçosConectores

Dados e conteúdo

Bancos de dados, planilhas, sistemas de conteúdo, armazenamento de arquivos e busca que você pode conectar a um app: Supabase, Neon, Firebase, Airtable, Notion, Google Sheets, WordPress, Contentful, Storyblok, Webflow, AWS S3, Cloudinary e Algolia.

Todo app já tem um banco de dados, login e e-mails próprios: isso é o Cloud. Conecte um destes quando os dados já estão em outro lugar, quando você quer que eles fiquem em uma conta sua ou quando o app precisa de algo que o Cloud não faz, como guardar arquivos enviados.

Esta página tem uma entrada por serviço. Para saber como conectar funciona em geral (o botão ou as chaves, Test connection, escolher quais apps usam um serviço, permissões), veja Conectores.

ServiçoPara que serveComo se conecta
SupabaseSeu próprio projeto Supabase em vez do backend integradoEndereço do projeto e chaves
NeonSeu próprio Postgres, com suas próprias regras de linhaO endereço da Data API
FirebaseFirestore e login a partir do seu projeto FirebaseTrês valores do console do Firebase
AirtableTabelas como banco de dadosUm botão ou um token
NotionPáginas e bancos de dadosUm botão ou um token
Google SheetsUma planilha como banco de dadosUm botão ou uma chave de API
WordPressPosts e páginas de um site WordPressEndereço do site e uma senha de aplicativo
ContentfulEntradas de um CMS headlessSpace ID e um token de entrega
StoryblokStories de um CMS headlessUm token de acesso público
WebflowColeções do CMS do WebflowUm token do site
AWS S3Arquivos que as pessoas enviamRegião, bucket e uma chave de acesso
CloudinaryImagens e arquivos, redimensionados na entregaCloud name, upload preset e chaves
AlgoliaBusca enquanto você digitaApplication ID e duas chaves

Algumas coisas valem para todos eles:

  • As chaves secretas ficam nos servidores do Setherion, e seu app publicado chama o serviço por meio do Setherion. Só chegam ao navegador valores que são públicos por natureza: a chave anon do Supabase, as configurações do Firebase, o cloud name e o upload preset do Cloudinary, a chave só de busca do Algolia e uma chave de API do Google Sheets.
  • Os serviços que cobram você diretamente mostram Billed by e o nome deles na página, e pedem que você aceite isso antes de conectar. Neon, Firebase, Supabase, Airtable, Cloudinary, Algolia e AWS S3 estão nesse grupo. Notion, Google Sheets, WordPress, Contentful, Storyblok e Webflow mostram No usage charges.
  • Cada chamada que um app publicado faz por meio do Setherion usa um crédito de integração. Veja Planos e créditos.
  • Test connection existe para todos os serviços daqui, exceto o Firebase.
  • Em um espaço de trabalho de equipe, o dono pode emprestar algumas conexões aos apps dos membros (veja Espaços de trabalho). Supabase, Neon e Firebase nunca são emprestados, nem qualquer serviço cujos valores são embutidos no app publicado: aqui, Cloudinary, Algolia e Google Sheets.

Bancos de dados e tabelas

Supabase

Para que serve. Seu próprio projeto Supabase: o banco de dados, o login e o armazenamento de arquivos dele. É opcional, porque todo app já tem um backend. Escolha-o quando quiser os dados de um app em um projeto que é seu. Enquanto o Supabase está ativado para um app, esse app o usa para dados, login e arquivos no lugar do backend integrado.

Conectar. Cole a Project URL (como https://abcdefgh.supabase.co) e a Anon Key, ambas do Supabase em Project Settings, depois API. A anon key começa com eyJ ou sb_publishable_; use o botão de copiar do Supabase, pois uma chave cortada é recusada. A Service Role Key é opcional e começa com eyJ ou sb_secret_.

Criar as tabelas. Clique em Connect Supabase account, entre no Supabase e aprove. Depois, em um app que precisa de tabelas, Manage, depois Cloud, tem um botão que cria as tabelas no seu projeto cada vez que você clica. A permissão fica nos nossos servidores. Sem ela, o mesmo SQL está ali para você copiar no Supabase por conta própria. Quando a sua conta está conectada, uma lista Your projects também permite clicar em Use this project em vez de colar as chaves.

Peça. “Salve as reservas no meu Supabase e deixe os clientes entrarem com e-mail.” “Adicione uma tabela de produtos com nome, preço e foto.”

Bom saber. Apps no seu próprio Supabase ainda não podem usar Chaves e segredos. Para mover um app que já tem dados, veja Ajustes avançados.

Neon

Para que serve. Seu próprio Postgres no Neon como banco de dados do app. O Setherion chega a ele pela Data API do Neon, e o próprio Postgres decide quem vê cada linha, por segurança em nível de linha. Isso serve a um app em que cada pessoa vê as próprias linhas, a um catálogo que qualquer um pode ler ou a uma visão da equipe.

Conectar. Cole o Data API address do Neon: seu projeto, depois Data API, o endpoint REST que termina em /rest/v1. Ele precisa estar em neon.tech. Depois clique em Test connection. Até o Neon ser avisado para confiar no Setherion, ele recusa, e o resultado dá o endereço JWKS para colar nele.

O passo do JWKS. No Neon, abra Data API, depois Authentication, escolha um provedor personalizado e cole esse endereço JWKS. Deixe a audiência vazia. É assim que o Neon aprende a confiar na pessoa conectada que o Setherion envia a cada chamada. Se o Test ainda disser não depois de alguns minutos, remova o provedor no Neon e adicione de novo.

Peça. “Guarde uma lista de tarefas para cada pessoa conectada no meu banco de dados Neon.” “Mostre a tabela de produtos do Neon como uma página de loja, filtrada por categoria.”

Permissões. Três chaves em Permissions: ler linhas, adicionar, alterar e excluir linhas, e executar funções do banco de dados.

Bom saber. As tabelas só existem depois que você executa o SQL que a IA escreve para elas (um arquivo chamado neon/setup.sql), uma vez, no SQL Editor do Neon. Um visitante que não está conectado alcança só o que você concedeu ao papel anônimo do Neon.

Firebase

Para que serve. Firestore para dados e Firebase Authentication para login, a partir do seu próprio projeto Firebase. Nada mais do Firebase foi construído.

Conectar. Três valores, das configurações do app web do seu projeto no console do Firebase: a API Key (começa com AIza), o Project ID e o App ID (como 1:123:web:abc). Os três são públicos por natureza e vão para o app publicado. Não há Test connection para o Firebase: Connect guarda os valores.

Peça. “Deixe as pessoas se cadastrarem e guarde uma lista privada de anotações no Firestore.” “Mostre uma lista ao vivo de mensagens do meu projeto Firebase.”

Bom saber. No Firebase, o que protege seus dados não é a chave: são as regras de segurança. Qualquer pessoa pode ler as configurações de um app publicado, então um projeto deixado em modo de teste fica aberto para a internet inteira. Defina as regras do Firestore no console do Firebase antes de o app guardar qualquer dado pessoal. A IA escreve cada documento de modo que ele pertença a um ID de usuário do Firebase Authentication e avisa isso na tela quando o app guarda dados pessoais.

Airtable

Para que serve. Uma tabela de linhas como banco de dados do app: um CRM, uma lista de estoque, conteúdo que você mantém no Airtable.

Conectar. Clique em Connect with Airtable, entre e marque as bases que o app pode usar, depois clique em Choose base e escolha uma. Ou use chaves: um Personal Access Token (começa com pat) da sua conta Airtable e o Base ID (começa com app, mostrado no endereço da sua base).

Peça. “Mostre meu estoque da tabela Products do Airtable, com a foto e o preço.” “Adicione cada consulta do formulário de contato como uma nova linha na minha tabela Enquiries.”

Limites. Os apps alcançam a única base que você escolheu e nada mais na sua conta, mesmo que o token pudesse mais. Uma tabela com espaços no nome é tratada para você. O Airtable devolve tabelas longas uma página por vez, e o app é instruído a buscar todas as páginas ou a avisar que a lista está parcial. Test connection lê as tabelas da base, então falha se essa base não foi marcada.

Páginas e planilhas

Notion

Para que serve. Um banco de dados do Notion como um sistema de conteúdo leve ou lista de tarefas, e páginas do Notion mostradas ou preenchidas por um app.

Conectar. Clique em Connect with Notion, entre e marque as páginas que o app pode usar. O app pode então ler e escrever essas páginas e nada mais. Ou use um token: crie uma integração interna em notion.so/my-integrations e cole o Internal Integration Token dela (começa com ntn_ ou secret_), com um Default Database ID opcional. Com um token, compartilhe cada página ou banco de dados com a integração no Notion, ou o Notion responde 404 a tudo.

Peça. “Mostre a página da equipe a partir do meu banco de dados do Notion, com a foto e o cargo de cada pessoa.” “Adicione cada mensagem do formulário como uma nova linha nas minhas tarefas do Notion.”

Limites. Uma consulta devolve no máximo 100 linhas, então, para um banco de dados longo, o app é instruído a continuar pedindo até o Notion dizer que não há mais.

Bom saber. A IA que cria seus apps também pode ler o seu Notion por um servidor MCP, que é um recurso separado: veja Seus servidores MCP.

Google Sheets

Para que serve. Uma planilha que você edita como os dados do app: preços, um cardápio, anúncios, membros da equipe e cadastros reunidos em linhas.

Conectar, com o botão. Clique em Connect with Google, entre, depois clique em Choose spreadsheet e escolha o arquivo. A planilha continua privada, o app a lê e escreve por meio do Setherion, e o resto do seu Drive fica fora de alcance.

Conectar, com uma chave. Cole uma chave de API do Google com a Google Sheets API ativada no Google Cloud, restrita a essa API e ao seu site, e o ID da planilha. Esse modo só funciona em uma planilha compartilhada como “qualquer pessoa com o link pode ver”, e só lê.

Peça. “Mostre a lista de preços da minha planilha e atualize quando eu editar a planilha.” “Adicione cada pedido de reserva como uma nova linha no fim da minha planilha.”

Limites. Com o botão, uma planilha e as abas dela. Um intervalo nomeia uma aba, então, se você renomear uma aba, avise no chat.

Notion, Airtable e Google Sheets são acessados por meio do Setherion em nome de todos que abrem o seu app publicado. Conecte só o que o app deve mostrar ou preencher.

Conteúdo de um CMS

Estes quatro leem conteúdo que você escreve em outro lugar e o mostram no seu app. Os quatro só leem, e só o que está publicado: um rascunho nunca chega a uma página pública.

WordPress

Para que serve. Os posts, páginas e mídia publicados de um site WordPress, mostrados dentro de um app: um blog, uma página de notícias, um portfólio.

Conectar. O Site address (precisa começar com https://), um Username e uma Application password. Crie essa senha no WordPress em Users, depois Profile, depois Application Passwords, depois Add New. O plano gratuito do WordPress.com não oferece senhas de aplicativo. Test connection entra no site.

Peça. “Adicione uma página de blog que liste meus 10 posts mais novos do WordPress com as imagens deles.” “Mostre cada post na própria página, a partir do slug dele.”

Permissões. Uma chave Read para cada um destes: posts, páginas, imagens e arquivos, categorias, tags e comentários.

Bom saber. Nada é escrito no site. Posts e páginas são mostrados como publicados, e comentários como aprovados. O texto de um post chega como HTML do seu próprio site, então o app o desenha com a tipografia dele.

Contentful

Para que serve. Entradas escritas no Contentful: artigos, produtos, páginas, membros da equipe, quaisquer que sejam os seus tipos de conteúdo.

Conectar. O Space ID (Settings, depois General settings) e o Content Delivery API token (Settings, depois API keys). Use o token de entrega, não o de gerenciamento. O Environment é opcional e é master quando deixado vazio. Test connection lê os seus tipos de conteúdo.

Peça. “Mostre meus posts de blog do Contentful, do mais novo para o mais antigo, com a imagem de capa.” “Crie uma página para cada entrada de produto, encontrada pelo slug.”

Permissões. Uma chave Read para cada um destes: entradas, imagens e arquivos, e tipos de conteúdo.

Bom saber. Os nomes dos campos vêm do seu modelo de conteúdo, então a IA lê os tipos de conteúdo primeiro em vez de adivinhar. Um campo de rich text chega como uma árvore de documento que o app desenha sozinho.

Storyblok

Para que serve. Stories, páginas e blocos escritos no Storyblok: um blog, uma landing page, uma lista de produtos ou de membros da equipe.

Conectar. Um Access token: no Storyblok, Settings, depois Access tokens, um token Public. A Region é opcional: eu (o padrão) ou us, como aparece nas configurações do seu space.

Peça. “Liste as stories mais novas na pasta do blog.” “Monte a página Sobre a partir da story com o slug about.”

Permissões. Uma chave Read para cada um destes: stories, links, entradas de datasource e tags.

Bom saber. Só conteúdo publicado é lido: o Setherion força isso, então um token de pré-visualização colado por engano não consegue pôr rascunhos em uma página pública. Uma story é uma árvore de blocos, e o app desenha os que o seu space usa.

Webflow

Para que serve. As coleções que você escreve no CMS do Webflow: um blog, uma equipe, um cardápio, projetos ou locais.

Conectar. Um Site API token. No Webflow, abra Site settings, depois Apps & integrations, depois API access, e gere um token com CMS e Sites definidos como Read-only.

Peça. “Mostre os posts de blog mais novos da minha coleção do Webflow.” “Dê a cada membro da equipe a própria página, a partir do slug do item.”

Limites. Só itens publicados são lidos. Eles vêm do cache do Webflow, então uma mudança pode levar alguns minutos para aparecer. As chamadas que encontram o seu site e as coleções dele contam para o limite do Webflow de 60 por minuto nos planos menores, então o app é instruído a guardar as respostas delas por um dia em vez de perguntar a cada visita. Este conector não tem chaves de permissão.

Arquivos, imagens e busca

AWS S3

Para que serve. Arquivos que as pessoas enviam nos seus apps (fotos, documentos, anexos), guardados no seu próprio bucket S3. O backend integrado guarda registros e nenhum arquivo, então é para cá que vão os envios.

Conectar. Quatro valores: a Bucket region (como eu-west-2, que é Londres), o Bucket name (letras minúsculas, dígitos e hifens, sem pontos) e uma Access key ID e uma Secret access key da AWS em IAM, depois Users, um usuário criado só para o Setherion, depois Security credentials, depois Create access key. O segredo é mostrado uma vez. Test connection lê o bucket, depois envia um pequeno arquivo de teste por um link assinado, lê de volta, exclui e verifica se o seu bucket deixa os navegadores enviarem. Se essa última verificação falhar, olhe primeiro as configurações de CORS do bucket.

Peça. “Deixe os clientes anexarem uma foto ao pedido de conserto.” “Mostre os documentos enviados de cada pedido na página do pedido.”

Limites.

  • Os arquivos têm até 25 MB cada.
  • Cada app tem a própria pasta no bucket, apps/ seguido do ID do app, e o Setherion recusa qualquer chave fora dela. Um bucket pode servir todos os seus apps sem que um leia os arquivos do outro.
  • Os visitantes não podem listar arquivos. Um arquivo é alcançado pela chave dele, que o app guarda com o registro, e os links que mostram um arquivo duram uma hora.
  • Listar e excluir os arquivos de um app é só para a equipe do app. Enviar e mostrar estão abertos a qualquer pessoa que use o app.

Permissões. Três chaves: enviar arquivos, mostrar arquivos, e listar e excluir arquivos.

Bom saber. Um seletor de arquivos na pré-visualização do editor envia para o seu bucket real, exatamente como o app publicado.

Cloudinary

Para que serve. Enviar imagens e arquivos a partir de um app e entregá-los no tamanho exibido, pela CDN do Cloudinary.

Conectar. Quatro valores: Cloud Name, um Unsigned Upload Preset, uma API Key e um API Secret. Crie o preset no Cloudinary em Settings, depois Upload, como um preset unsigned. As chaves ficam em Settings, depois API keys. Sem um preset, o envio não funciona, e o app diz isso em vez de fingir.

Peça. “Deixe os vendedores enviarem fotos dos produtos e mostre-as no tamanho certo.” “Adicione uma página de galeria onde os visitantes possam mandar imagens.”

Limites. O navegador envia direto para o seu Cloudinary com o preset. O cloud name e o preset vão para o app publicado, como o Cloudinary prevê. O API secret não: o Setherion usa a chave e o segredo só para Test connection, então nenhum segredo fica no app. Cada envio e cada visualização correm na sua conta do Cloudinary.

Bom saber. A skill File upload é construída sobre este conector: veja Skills.

Algolia

Para que serve. Busca instantânea, enquanto se digita, em produtos, artigos ou quaisquer itens que você indexar.

Conectar. Três valores do painel do Algolia em Account, depois API keys: o Application ID, a Admin API Key e a Search-Only API Key.

As duas chaves. Os visitantes buscam no navegador com a chave só de busca, que pode ser publicada com segurança e vai para o app. A chave de admin pode excluir um índice, então nunca sai dos nossos servidores: o app a usa por meio do Setherion apenas para indexar registros. Sem uma chave só de busca salva, a busca não funciona, e o app diz isso em vez de recorrer à chave de admin. Excluir registros ou um índice, esvaziá-lo ou mover um sobre outro é só para a sua equipe; adicionar e atualizar registros funciona para qualquer pessoa que use o app.

Peça. “Adicione uma caixa de busca à loja que encontre produtos enquanto eu digito.” “Indexe meus produtos no Algolia quando eu adicionar um.”

Bom saber. A skill Search é construída sobre este conector: veja Skills.

Esta página foi útil?

Entre na comunidade

Perguntas, ideias e o que outras pessoas estão criando.