Conecte o Chatfuel MCP ao Supabase MCP
Para negócios cujo próprio app roda no Supabase e para o desenvolvedor ou a agência que o constrói. O seu assistente grava nas tabelas Postgres do app as conversas que o Agente de IA qualifica, e consulta em modo somente leitura pedidos, pacotes e cupons para responder clientes, fechar leads e configurar respostas a comentários. O Supabase criou o servidor como ferramenta de desenvolvimento que age com as suas próprias permissões no projeto, então limite-o a um projeto e deixe-o somente leitura sempre que a tarefa só ler.
O que a integração faz
As tools que o assistente usa em cada lado, com os nomes que cada servidor dá a elas.
| Tool | O que faz |
|---|---|
list_chats | Lista as conversas com clientes com canal, status e etapa do lead. |
get_chat | Mostra as últimas mensagens de uma conversa com um cliente, com canal, status e etapa do lead. |
send_chat_message | Envia ao cliente, na conversa dele, o texto que você aprovou e passa a conversa para o chat ao vivo. |
set_lead_stage | Move um lead para outra etapa do quadro de Leads, como qualificado ou ganho. |
list_posts | Lista os posts e reels recentes da conta do Instagram e da página do Facebook conectadas ao seu bot. |
setup_comment_replies | Configura respostas com IA ou fixas aos comentários, a todos ou por palavra-chave; no Instagram e no Facebook, também uma DM e a escolha dos posts. |
| Tool | O que faz |
|---|---|
list_tables | Lista todas as tabelas do banco de dados do seu projeto. |
execute_sql | Executa uma consulta SQL no banco; com read_only=true, roda como um usuário do Postgres somente leitura. |
apply_migration | Aplica uma mudança de esquema, como uma tabela nova, e a registra nas migrações do projeto. |
list_migrations | Lista as migrações aplicadas ao banco de dados. |
get_advisors | Mostra os alertas de segurança e desempenho do Supabase, como uma tabela pública sem segurança em nível de linha. |
generate_typescript_types | Gera tipos TypeScript a partir do esquema do banco para o código do seu app. |
O que pedir ao assistente
Conversas qualificadas → uma tabela chat_leads no banco de dados do seu app
QuandoO seu desenvolvedor está criando uma tela de leads no app da Nuvia Skin, que roda no Supabase, e quer numa tabela que o app consiga ler os clientes que o Agente de IA qualifica no WhatsApp e no Instagram.
- O Chatfuel MCP lista com
list_chatsas conversas da semana na etapa Qualificado, e oget_chattira de cada uma o procedimento, o dia preferido e o e-mail ou telefone que o cliente digitou. - O Supabase MCP confere o esquema public com
list_tables. Como ainda não existe a tabela chat_leads, oapply_migrationcria a tabela com segurança em nível de linha (RLS) ativada, e olist_migrationsmostra a mudança salva como migração. - O
execute_sqlprocura cada cliente pelo e-mail ou telefone digitado, insere as linhas novas e atualiza a etapa e o resumo de quem já estava na tabela. - O
get_advisorsroda as verificações de segurança do Supabase no projeto, e ogenerate_typescript_typesentrega ao código do app os tipos da nova tabela.
ResultadoAs conversas qualificadas ficam numa tabela do seu próprio banco Postgres, que só é lida pelas políticas que o desenvolvedor escrever, e a mudança de esquema vira uma migração no histórico do projeto, não uma edição manual.
PeçaCrie uma tabela chat_leads com RLS ativada no nosso projeto da Nuvia Skin no Supabase e adicione as conversas qualificadas da semana no Chatfuel. Antes, confira se cada cliente já está lá; depois rode o verificador de segurança e gere os tipos TypeScript.

“Quantas sessões ainda tenho?” → uma resposta tirada do banco do seu app
QuandoUma cliente que comprou no app o pacote de 3 hidratações faciais por R$ 480 pergunta no WhatsApp quantas sessões ainda tem, e o Agente de IA passa a conversa para a sua equipe.
- O Chatfuel MCP encontra com
list_chatsas conversas que esperam uma pessoa e lê a pergunta comget_chat, junto com o e-mail que a cliente digitou. - O Supabase MCP, conectado com read_only=true, encontra com
list_tablesas tabelas de pacotes e visitas. Um único SELECT peloexecute_sqldevolve as sessões compradas e usadas daquele e-mail. - O assistente escreve a resposta. Com o seu sim ao texto exato, o
send_chat_messageenvia, e a conversa fica com você no chat ao vivo.
ResultadoA Camila Alves responde com o mesmo número que a cliente vê no app, e a consulta rodou como usuário do Postgres somente leitura, então nada no banco podia mudar.
PeçaQuais conversas estão esperando uma pessoa? Se alguém perguntar sobre o pacote, procure as sessões no nosso projeto do Supabase pelo e-mail que a pessoa digitou e escreva uma resposta para eu enviar.

