MCP 서버

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

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

웹·데스크톱·모바일의 Claude와 원격 MCP 서버를 지원하는 모든 클라이언트는 https://mcp.capydb.dev/mcp 에 연결합니다. 설치할 것도, 붙여 넣을 키도 없습니다. 도구가 처음으로 계정을 필요로 하면 클라이언트가 브라우저에서 CapyDB 로그인으로 안내하고, 거기서 사용할 워크스페이스를 고릅니다. 일회용 임시 데이터베이스는 로그인 전에도 사용할 수 있습니다.

연결은 에이전트 API 키이며, 설정 → API 키에 표시되고 언제든 폐기할 수 있습니다. 90일 후 만료되며, 그러면 클라이언트가 다시 연결하도록 요청합니다. Claude Code에서는 아래 명령으로 같은 URL을 추가합니다.

claude mcp add --transport http capydb https://mcp.capydb.dev/mcp

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

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

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

• -프로젝트: 목록, 생성, 조회. 인수하거나 폐기할 수 있는 일회용 에페메럴 데이터베이스
• -연결: 직접·풀링 연결 문자열과 K/V 스토어 자격 증명 조회
• -SQL: 읽기 전용 쿼리와 별도 도구로 데이터를 바꾸는 구문 실행, 결과는 구조화된 JSON으로 반환
• -스키마: 테이블, 컬럼, 인덱스, 확장 조회
• -프리뷰: 프리뷰 데이터베이스 생성, 목록, 초기화, 삭제
• -백업: 백업 생성과 목록, 덤프 내보내기, 복원 지점 생성, 프리뷰로 복원
• -가져오기: 다른 제공자로부터의 가져오기 시작과 추적
• -운영: 사용량, 로그, 관측성, 알림, 작업, 인덱스 제안

읽기 전용 도구는 읽기 전용이라고, 파괴적 도구는 파괴적이라고 스스로 밝히므로 클라이언트가 제한할 수 있습니다. WHERE 없는 UPDATE나 DELETE, 그리고 TRUNCATE는 컨트롤 플레인이 실행 전에 거부하고, 거부 메시지가 호출을 고치는 방법을 에이전트에게 알려 줍니다. MCP 서버는 이 검사를 절대 건너뛰지 않습니다. 그보다 위험한 작업은 도구 설명이 먼저 복원 지점을 만들라고 에이전트에게 지시합니다.

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

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