MCP 서버

Claude Code 같은 AI 도구가 DontCode 프로젝트에서 직접 작업하게 하세요: 터미널에서 로그인하고, 데이터베이스를 조회·수정하고, 마이그레이션을 실행하고, 파일을 관리합니다. 모두 동일한 v1 게이트웨이를 통해서요.

6분 읽기

MCP

DontCode Backend MCP 서버는 프로젝트를 AI 에이전트에게 도구 모음으로 노출하는 작은 로컬 프로그램입니다. dontcode 패키지에 포함되어 있으며 stdio로 실행되므로 Claude Code가 대신 실행합니다. 직접 호스팅할 것은 없습니다.

모든 도구는 v1 게이트웨이를 얇게 감싼 호출입니다. 에이전트는 게이트웨이가 허용하는 범위, 그리고 브라우저로 로그인한 경우 프로젝트에서 본인의 역할이 허용하는 범위만 수행할 수 있습니다.

DontCode가 처음이신가요? 전체 제품 문서는 여기에 있습니다: dontcode.co/docs

도구에 서버를 추가하세요. Claude Code에서는 프로젝트 루트의 .mcp.json에 아래 내용을 넣습니다(또는 claude mcp add 실행). 여기서는 API 키가 필요 없습니다. 처음 사용할 때 브라우저로 로그인합니다.

{
  "mcpServers": {
    "dontcode": {
      "command": "npx",
      "args": ["-y", "dontcode", "mcp"]
    }
  }
}

스테이징 게이트웨이를 가리키려면 DONTCODE_API_URL을 설정하세요. 비대화형 사용(CI, 스크립트)에서는 DONTCODE_API_KEY에 dc_ 프로젝트 키를 설정하면 브라우저 로그인을 건너뛸 수 있습니다.

토큰은 서버 측에서 사용자 계정에 묶여 있어 위조할 수 없습니다. 게이트웨이는 매 요청마다 프로젝트 역할을 확인하며, 멤버십을 해제하면 토큰도 즉시 무효화됩니다.

도구	기능
auth_login / auth_wait	브라우저로 로그인하고 토큰을 받습니다.
auth_status	현재 프로젝트, 내 역할, 가능한 작업을 표시합니다.
auth_logout	캐시된 토큰을 삭제합니다.
db_query	행 읽기: find, findFirst, count(where / select / orderBy 지원).
db_insert	한 행을 삽입합니다.
db_update	where 절에 일치하는 행을 수정합니다.
db_delete	where 절에 일치하는 행을 삭제합니다.
db_migrate	스키마 DDL(테이블 생성·변경·삭제, 인덱스)을 적용합니다.
storage_list	버킷의 파일을 나열합니다.
storage_get_url	파일의 공개 URL을 가져옵니다.
storage_temporary_url	짧은 수명의 서명된 URL을 가져옵니다.
storage_upload	텍스트 콘텐츠를 경로에 업로드합니다.
storage_remove	파일을 삭제합니다.
storage_move	파일을 이동하거나 이름을 변경합니다.

쓰기와 삭제는 표시되어 있어 에이전트가 변경 전에 확인을 요청합니다.

브라우저로 로그인하면 토큰에 프로젝트 역할이 담깁니다. 게이트웨이가 매 요청마다 이를 강제하므로, 에이전트는 본인이 할 수 있는 것 이상은 절대 할 수 없습니다.

dc_ 프로젝트 API 키(비대화형 경로)는 v1 게이트웨이의 나머지와 동일하게 프로젝트 한정 전체 권한을 가집니다.