Pago no seu app → Fechado Ganhou no quadro de Leads
QuandoOs clientes perguntam ao Agente de IA sobre o pacote de hidratações faciais, depois pagam no seu app, e o quadro de Leads do Chatfuel ainda mostra essas pessoas em Vendendo.
- O Supabase MCP roda com
execute_sqlum SELECT somente leitura na tabela de pedidos do app: os pacotes pagos na semana, com o nome e o telefone de quem comprou. - O Chatfuel MCP procura cada comprador com
list_chats, primeiro pelo telefone do pedido e, se não achar, pelo nome. - O assistente faz uma única pergunta de sim ou não com até 5 leads, a etapa atual e a nova. Depois do seu sim, o
set_lead_stagepassa cada um para Fechado Ganhou, e a conversa volta para o Agente de IA. - Quem comprou e não tem conversa correspondente volta para você numa lista, então nenhum lead é adivinhado.
ResultadoO quadro de Leads mostra quem pagou de fato, direto dos pedidos que o seu app registra, e ninguém copia pagamentos à mão.
PeçaEncontre com uma consulta somente leitura os pedidos pagos nesta semana do pacote de hidratações faciais no nosso projeto do Supabase e mova esses clientes para Fechado Ganhou no quadro de Leads do Chatfuel. Procure primeiro pelo telefone.

Um cupom no seu banco de dados → respostas por palavra-chave no reel
QuandoO seu desenvolvedor colocou na tabela promo_codes um cupom para a primeira visita agendada pelo app, e o marketing acabou de publicar um reel sobre o app.
- O Supabase MCP lê o cupom ativo com uma consulta somente leitura do
execute_sql: APP15, 15% de desconto na primeira visita agendada pelo app, válido até 31 de dezembro. - O Chatfuel MCP encontra o reel pela legenda com
list_posts, que lista só posts do Instagram e do Facebook. - Com o seu sim, o
setup_comment_repliesresponde aos comentários com “código” nesse reel: uma resposta pública curta e uma DM com o cupom e o último dia. Essa regra substitui a resposta do Chatfuel a todos os outros comentários do Instagram, e o assistente avisa antes de você aceitar. - Se o desenvolvedor mudar o desconto depois, peça de novo: até lá a DM continua com o texto antigo.
ResultadoQuem comenta recebe exatamente o cupom que o seu app aceita, com a validade certa, e ninguém redigita nada a partir do banco.
PeçaLeia em modo somente leitura o cupom ativo do app na tabela promo_codes do nosso projeto do Supabase. Depois configure no Chatfuel respostas aos comentários com “código” no reel do app de hoje: uma resposta pública curta e o cupom com a validade na DM.

