Toolzz: escalabilidade para empresas em crescimento
Aprenda a instalar e configurar um servidor MCP com Supabase para usar com Claude Desktop ou Cursor.

Toolzz: escalabilidade para empresas em crescimento
18 de abril de 2026
Com a crescente popularidade de modelos de linguagem grandes (LLMs) como o Claude, a capacidade de interagir com esses modelos através de um servidor local se tornou crucial para desenvolvedores e empresas que buscam privacidade, controle e personalização. Um Memory Copilot Process (MCP) é uma ponte que permite que IDEs como Claude Desktop ou Cursor se conectem a esses LLMs de forma eficiente. Neste tutorial, vamos explorar o que é um MCP, por que ele importa e como instalar um servidor MCP utilizando o Supabase, um backend como serviço (BaaS) open-source.
O que é MCP e por que importa?
Um MCP atua como um intermediário entre sua IDE e o modelo de linguagem. Ele permite que você execute consultas e interaja com o LLM localmente, sem a necessidade de enviar dados para um servidor externo. Isso oferece diversas vantagens, incluindo:
- Privacidade: Seus dados permanecem em seu ambiente local.
- Controle: Você tem controle total sobre o modelo e seus dados.
- Personalização: Você pode personalizar o MCP para atender às suas necessidades específicas.
- Flexibilidade: Facilidade em integrar com diferentes ferramentas e fluxos de trabalho.
Sem um MCP, a interação com LLMs pode ser limitada e menos eficiente. Plataformas como Claude Desktop e Cursor dependem de MCPs para fornecer uma experiência de desenvolvimento integrada e poderosa. Se você busca uma solução completa para gerenciar seus agentes de IA e otimizar seus processos, conheça a Toolzz.
Pré-requisitos
Antes de começar, certifique-se de ter os seguintes pré-requisitos:
- Uma conta no Supabase.
- Node.js e npm instalados em seu sistema.
- Um editor de código (VS Code, Sublime Text, etc.).
- Familiaridade básica com a linha de comando.
Como instalar o servidor (npm/npx/docker)
Para este tutorial, vamos utilizar o supabase-serverless-functions para criar um servidor MCP. Este método oferece uma maneira simples e escalável de implantar seu servidor no Supabase.
Passo 1: Crie um novo projeto no Supabase
Crie um novo projeto no Supabase e obtenha as chaves de API (Project API Key) e a URL do projeto.
Passo 2: Inicialize um projeto Node.js
Crie um novo diretório para o seu projeto e inicialize um projeto Node.js:
bash mkdir mcp-supabase cd mcp-supabase npm init -y
Passo 3: Instale as dependências
Instale as dependências necessárias:
bash npm install @supabase/supabase-js cors
Passo 4: Crie a função serverless
Crie um arquivo chamado index.js com o seguinte código:
javascript import { createClient } from '@supabase/supabase-js'; import cors from 'cors';
const supabaseUrl = process.env.SUPABASE_URL; const supabaseKey = process.env.SUPABASE_ANON_KEY; const supabase = createClient(supabaseUrl, supabaseKey);
export default async function handler(req, res) { const enabledCORS = cors();
if (req.method === 'OPTIONS') { enabledCORS(req, res, () => { res.status(204).send(); }); return; }
enabledCORS(req, res, async () => { try { const { data, error } = await supabase .from('your_table') // Substitua 'your_table' pelo nome da sua tabela .select('*');
if (error) {
console.error(error);
res.status(500).json({ error: 'Erro ao buscar dados' });
return;
}
res.status(200).json(data);
} catch (error) {
console.error(error);
res.status(500).json({ error: 'Erro interno do servidor' });
}
}); }
Importante: Substitua your_table pelo nome da tabela que você deseja acessar no Supabase.
Passo 5: Configure as variáveis de ambiente
No painel do Supabase, configure as variáveis de ambiente SUPABASE_URL e SUPABASE_ANON_KEY com os valores correspondentes do seu projeto.
Como configurar no Claude Desktop ou Cursor
Após implantar seu servidor MCP no Supabase, você precisará configurá-lo no Claude Desktop ou Cursor.
- Obtenha a URL da função serverless: No painel do Supabase, encontre a URL da função serverless que você criou.
- Configure o MCP: No Claude Desktop ou Cursor, vá para as configurações e adicione um novo MCP. Insira a URL da função serverless como o endpoint do MCP.
- Teste a conexão: Teste a conexão para garantir que o Claude Desktop ou Cursor possa se comunicar com o seu servidor MCP.
Exemplos de uso real das tools expostas
Com o MCP configurado, você pode realizar diversas tarefas, como:
- Acessar dados do Supabase: Buscar informações de tabelas específicas no Supabase diretamente de sua IDE.
- Personalizar prompts: Usar dados do Supabase para personalizar prompts para o LLM, tornando as respostas mais relevantes e precisas.
- Automatizar tarefas: Automatizar tarefas repetitivas, como geração de relatórios ou análise de dados, usando o LLM e os dados do Supabase.
Por exemplo, você pode usar o MCP para buscar informações sobre um cliente no Supabase e usar essas informações para criar um resumo personalizado para o agente de vendas da Toolzz AI. Ou então, você pode usar o MCP para buscar dados de desempenho de vendas e gerar um relatório detalhado usando o Toolzz LXP. Se você busca entender melhor como a inteligência artificial pode impulsionar o desempenho da sua equipe comercial, verifique nossos planos da Toolzz AI.
Troubleshooting comum
- Erro de conexão: Verifique se a URL da função serverless está correta e se o Supabase está acessível.
- Erro de autenticação: Verifique se as chaves de API (Project API Key) estão corretas e se você tem as permissões necessárias para acessar os dados.
- Erro de CORS: Certifique-se de que o CORS está configurado corretamente para permitir solicitações de sua IDE.
- Dados ausentes: Verifique se a tabela especificada existe no Supabase e se os dados estão presentes.
Conclusão
Neste tutorial, aprendemos como instalar e configurar um servidor MCP com Supabase, permitindo que você aproveite o poder dos LLMs localmente. Ao seguir estes passos, você pode aumentar sua privacidade, controle e flexibilidade ao trabalhar com modelos de linguagem grandes. A combinação de um MCP bem configurado com a Toolzz AI abre um leque de possibilidades para automação e personalização em seus fluxos de trabalho.
Veja como é fácil criar sua IA
Clique na seta abaixo para começar uma demonstração interativa de como criar sua própria IA.
Com a Toolzz, você pode centralizar a gestão de seus agentes de IA, chatbots e fluxos de trabalho, garantindo uma experiência consistente e escalável para sua equipe. Além disso, a Toolzz LXP oferece recursos avançados de educação corporativa, permitindo que você treine sua equipe sobre as melhores práticas de uso da IA.
Bônus: use esse MCP pelo WhatsApp com Toolzz AI:
Agora que você configurou esse MCP, já imaginou acioná-lo por voz no WhatsApp? Com a Toolzz AI, você conecta esse servidor MCP ao seu agente e qualquer pessoa da equipe usa — sem abrir terminal, sem IDE. Basta pedir.
Quer ver na prática?
Comece gratuitamente

















