Servidor MCP para agentes de codificação
funcionalDeixe 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 mcpno 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
- Abrir Configurações › IA › MCP e encontre SQLLY como um servidor MCP.
- Escolha o Limite global: Somente leitura (padrão), ou Leitura/gravação com confirmação. Escolha quais conexões salvas serão expostas.
- 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.
- 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
| Ferramenta | O que faz |
|---|---|
list_connections | Lista as conexões expostas com seu mecanismo, servidor, banco de dados, ambiente e se cada uma é de produção ou somente leitura. |
list_tables | Lista as tabelas no banco de dados de uma conexão. |
describe_table | Colunas, tipos e nulidade de uma tabela. |
get_schema_context | Um resumo do esquema dimensionado para um orçamento de tokens. |
run_readonly_query | Executa um SELECT e retorna até o limite de linhas. Qualquer outra coisa é recusada sem execução. |
open_in_app | Abre uma aba de consulta no SQLly, opcionalmente com SQL preenchido. Nada é executado. |
propose_write | Propõe uma instrução de alteração de dados para você confirmar no SQLly (somente quando gravações são permitidas). |
get_proposal_status | Se 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.
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.