Novel Mart Guide v1.2.0

📖 Novel Mart 사용 가이드

AI와 함께 소설을 집필하고 Novel Mart에 업로드하는 방법을 알아보세요.
✨ 별도 설치 없이 Chat에서 바로 사용 가능!

🚀 빠른 시작

별도 설치 없이 Cursor나 VSCode에서 바로 사용할 수 있습니다!

1PAT 토큰 발급받기

Settings → API 토큰 → 새 토큰 생성 → 복사

2MCP 설정 (아래 섹션 참고)

설정 파일에 토큰 추가 후 IDE 재시작

3Chat에서 명령어 입력

"노벨마트에 소설 올려줘" 라고 입력하면 끝!

✨ Novel Mart 특징

스마트 업로드

NEW

제목만으로 소설을 찾아 장을 추가. 없으면 자동 생성!

장 단위 저장

장당 최대 20,000자. 단편 소설에 최적화된 구조

MCP 연동

IDE에서 AI와 함께 집필한 소설을 명령 한 번으로 업로드

포인트 공유

Proposal Mart와 포인트 공유. 한 곳에서 충전 → 양쪽 사용

MCP 설정 방법

1️⃣ Personal Access Token 발급

Settings > API 토큰으로 이동
새 토큰 생성 클릭
토큰 이름 입력 (예: "Cursor IDE")
생성된 토큰 복사 (한 번만 표시됨)

2️⃣ Cursor IDE 설정

~/.cursor/mcp.json에 다음 내용 추가:

{
  "mcpServers": {
    "novel-mart": {
      "command": "npx",
      "args": ["novel-mart-mcp"],
      "env": {
        "NOVEL_MART_TOKEN": "pat_your_token_here"
      }
    }
  }
}

2️⃣ VSCode / VSCode Insiders 설정

프로젝트 루트에 .vscode/mcp.json 파일 생성

⚠️ 중요: VSCode는 "type": "stdio" 설정이 필수입니다!

{
  "servers": {
    "novel-mart": {
      "type": "stdio",
      "command": "npx",
      "args": ["novel-mart-mcp"],
      "env": {
        "NOVEL_MART_TOKEN": "pat_your_token_here"
      }
    }
  }
}

2️⃣ Claude Desktop 설정

~/Library/Application Support/Claude/claude_desktop_config.json에 다음 내용 추가:

{
  "mcpServers": {
    "novel-mart": {
      "command": "npx",
      "args": ["novel-mart-mcp"],
      "env": {
        "NOVEL_MART_TOKEN": "pat_your_token_here"
      }
    }
  }
}

🚀 MCP 도구 사용법

novelmart_write

NEW

제목 기반 스마트 업로드 - 소설을 자동으로 찾아 장을 추가하거나 업데이트합니다.

💡

"노벨마트 '나의 판타지'에 이 내용 올려줘" → 소설이 없으면 자동 생성 + 제1장 추가

💡

"NM '모험기'에 새 장 추가해줘" → 기존 소설에 다음 장 자동 추가

💡

"Novel Mart '판타지' 2장을 수정해줘" → 특정 장 업데이트

"노벨마트 내 서재에서 '판타지' 검색해줘"

제목으로 내 서재의 소설을 검색합니다 (최대 10개).

NEWnovelmart_search

"노벨마트에 업로드해줘"

현재 대화에서 작성한 소설을 Novel Mart에 업로드합니다 (ID 기반).

novelmart_upload

"내 소설 목록 보여줘"

내가 등록한 소설 목록을 조회합니다.

novelmart_list

"포인트 잔액 확인해줘"

현재 포인트 잔액을 확인합니다 (Proposal Mart와 공유).

novelmart_points

📚 지원 장르

💕 로맨스🧙 판타지🚀 SF🔍 미스터리😱 스릴러🎭 드라마😂 코미디📚 기타

💬 실전 예제

처음 소설 올리기

새로운 소설을 처음 업로드하는 방법 (최대 1장)

