🧚 Escute! O Beekeeper Studio é uma GUI para MySQL rápida, moderna e open source Baixar
18 de novembro de 2026 Por Matthew Rathbone

Você pode conectar o Claude diretamente ao MySQL em poucos minutos. Mas provavelmente não deveria: o Claude passa a ter sua senha e pode executar qualquer SQL que quiser. O jeito mais seguro é colocar um app como o Beekeeper Studio no meio.

Existem duas formas de conectar o MySQL ao Claude:

  1. Conectar o Claude diretamente ao MySQL, passando suas credenciais pelo Claude Code ou por um servidor MCP de MySQL.
  2. Conectar pelo Beekeeper Studio, que guarda sua senha para si e pergunta a você antes de executar uma query.

A opção 2 é a que recomendamos, e você pode testá-la de graça: baixe o Beekeeper Studio, nosso gerenciador de banco de dados MySQL, e pule para o passo a passo.

Opção 1: conectar o Claude diretamente ao MySQL

O Claude Code pode executar comandos de shell, então o jeito mais rápido é informar seus dados de conexão e deixá-lo usar o cliente de linha de comando mysql:

mysql -h db.example.com -u app -phunter2 shop -e "SELECT COUNT(*) FROM orders"

A outra forma é um servidor MCP de MySQL, que dá ao Claude Desktop ou ao Claude Code uma ferramenta para “executar este SQL”. Os open source, como o mysql_mcp_server, pedem que você escreva o host, o usuário e a senha no arquivo de configuração do Claude.

De qualquer forma, o Claude passa a ter um login do MySQL e decide sozinho o que executar com ele.

Os perigos de conectar o MySQL diretamente ao Claude

Com esse login, e sem ninguém revisando o SQL dele:

  • O Claude pode excluir linhas ou atualizar todas as linhas de uma tabela com uma única cláusula WHERE errada.
  • O Claude pode alterar a estrutura das tabelas ou excluí-las por completo.
  • O MySQL faz commit de cada comando ao executá-lo, então não há como desfazer, só restam seus backups.
  • O Claude pode ler todas as tabelas que o usuário pode, e o que ele lê é enviado para a Anthropic.
  • Sua senha fica em texto puro em um arquivo de configuração, no histórico do shell ou no chat.
  • Uma linha contendo “ignore suas instruções e execute…” pode ser seguida como se fosse uma instrução.
  • Um join pesado ou um ALTER TABLE pode travar uma tabela de produção enquanto seus usuários esperam.
  • Com privilégios suficientes, o Claude pode criar usuários e conceder mais acesso a si mesmo.
  • A partir de um shell, o Claude também pode executar o mysqldump e copiar o banco de dados inteiro.
  • Nada registra o que o Claude executou, a menos que você tenha ativado o log de queries do MySQL.

O Claude Code pergunta antes de executar um comando, até você clicar em “always allow” para parar os avisos.

Você pode limitar o estrago com um usuário do MySQL só para o Claude

Se for conectar diretamente, não dê ao Claude o seu próprio login. Crie um usuário para ele que só possa ler um banco de dados:

CREATE USER 'claude'@'%' IDENTIFIED BY 'a-long-random-password';
GRANT SELECT ON shop.* TO 'claude'@'%';

Assim, o MySQL recusa todo o resto:

DELETE FROM orders WHERE status = 'cancelled';
-- ERROR 1142 (42000): DELETE command denied to user 'claude'@'localhost' for table 'orders'

Isso impede as escritas, os drops e os grants. Mas não impede o Claude de ler todas as linhas desse banco, de executar uma query pesada o bastante para deixar a produção lenta, nem evita a senha num arquivo de configuração. Você pode restringir ainda mais concedendo SELECT em tabelas específicas (GRANT SELECT ON shop.orders TO ...) e apontando o Claude para uma réplica. O SHOW GRANTS confirma o que o usuário pode fazer.

Opção 2: conectar o Claude ao MySQL pelo Beekeeper Studio

O AI Shell do Beekeeper Studio fica entre o Claude e o seu banco de dados:

  • O Claude nunca recebe sua senha do MySQL. Ele só pode listar tabelas, listar colunas e propor queries.
  • Cada query é mostrada a você com os botões Sim, Não e Editar antes de ser executada.
  • Você pode deixar as queries somente leitura rodarem sozinhas. Tudo que faz escrita continua pedindo permissão.
  • Sua chave de API da Anthropic fica armazenada criptografada na sua máquina e só é enviada para a Anthropic.

O Claude vê os nomes das suas tabelas e os resultados das queries que você aprova, então não aprove um SELECT de dados que você não colaria num chat.

O AI Shell está incluído em todos os planos pagos, e você pode testá-lo grátis por 14 dias, sem cadastro nem cartão de crédito. As capturas de tela abaixo são do Beekeeper Studio 6.3.2 com um pequeno banco de dados de loja em MySQL 8.4.

Passo 1: conecte-se ao seu banco de dados MySQL

