Servidor MCP para agentes de codificação

funcional

Deixe Claude Code, Cursor, VS Code e Windsurf usar suas conexões salvas em modo somente leitura via MCP, sem compartilhar senhas.

O SQLLY pode rodar como um Servidor Model Context Protocol (MCP), assim, agentes de codificação como Claude Code, Cursor, VS Code, Windsurf e Claude Desktop podem usar as conexões que você já salvou no SQLly. O agente pode listar conexões, navegar por tabelas, ler definições de colunas, obter um resumo do esquema e executar uma SELECT de cada vez com um limite de linhas. Ele nunca vê uma senha, e conexões de produção são sempre recusadas.

  • Local e somente via stdio. O agente inicia sqlly-cli mcp no seu computador e se comunica com ele através da entrada e saída padrão. Nada escuta em uma porta de rede.
  • Somente leitura por padrão. Gravações são possíveis apenas se você escolher permitir, e mesmo assim cada uma abre no SQLly para você confirmar.
  • As senhas permanecem no seu chaveiro. O servidor faz login nos seus bancos de dados sozinho; o agente recebe apenas os nomes de conexão, o texto do esquema e as linhas de resultado.

Configuração

  1. Abrir Configurações › IA › MCP e encontre SQLLY como um servidor MCP.
  2. Escolha o Limite global: Somente leitura (padrão), ou Leitura/gravação com confirmação. Escolha quais conexões salvas serão expostas.
  3. Pressione o botão de copiar para o seu agente: Copiar para Claude Code, Copiar para Cursor, Copiar para VS Code, Copiar para Windsurf ou Copiar para Claude Desktop, e cole o trecho onde esse agente guarda seus servidores MCP.
  4. Peça ao agente para listar suas conexões SQLly.

Os snippets indicam o caminho completo para sqlly-cli, a ferramenta de linha de comando que acompanha o aplicativo. O SQLly a procura primeiro junto ao aplicativo e depois no seu PATH; se não encontrar nenhum dos dois, o trecho diz simplesmente sqlly-cli. As formas são:

# Claude Code
claude mcp add --transport stdio sqlly -- /path/to/sqlly-cli mcp

// Cursor, Windsurf and Claude Desktop
{ "mcpServers": { "sqlly": { "command": "/path/to/sqlly-cli", "args": ["mcp"] } } }

// VS Code (.vscode/mcp.json)
{ "servers": { "sqlly": { "type": "stdio", "command": "/path/to/sqlly-cli", "args": ["mcp"] } } }

O mesmo painel também possui uma lista de externo servidores MCP. Essa lista é a outra direção: servidores aos quais o SQLly se conecta para que o próprio assistente de IA dele saiba quais ferramentas eles oferecem. Você não precisa dela para permitir que um agente use o SQLly.

O que o agente pode fazer

FerramentaO que faz
list_connectionsLista as conexões expostas com seu mecanismo, servidor, banco de dados, ambiente e se cada uma é de produção ou somente leitura.
list_tablesLista as tabelas no banco de dados de uma conexão.
describe_tableColunas, tipos e nulidade de uma tabela.
get_schema_contextUm resumo do esquema dimensionado para um orçamento de tokens.
run_readonly_queryExecuta um SELECT e retorna até o limite de linhas. Qualquer outra coisa é recusada sem execução.
open_in_appAbre uma aba de consulta no SQLly, opcionalmente com SQL preenchido. Nada é executado.
propose_writePropõe uma instrução de alteração de dados para você confirmar no SQLly (somente quando gravações são permitidas).
get_proposal_statusSe uma proposta está pendente, aberta, executada, rejeitada ou expirada.

Modos somente leitura e leitura/gravação

O Limite global define o máximo que qualquer conexão permite. Cada conexão pode então ser ajustada para um valor menor: Herdar global, Bloqueado (não exposto de forma alguma), Somente leitura, ou Leitura/gravação com confirmação. Uma conexão nunca recebe mais do que o teto global.

Somente leitura é imposto pelo banco de dados, não apenas pela verificação de instrução do SQLly. No PostgreSQL, MySQL e MariaDB, cada consulta é executada em uma transação somente leitura que é sempre revertida; SQLite a executa como apenas consulta; SQL Server, que não possui transação somente leitura, a executa dentro de uma transação revertida mais uma verificação de instrução. No ClickHouse, somente a SELECT, e os comandos Redis são conferidos contra uma lista somente leitura.

Com gravações permitidas, propose_write nunca executa nada por conta própria. O SQLly abre a instrução em uma nova aba de consulta, mostra uma contagem estimada de linhas e um resumo do plano em uma linha quando o mecanismo permite, e só a executa pela caixa de diálogo de confirmação de sempre, depois que você aprovar.

A produção é zona proibida. Uma conexão é de produção quando o ambiente dela é Produção, ou quando você a marcou assim. O agente pode vê-la na lista, e todas as outras ferramentas a recusam, leitura inclusive.

Limites

  • Linhas e células. No máximo 100 linhas por consulta (o padrão e o limite), e valores longos de células são cortados em 200 caracteres por padrão (até 2000).
  • Limites de taxa. Por padrão são 60 consultas, 5 escritas e 2 alterações de esquema por minuto, ajustáveis até 600, 60 e 20.
  • Tempo limite de inatividade. O servidor para após 15 minutos sem uma solicitação por padrão (ajustável de 30 segundos a um dia).

O registro de atividades

O SQLly registra cada chamada de ferramenta que o agente faz, e o resultado de cada proposta, em um registro privado na sua máquina. Cada entrada tem o horário, ferramenta, conexão, banco de dados, duração, contagem de linhas e resultado. O SQL é armazenado com os valores ocultados, nunca com seus valores literais. Pressione Abrir atividade MCP nas configurações do MCP para navegá-lo, filtrar por ferramenta, resultado ou conexão, e exportá-lo como CSV ou JSON.

Edição Mac App Store

O sandbox da Apple impede que apps da App Store iniciem outros programas, então a edição da Mac App Store não pode atuar como servidor MCP para outros apps, nem iniciar servidores MCP locais (stdio). Servidores MCP acessados por HTTP continuam funcionando ali. Veja macOS e a Mac App Store.