명령어

노벨마트에 판타지 소설 올려줘

제목: 드래곤 슬레이어
장르: FANTASY
설명: 평범한 대장장이가 전설의 용사가 되는 이야기

제1장 - 시작
옛날 옛적, 작은 마을에 한 대장장이 소년이 살았습니다...

결과

✅ 소설이 성공적으로 등록되었습니다! 📚 제목: 드래곤 슬레이어 📖 장 수: 1화 🔗 URL: https://proposal-mart.vercel.app/novel/...  ⚠️ 2장 이상은 novelmart_write로 한 장씩 추가하세요!

기존 소설에 이어쓰기

이미 등록한 소설에 새 장을 추가

명령어

노벨마트 "드래곤 슬레이어"에 3장 추가해줘

제3장 - 시련
에이든은 험난한 산을 넘어야 했습니다...

결과

✅ 새 장이 추가되었습니다! 📖 장: 제3장 - 시련 (3화) 📝 글자 수: 456자

파일에서 소설 업로드

마크다운 파일을 소설로 변환하여 업로드

명령어

@mynovel.md 파일을 노벨마트에 로맨스 소설로 올려줘  제목은 '봄날의 편지'로 해줘

결과

✅ 소설이 성공적으로 등록되었습니다! 📚 제목: 봄날의 편지 📖 장 수: 5화 (자동 분할) 📝 총 글자 수: 8,765자

여러 장 업로드하기

5장짜리 소설을 안전하게 업로드하는 방법

명령어

"5장짜리 소설을 노벨마트에 올려줘"

AI가 자동으로 한 장씩 처리:

1회: novelmart_upload(제목 + 1장)
2회: novelmart_write(2장)
3회: novelmart_write(3장)
4회: novelmart_write(4장)
5회: novelmart_write(5장)

결과

✅ 모든 장이 성공적으로 업로드되었습니다!  📚 제목: 나의 소설 📖 총 장 수: 5화 📝 총 글자 수: 12,345자 🔗 URL: https://proposal-mart.vercel.app/novel/...  💡 한 번에 1장씩 처리하여 안전하게 업로드했습니다!

소설 현황 파악

작성한 소설들의 통계 확인

명령어

노벨마트에 올린 내 소설들 현황 정리해줘

결과

📊 내 소설 현황 (3개)  | 제목 | 장르 | 조회 | 좋아요 | |------|------|------|--------| | 드래곤 슬레이어 | 판타지 | 123 | 15 | | 봄날의 편지 | 로맨스 | 45 | 8 |  💰 총 수익: 2,250P

🔧 트러블슈팅

'Unauthorized' 오류

해결 방법:

1.Settings → API 토큰에서 토큰 상태 확인
2.기존 토큰 삭제 후 새 토큰 생성
3.설정 파일에 새 토큰 입력
4.IDE 완전 재시작

MCP 서버가 인식되지 않음

해결 방법:

1.설정 파일 위치 확인 (~/.cursor/mcp.json)
2.JSON 문법 오류 확인 (쉼표, 따옴표 등)
3.Node.js 설치 확인 (v18 이상 필요)
4.IDE 완전 재시작

'장당 20,000자 초과' 오류

해결 방법:

1.장을 2-3개로 나누기
2.AI에게 '적절한 길이로 자동 분할해줘' 요청
3.각 장을 5,000~10,000자로 유지 (권장)

연결 오류 (fetch failed)

해결 방법:

1.인터넷 연결 확인
2.https://proposal-mart.vercel.app 접속 테스트
3.방화벽/VPN 설정 확인

⚠️ 주의사항

• 장당 최대 20,000자까지 저장 가능합니다.
• 성인 콘텐츠는 19+ 태그가 표시되며, 추후 성인인증이 필요합니다.
• 발행된 소설은 수정할 수 없습니다. 신중하게 발행해주세요.
• 포인트는 Proposal Mart와 공유됩니다.