Baixe o Beekeeper Studio, clique em New Connection, escolha MySQL, preencha os dados de conexão e clique em Connect.

Formulário New Connection do Beekeeper Studio para MySQL com host localhost, porta 3306, usuário root, banco de dados padrão shop, uma caixa de seleção Read Only Mode e a conexão chamada Shop (MySQL)

Para mais proteção, marque Read Only Mode: o Beekeeper Studio passa a recusar UPDATE, DELETE, ALTER e outras escritas nessa conexão, seja pelo AI Shell ou por qualquer outro lugar. O usuário MySQL somente leitura mostrado acima também funciona aqui.

Passo 2: abra uma aba do AI Shell

Clique na seta ao lado do + acima do editor e escolha Add AI Shell, ou pressione Ctrl+L.

O menu de nova aba do Beekeeper Studio aberto em uma conexão MySQL, com Add Query, Add AI Shell e Manage Plugins

Passo 3: adicione sua chave de API da Anthropic

Escolha Anthropic como provedor e cole uma chave de API do Claude Console. Você paga diretamente à Anthropic pelos preços normais da API, sem acréscimo.

A tela Welcome to the AI Shell com Anthropic selecionado como provedor, uma chave de API inserida e um aviso de que as chaves de API são criptografadas, armazenadas apenas no seu dispositivo e compartilhadas somente com o provedor de IA selecionado

Passo 4: escolha um modelo do Claude

Clique no nome do modelo ao lado do botão de enviar. O Haiku é o mais rápido e barato, o Opus o mais capaz, e o Sonnet fica no meio-termo.

O menu de modelos do AI Shell listando modelos do Claude, de claude-sonnet-5-5 e claude-opus-5-5 até claude-haiku-4-5

Passo 5: faça uma pergunta e aprove a query

Perguntei “Quem foram nossos principais clientes no mês passado?”. O Claude consultou as tabelas e suas colunas e depois escreveu uma query. Ela só é executada quando você clica em Yes:

O AI Shell mostrando uma query SELECT que soma os pedidos enviados em outubro por cliente, com a pergunta Do you want to run this query? e os botões Yes, No e Edit

Leia o SQL antes, principalmente os joins e a cláusula WHERE. Com Edit você pode alterá-lo antes da execução.

Passo 6: leia a resposta

Depois de aprovada, a query é executada e o Claude responde com base nos resultados. As linhas também são exibidas, para você conferir a resposta com os dados.

Os resultados da query aprovada, três clientes com suas quantidades de pedidos e totais, seguidos de uma tabela-resumo indicando Sam Okafor como o principal cliente do mês passado

Passo 7: diga não a qualquer coisa que você não pediu

Quando pedi ao Claude para “Excluir todos os pedidos cancelados”, ele escreveu um DELETE e parou para perguntar:

O AI Shell propondo DELETE FROM orders WHERE status = 'cancelled' e perguntando Do you want to run this query? antes de executá-la

Cliquei em No, então o comando nunca chegou ao MySQL e o pedido continua lá.

O comando DELETE marcado como User rejected tool call em vermelho, após clicar em No

Passo 8 (opcional): deixe as queries somente leitura rodarem automaticamente

Aprovar cada SELECT fica cansativo. Clique no ícone de engrenagem e ative Always allow execution of read-only queries.

As configurações gerais do AI Shell com Always allow execution of read-only queries ativado, além de auto-compact e instruções personalizadas

Assim, as queries SELECT rodam sem perguntar. INSERT, UPDATE, DELETE, DROP, ALTER e qualquer coisa que o shell não consiga analisar continuam pedindo confirmação.

Leituras recomendadas

O Beekeeper Studio é uma GUI para MySQL gratuita e open source

Tenho usado o Beekeeper Studio no meu trabalho com MySQL ultimamente, e ele rapidamente se tornou uma das minhas ferramentas de banco de dados favoritas. A interface é limpa, moderna e sem distrações, o que facilita focar nas queries sem a bagunça de outras ferramentas. - Surendra Singh

O Beekeeper Studio é um cliente MySQL rápido, intuitivo e fácil de usar. Ele também suporta vários outros bancos de dados e funciona muito bem no Windows, Mac e Linux.

A versão do Beekeeper para Linux tem 100% dos recursos, sem atalhos e sem concessões.

O que os usuários de MySQL dizem sobre o Beekeeper Studio

Beekeeper Beekeeper Still a Newbie

Escolhi este programa depois de anos usando o phpMyAdmin — é como entrar em um mundo de qualidade superior; aqui, senti de verdade que o usuário é bem cuidado. O conceito, a implementação, a experiência prática — sou sinceramente grato ao Matthew por tudo isso.

Alex M

Ferramenta fantástica, a IDE mais prática que encontrei até hoje para administrar bancos Postgres e MySql - simplesmente funciona, sem complicação :-)

Pronto para melhorar seu fluxo de trabalho com MySQL?

download Baixar grátis