Como conectar
Conecte o Chatfuel MCP
O Chatfuel está nos diretórios de conectores do Claude e do ChatGPT; no Cursor, cole https://mcp.chatfuel.com/panel. Entre com a conta do Chatfuel dona do bot.
Conecte o Supabase MCP
Adicione o Supabase pelo diretório no Claude ou no ChatGPT, ou coloque https://mcp.supabase.com/mcp no Cursor, e escolha a organização onde está o projeto do seu app. Para as consultas, o painel de configuração da documentação do Supabase monta um endereço com o seu project_ref e read_only=true.
Leia o SQL e só então aprove
Diga a tabela ou as conversas num só pedido. O Chatfuel espera o seu sim antes de escrever para um cliente, mover um lead ou mudar as respostas a comentários; aprove uma chamada do Supabase só depois de ler a consulta que ela vai rodar.
- Conecte o Chatfuel em Customize › Connectors e entre na conta do Chatfuel.
- Procure o Supabase no mesmo diretório, clique em Connect e entre no Supabase. Escolha a organização que tem o projeto do seu app.
- O conector do diretório usa o endereço sem parâmetros. Para consultas somente leitura num projeto, adicione o Supabase como conector personalizado (Customize › Connectors › + Add › Add custom connector) com o endereço do painel de configuração do Supabase, por exemplo com ?project_ref= e &read_only=true.
- Chatfuel MCP
- claude.ai/directory/chatfuel
- Supabase MCP
- Pelo diretório do Claude
- Conecte o plugin do Chatfuel no ChatGPT e entre na conta do Chatfuel.
- Instale o Supabase pelo diretório do ChatGPT e dê acesso à sua organização do Supabase.
- A documentação do Supabase não mostra como passar read_only ou project_ref para o app do ChatGPT, então peça só consultas SELECT e confira a consulta de cada chamada.
- Chatfuel MCP
- chatgpt.com/plugins
- Supabase MCP
- Pelo diretório do ChatGPT
- Adicione o Chatfuel ao ~/.cursor/mcp.json com a URL https://mcp.chatfuel.com/panel.
- Adicione o Supabase ao .cursor/mcp.json no repositório do seu app, ou ao ~/.cursor/mcp.json para todos os projetos, com "url": "https://mcp.supabase.com/mcp". Acrescente ?project_ref= e &read_only=true quando só precisar consultar.
- O Cursor abre o navegador para entrar no Supabase; confira o servidor em Settings › Cursor Settings › Tools & MCP. Em CI, um token de acesso pessoal limitado num cabeçalho Authorization: Bearer substitui o login no navegador.
- Chatfuel MCP
https://mcp.chatfuel.com/panel- Supabase MCP
https://mcp.supabase.com/mcp
O que você precisa
- Um bot do Chatfuel cujo Agente de IA responda em pelo menos um canal. O caso do cupom precisa do Instagram ou do Facebook conectado.
- O projeto do Supabase em que o seu app já roda, em qualquer plano do Supabase.
- Uma função no Supabase que permita a tarefa: Developer, Administrator ou Owner para criar tabelas e gravar linhas. A função Read-Only, nos planos Team e Enterprise, só lê.
- Alguém que leia SQL, normalmente o seu desenvolvedor ou a sua agência, aprovando as chamadas ao Supabase. O Supabase apresenta o servidor como ferramenta para construir e testar apps, não para entregar a clientes.
- Claude num plano pago (Pro, Max, Team ou Enterprise) para o conector do diretório, ChatGPT ou Cursor.
Limites
- O Supabase MCP age com as permissões de quem o conectou. O Supabase recomenda não entregá-lo a clientes nem a usuários finais, e nenhum dos dois servidores dá ao Agente de IA acesso ao banco.
- Mensagens de clientes são texto de fora. O Supabase alerta que instruções escondidas nos dados podem levar o assistente a outras consultas (prompt injection); ele envolve os resultados de SQL para evitar isso e diz que não é infalível. Use somente leitura e um único projeto nas consultas, e mantenha a aprovação de cada chamada ligada.
- As gravações vão direto para o projeto. O Supabase pede confirmação de SQL destrutivo só quando o seu cliente suporta os formulários de confirmação, e chama isso de proteção, não de garantia. Teste tabelas novas primeiro numa branch de desenvolvimento; as ferramentas de branching exigem plano pago e o Supabase as marca como experimentais.
- Nada roda sozinho. Um pedido pago, uma conversa nova ou um cupom alterado só chegam ao outro lado quando você pede ao assistente.
- O Chatfuel MCP não devolve telefones nem e-mails. Uma conversa é ligada a uma linha pelo e-mail ou telefone que o cliente digitou, ou pelo nome, e a busca no sentido contrário encontra conversas pelo telefone guardado no seu app.
- Uma regra por palavra-chave para um reel desliga a resposta do Chatfuel aos demais comentários daquela plataforma, e os posts do TikTok não aparecem. Uma resposta ao cliente só sai dentro de 24 horas da última mensagem dele no WhatsApp, ou 7 dias no Instagram e no Messenger.
Perguntas frequentes
Sim. O Supabase hospeda o servidor em https://mcp.supabase.com/mcp, publica no MCP Registry como com.supabase/mcp e o marca como General Availability na página de recursos. Claude e ChatGPT o trazem nos seus diretórios de conectores.
Quem já trabalha no projeto do Supabase por trás do seu app. O servidor roda com as permissões dessa pessoa, então normalmente o desenvolvedor ou a agência conecta e aprova as consultas, enquanto a recepção continua trabalhando no Chatfuel.
Acrescente read_only=true ao endereço do servidor, e project_ref para limitá-lo a um projeto. Aí cada consulta roda como um usuário do Postgres somente leitura. O caso da tabela de leads do chat é o que precisa de uma conexão sem esse modo.
Existe um risco que o próprio Supabase aponta: o texto de uma conversa ou de uma linha pode trazer instruções voltadas ao assistente. Para consultar, use somente leitura num projeto, ligue só o grupo de banco de dados com features=database e leia cada consulta antes de aprovar.
Não. Nenhum dos dois servidores liga o Agente de IA ao seu banco. O assistente lê o Supabase quando você pede, e os clientes só veem a resposta que você aprova ou a regra de comentários que você configura.
Sim, para CI ou para um cliente sem login no navegador. Crie um token de acesso pessoal limitado a um projeto, só com as permissões que as suas ferramentas precisam, como leitura de Database para o execute_sql, e envie num cabeçalho Authorization: Bearer.
Mais integrações
Conecte o Chatfuel MCP
Comece o teste grátis, adicione o Chatfuel ao seu assistente e pergunte sobre Supabase e as suas conversas em um só lugar.

