에이전트용

MCP 서버

stdio 위의 40개 도구. 이미 대화하고 있는 어시스턴트가 데이터베이스 작업을 설명하는 대신 직접 수행합니다.

01

무엇인가

@capydb/mcp로 게시된 Model Context Protocol 서버입니다. stdio로 말하고 로컬에서 실행되며, 대시보드·CLI와 같은 컨트롤 플레인 API를 같은 조직 범위, 같은 권한, 같은 감사 기록으로 호출합니다.

런타임에 SDK에 의존하는 대신 직접 작성한 클라이언트를 담고 있어 설치가 작고 시작이 즉각적입니다.

02

설치

어떤 MCP 클라이언트든 서버 설정에 추가하세요. 인증은 서버가 알아서 처리합니다. 키 없이 처음 사용하면 브라우저에서 승인할 기기 로그인 URL을 돌려줍니다.

{
  "mcpServers": {
    "capydb": {
      "command": "npx",
      "args": ["-y", "@capydb/mcp"],
      "env": { "CAPYDB_API_KEY": "capy_live_..." }
    }
  }
}

03

클라이언트

  • -Claude Code와 Claude 데스크톱 앱
  • -Cursor, Windsurf 및 MCP를 지원하는 다른 에디터
  • -stdio로 Model Context Protocol을 구현한 모든 클라이언트 — 서버는 현재와 이전 프로토콜 개정판을 모두 제공합니다
  • -어떤 MCP SDK로든 만든 자체 에이전트

04

도구가 다루는 범위

  • -프로젝트: 목록, 생성, 조회, 이름 변경, 일시 중지, 재개, 삭제
  • -연결: 직접·풀링 연결 문자열 조회, 자격 증명 교체
  • -SQL: 프로젝트를 대상으로 쿼리와 구문 실행, 결과는 구조화된 JSON으로 반환
  • -스키마: 테이블, 컬럼, 인덱스, 확장 조회
  • -프리뷰: 프리뷰 데이터베이스 생성, 목록, 초기화, 삭제
  • -백업: 백업 목록, 복원 지점 생성, 프리뷰를 특정 시점으로 복원
  • -가져오기: 다른 제공자로부터의 가져오기 시작과 추적
  • -워크스페이스: 조직, 멤버, API 키, 사용량, 감사 기록

05

안전성

읽기 전용 도구는 읽기 전용이라고, 파괴적 도구는 파괴적이라고 스스로 밝히므로 클라이언트가 제한할 수 있습니다. 파괴적 SQL은 먼저 복원 지점을 요구하며, 서버는 구문을 실행하는 대신 에이전트에게 그렇게 하라고 알립니다.

프로덕션 데이터베이스를 덮어쓰는 복원은 의도적으로 도구로 공개하지 않습니다. 에이전트는 프리뷰로 복원할 수 있고 승격은 여러분이 합니다. 에이전트가 스스로 프로덕션 데이터를 덮어쓸 수는 없습니다.

06

진단

서버가 자신에 대해 말하는 모든 것은 표준 오류로 나갑니다. 표준 출력은 프로토콜 채널이기 때문입니다. 클라이언트에 도구 목록이 비어 보인다면, 답은 거의 언제나 서버가 아니라 클라이언트의 MCP 로그에 있습니다.