Migração para Toolzz: guia completo de MCP com Supabase em 2026

Lucas (CEO Toolzz)
17 de abril de 2026

Com a crescente popularidade de modelos de linguagem grandes (LLMs) como o GPT-4, a capacidade de interagir com eles de maneira programática e personalizada tornou-se essencial para desenvolvedores. Model Calling Protocol (MCP) emerge como uma solução poderosa para orquestrar essas interações, permitindo a criação de agentes de IA mais inteligentes e eficientes. Este guia completo te ensinará a instalar e configurar um MCP usando Supabase, integrando-o com ferramentas como Claude Desktop ou Cursor.

O que é MCP e por que importa?

Model Calling Protocol (MCP) é uma interface padronizada para interagir com modelos de linguagem. Ele define um protocolo claro para enviar solicitações a um modelo e receber respostas, permitindo que desenvolvedores construam aplicações que utilizam LLMs de maneira mais consistente e confiável. O MCP facilita a criação de agentes de IA que podem executar tarefas complexas, como extrair informações, gerar código ou responder a perguntas em linguagem natural.

Ao usar MCP, você obtém:

• Modularidade: Separação clara entre a lógica da aplicação e a interação com o modelo.
• Reutilização: Componentes MCP podem ser reutilizados em diferentes aplicações.
• Testabilidade: Facilidade de testar e depurar a interação com o modelo.
• Escalabilidade: Arquitetura que suporta o aumento da demanda.

Plataformas como a Toolzz AI utilizam o poder do MCP para fornecer agentes de IA personalizados para diversas necessidades de negócios, desde vendas até atendimento ao cliente. Se você busca uma solução completa e pronta para uso, vale a pena conhecer os planos da Toolzz AI.

Pré-requisitos

Antes de começar, você precisará de:

• Node.js e npm: Certifique-se de ter o Node.js e o npm instalados em sua máquina.
• Conta Supabase: Crie uma conta gratuita no Supabase.
• Claude Desktop ou Cursor: Escolha uma IDE que suporte MCP, como Claude Desktop ou Cursor.
• Conhecimento básico de JavaScript: Algum conhecimento de JavaScript será útil para entender e modificar o código.

Como instalar o servidor (npm/npx/docker)

Neste tutorial, utilizaremos o npx para instalar e executar o servidor MCP. O npx é um executor de pacotes que vem com o npm, permitindo que você execute pacotes sem instalá-los globalmente.

1. Crie um novo projeto:

bash mkdir mcp-supabase cd mcp-supabase

2. Inicialize o projeto npm:

bash npm init -y

3. Instale o pacote mcp:

bash npx mcp init

4. Configure as variáveis de ambiente:

   • Crie um arquivo .env com as seguintes variáveis:

SUPABASE_URL="sua_url_supabase" SUPABASE_ANON_KEY="sua_chave_anonima_supabase"

Substitua sua_url_supabase e sua_chave_anonima_supabase pelos valores corretos do seu projeto Supabase.

5. Execute o servidor:

bash npx mcp start

O servidor MCP agora estará rodando localmente. Por padrão, ele estará disponível em http://localhost:3000.

Como configurar no Claude Desktop ou Cursor

Agora que o servidor MCP está rodando, você pode configurá-lo no Claude Desktop ou Cursor. O processo é semelhante em ambas as ferramentas.

1. Abra as configurações do MCP:

   Em Claude Desktop ou Cursor, abra as configurações do MCP (geralmente acessíveis através do menu de configurações ou atalhos de teclado).

2. Adicione um novo servidor MCP:

   Clique em "Adicionar servidor" ou similar.

3. Configure os detalhes do servidor:

   • Nome: Dê um nome ao seu servidor (ex: Supabase MCP).
   • URL: Digite a URL do seu servidor MCP (ex: http://localhost:3000).
   • Tipo: Selecione o tipo de servidor (geralmente "HTTP").

4. Salve as configurações:

   Salve as configurações do servidor MCP.

Agora, Claude Desktop ou Cursor poderá se comunicar com o seu servidor MCP.

Exemplos de uso real das tools expostas

Com o MCP configurado, você pode realizar diversas tarefas, como:

• Extração de informações de texto: Envie um texto para o MCP e solicite a extração de informações específicas, como nomes, datas ou endereços.
• Geração de código: Solicite ao MCP a geração de código em uma linguagem de programação específica, a partir de uma descrição em linguagem natural.
• Tradução de idiomas: Envie um texto em um idioma e solicite a tradução para outro idioma.
• Resumo de textos longos: Solicite ao MCP um resumo conciso de um texto longo.

Por exemplo, utilizando o Agente AI de Suporte da Toolzz, você poderia integrar esse MCP para que o agente respondesse a perguntas complexas dos clientes utilizando o poder do LLM, acessando informações em tempo real do Supabase. Está pensando em automatizar o atendimento ao cliente? Solicite uma demonstração da Toolzz e veja como podemos te ajudar.

Troubleshooting comum

• Erro de conexão: Verifique se o servidor MCP está rodando e se a URL está correta.
• Erro de autenticação: Verifique se as variáveis de ambiente SUPABASE_URL e SUPABASE_ANON_KEY estão corretas.
• Resposta vazia: Verifique se o modelo está configurado corretamente e se a solicitação está sendo formatada corretamente.
• Modelo não encontrado: Certifique-se de que o modelo especificado existe e está acessível.

Se você encontrar outros problemas, consulte a documentação do MCP e do Supabase para obter mais informações.

Conclusão

Neste guia, você aprendeu como instalar e configurar um MCP usando o Supabase, integrando-o com Claude Desktop ou Cursor. Ao dominar o MCP, você estará preparado para construir aplicações de IA mais inteligentes e poderosas, aproveitando todo o potencial dos modelos de linguagem. A combinação de ferramentas como Supabase, Claude Desktop/Cursor e plataformas como a Toolzz abre um leque de possibilidades para a criação de soluções inovadoras.