MCP 연결 가이드

DraftURL은 MCP(Model Context Protocol) 서버를 제공합니다. AI 클라이언트(Claude Desktop, Claude Code, Cursor 등)에서 DraftURL에 직접 문서를 생성하고 관리할 수 있습니다.

공식 레지스트리 등록: DraftURL MCP는 MCP Registry에 io.github.Bamdule/drafturl로 등록되어 있습니다.

MCP 서버 정보

항목	값
서버 URL	`https://drafturl.com/mcp/transport`
프로토콜	Streamable HTTP
인증	OAuth2 (PKCE)
설치	불필요 (원격 서버)

클라이언트별 연결 방법

Claude Code (터미널)

가장 간단한 방법입니다. 터미널에서 한 줄만 실행하세요.

claude mcp add --transport http drafturl https://drafturl.com/mcp/transport

이 명령어는 글로벌 설정으로 등록됩니다. 모든 프로젝트에서 DraftURL MCP를 사용할 수 있습니다.

프로젝트별로 설정하려면 프로젝트 루트에 .mcp.json 파일을 생성하세요:

{
  "mcpServers": {
    "drafturl": {
      "type": "http",
      "url": "https://drafturl.com/mcp/transport"
    }
  }
}

참고: 프로젝트 레벨 MCP는 첫 사용 시 신뢰 확인 다이얼로그가 표시됩니다.

Claude Desktop

claude_desktop_config.json 파일에 다음을 추가하세요.

{
  "mcpServers": {
    "drafturl": {
      "url": "https://drafturl.com/mcp/transport"
    }
  }
}

설정 파일 위치:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor

프로젝트 루트의 .cursor/mcp.json 파일에 다음을 추가하세요.

{
  "mcpServers": {
    "drafturl": {
      "url": "https://drafturl.com/mcp/transport"
    }
  }
}

인증

문서 조회, 수정, 삭제, 목록 도구는 로그인이 필요합니다. MCP 클라이언트에서 처음 인증이 필요한 도구를 호출하면, OAuth2 인증 흐름이 자동으로 시작됩니다.

브라우저에서 DraftURL 로그인 페이지가 열립니다.
이메일/비밀번호 또는 Google 계정으로 로그인합니다.
접근 권한을 승인합니다.
인증이 완료되면 MCP 클라이언트로 자동 돌아옵니다.

참고: create_document는 로그인 없이도 사용할 수 있지만, 비로그인으로 생성한 문서는 24시간 후 자동 만료됩니다. 로그인하면 영구 보관됩니다.

사용 가능한 도구

create_document — 문서 생성

HTML 또는 Markdown 문서를 생성하고 공유 URL을 발급합니다.

파라미터	필수	설명
`content`	O	문서 내용 (HTML 또는 Markdown)
`type`	O	문서 유형: `html` 또는 `markdown`
`title`	X	문서 제목 (최대 200자)
`password`	X	문서 비밀번호 (4~100자)

응답 예시:

{
  "id": "ELaEXHezsupz",
  "slug": "ELaEXHezsupz",
  "url": "https://drafturl.com/ELaEXHezsupz",
  "title": "마케팅 보고서",
  "docType": "html",
  "status": "active"
}

get_document — 문서 조회

slug로 문서의 내용과 메타데이터를 조회합니다. 소유한 문서만 조회 가능합니다.

파라미터	필수	설명
`slug`	O	문서 식별자 (URL의 마지막 부분, 예: `ELaEXHezsupz`)

update_document — 문서 수정

기존 문서의 내용, 제목, 비밀번호를 수정합니다. 변경할 항목만 전달하면 됩니다.

파라미터	필수	설명
`slug`	O	문서 식별자
`content`	X	새 내용 (HTML 또는 Markdown)
`title`	X	새 제목 (최대 200자)
`password`	X	새 비밀번호. 빈 문자열("")을 보내면 비밀번호 해제

delete_document — 문서 삭제

문서를 삭제합니다. 삭제 후 공유 URL은 더 이상 접근할 수 없습니다.

파라미터	필수	설명
`slug`	O	문서 식별자

list_documents — 문서 목록

내 문서 목록을 페이지네이션으로 조회합니다.

파라미터	필수	설명
`page`	X	페이지 번호 (0부터 시작, 기본: 0)
`size`	X	페이지 크기 (최대 50, 기본: 20)

사용 예시

AI 클라이언트에서 자연어로 요청하면 DraftURL MCP 도구가 자동으로 호출됩니다.

문서 생성 & 공유

사용자: "이번 분기 마케팅 실적을 HTML 보고서로 만들어서 DraftURL에 공유해줘"

AI: HTML 보고서를 작성하고 create_document를 호출합니다.

결과: https://drafturl.com/xK9mP2nQ — 이 URL을 팀원에게 공유하세요.

기존 문서 수정

사용자: "xK9mP2nQ 문서의 제목을 '2026 Q1 마케팅 보고서'로 바꿔줘"

AI: update_document를 호출하여 제목을 변경합니다.

문서 목록 확인

사용자: "내 DraftURL 문서 목록을 보여줘"

AI: list_documents를 호출하여 문서 제목, URL, 생성일 등을 표시합니다.

비밀번호 보호 문서 생성

사용자: "이 제안서를 DraftURL에 올리고 비밀번호 '1234'로 보호해줘"

AI: create_document에 password: "1234"를 포함하여 호출합니다.

Markdown 문서 공유

사용자: "README.md 내용을 DraftURL에 올려줘"

AI: 파일을 읽고 create_document에 type: "markdown"으로 호출합니다.

제한사항

항목	제한
문서 최대 크기	5MB
문서 최대 개수	30개 (Free 플랜)
비로그인 문서 만료	24시간
지원 형식	HTML, Markdown
Access Token 유효기간	1시간 (자동 갱신)

트러블슈팅

"Session not found" 에러

서버 업데이트 후 MCP 세션이 만료될 수 있습니다. Claude Code에서 /mcp 명령으로 drafturl 서버를 재시작하세요.

인증이 반복적으로 요구됨

Access Token은 1시간마다 자동 갱신됩니다. 브라우저 쿠키가 삭제되었거나 서버가 재시작된 경우 재인증이 필요할 수 있습니다.

Google 로그인이 안 됨

MCP 로그인 페이지에서 "Continue with Google" 버튼을 클릭하면 DraftURL 로그인 페이지로 이동합니다. Google 로그인 후 자동으로 MCP 인증 화면으로 돌아옵니다.

"DOCUMENT_LIMIT_EXCEEDED" 에러

Free 플랜은 최대 30개 문서를 생성할 수 있습니다. 기존 문서를 삭제한 후 다시 시도하세요.