코딩 에이전트용 MCP 서버
정상 동작Claude Code, Cursor, VS Code 및 Windsurf가 MCP를 통해 비밀번호를 공유하지 않고 읽기 전용으로 저장된 연결을 사용하게 하세요.
SQLly는 로컬 모델 컨텍스트 프로토콜(MCP) 서버, 그래서 Claude Code, Cursor, VS Code, Windsurf, Claude Desktop 같은 코딩 에이전트도 SQLly에 저장해 둔 연결을 그대로 쓸 수 있습니다. 에이전트는 연결을 나열하고, 테이블을 탐색하고, 열 정의를 읽고, 스키마 요약을 받고, 다음을 하나 실행할 수 있습니다
SELECT 한 번에 정해진 행 수만큼만 읽습니다. 비밀번호는 전혀 보지 않고, 프로덕션 연결은 항상 거부합니다.
- 로컬 및 stdio 전용입니다. 에이전트는
sqlly-cli mcp사용자의 기기에서 시작되어 표준 입력과 출력을 통해 통신합니다. 네트워크 포트에서 아무것도 수신하지 않습니다. - 기본적으로 읽기 전용입니다. 쓰기는 직접 허용했을 때만 가능하고, 허용했더라도 각 쓰기는 SQLly에서 열려 직접 확인하게 됩니다.
- 비밀번호는 키체인에만 보관됩니다. 서버가 데이터베이스에 직접 로그인하며, 에이전트는 연결 이름, 스키마 텍스트, 결과 행만 받습니다.
설정 방법
- 열기 설정 › AI › MCP 그리고 찾아서 MCP 서버로서의 SQLLY.
- 다음을 선택하세요 글로벌 한도: 읽기 전용(기본값), 또는 확인 포함 읽기/쓰기. 에이전트에 공개할 저장된 연결을 선택하세요.
- 사용할 에이전트의 복사 버튼을 누르세요: Claude Code용 복사, Cursor용 복사, VS Code용 복사, Windsurf용 복사 또는 Claude Desktop용 복사, 해당 에이전트의 MCP 서버 설정 위치에 스니펫을 붙여 넣으세요.
- 에이전트에게 SQLly 연결 목록을 요청하세요.
스니펫이 전체 경로로 가리키는 것은 sqlly-cli, 앱과 함께 배포되는 커맨드라인 도구입니다. SQLly는 먼저 앱 옆에서 찾고, 그다음에는
PATH; 둘 다 없으면 스니펫은 다음을 그대로 표시합니다 sqlly-cli. 모양은 다음과 같습니다:
# 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"] } } }
같은 창에는 다음 목록도 있습니다 외부 MCP 서버 목록도 있습니다. 이 목록은 다른 방향입니다: SQLly가 연결하는 서버들로, 자신의 AI 도우미가 어떤 도구를 제공하는지 알 수 있게 합니다. 에이전트가 SQLly를 사용하도록 하는 데는 필요하지 않습니다.
에이전트가 할 수 있는 것
| 도구 | 기능 |
|---|---|
list_connections | 노출된 연결을 나열하되 엔진, 서버, 데이터베이스, 환경과 각 연결이 프로덕션인지 읽기 전용인지도 함께 보여 줍니다. |
list_tables | 연결의 데이터베이스에 있는 테이블을 나열합니다. |
describe_table | 한 테이블의 열, 유형, NULL 허용 여부. |
get_schema_context | 토큰 예산에 맞춘 스키마 요약. |
run_readonly_query | 실행되는 것은 다음뿐입니다 SELECT 그리고 행 제한까지만 반환합니다. 그 밖의 것은 실행하지 않고 거부됩니다. |
open_in_app | SQLly에서 쿼리 탭을 열며, SQL을 미리 채워 넣을 수도 있습니다. 아무것도 실행되지는 않습니다. |
propose_write | 데이터 변경 문을 제안하고 SQLly에서 확인하게 합니다(쓰기가 허용된 경우에만). |
get_proposal_status | 제안이 보류 중인지, 열렸는지, 실행되었는지, 거부되었는지, 만료되었는지. |
읽기 전용 및 읽기/쓰기 모드
그 글로벌 한도 모든 연결이 허용할 수 있는 최대치를 정합니다. 각 연결은 그보다 낮게 설정할 수 있습니다: 전역 설정 상속, 잠김 (전혀 노출되지 않음) 읽기 전용, 또는 확인 포함 읽기/쓰기. 한 연결이 전역 상한을 넘는 일은 없습니다.
읽기 전용은 SQLly의 문장 검사만이 아니라 데이터베이스 자체에서 강제됩니다. PostgreSQL, MySQL, MariaDB에서는 각 쿼리가 항상 롤백되는 읽기 전용 트랜잭션 안에서 실행되고, SQLite에서는 쿼리 전용으로 실행됩니다. 읽기 전용 트랜잭션이 없는 SQL Server는 항상 롤백되는 트랜잭션 안에서 실행하고 여기에 문장 검사를 더합니다. ClickHouse에서는 오직 SELECT-전용 화면이 적용되고, Redis 명령은 읽기 전용 명령 목록과 대조해 검사합니다.
쓰기 허용 시, propose_write 직접적으로 아무 것도 실행하지 않습니다. SQLly는 새 쿼리 탭에서 문을 열고, 추정 행 수와 엔진에서 지원하는 경우 한 줄짜리 실행 계획 요약을 보여주며, 사용자가 확인을 승인한 후에만 일반 확인 대화 상자를 통해 실행합니다.
제한 사항
- 행과 셀. 쿼리당 최대 100행(기본값이자 상한)이며, 긴 셀 값은 기본적으로 200자에서 잘립니다(최대 2000자까지 설정 가능).
- 속도 제한. 기본값은 분당 쿼리 60회, 쓰기 5회, 스키마 변경 2회이며, 최대 600, 60, 20까지 조정할 수 있습니다.
- 유휴 타임아웃. 서버는 기본적으로 요청이 없으면 15분 뒤에 멈춥니다(30초에서 하루까지 조정 가능).
활동 로그
SQLly는 에이전트가 수행하는 모든 도구 호출과 각 제안의 결과를 사용자 컴퓨터의 비공개 로그에 기록합니다. 각 항목에는 시간, 도구, 연결, 데이터베이스, 소요 시간, 행 수 및 결과가 포함됩니다. SQL은 리터럴 값을 가린 형태로만 저장되며 실제 값은 저장되지 않습니다. 다음을 누르세요 MCP 활동 열기 MCP 설정에서 열어 로그를 살펴보고, 도구·결과·연결별로 거르고, CSV나 JSON으로 내보낼 수 있습니다.
Mac App Store 버전
Apple의 샌드박스는 App Store 앱이 다른 프로그램을 시작하지 못하게 막기 때문에, Mac App Store 버전은 다른 앱을 위한 MCP 서버로 동작할 수 없고 로컬(stdio) MCP 서버를 띄울 수도 없습니다. HTTP로 접근하는 MCP 서버는 여기서도 동작합니다. 자세한 내용은 macOS 및 Mac App Store.