개발자 문서

드래프터즈 MCP 서버

드래프터즈는 특허 명세서 작업(작성·검토·도면·선행조사·번역)을 MCP(Model Context Protocol) 툴·리소스로 노출합니다. 오케스트레이션은 클라이언트 모델이 하고, 이 서버는 도구와 자료만 제공합니다. 비개발자용 연결 안내는 온보딩 가이드를 보세요.

엔드포인트 · 전송

· 엔드포인트: https://drafters.kr/mcp
· 전송: Streamable HTTP(stdio 배포판 없음 — stdio 클라이언트는 mcp-remote 브리지 사용)
· 인증: Authorization: Bearer <PAT>

Claude Code 연결 예:

claude mcp add --transport http drafters https://drafters.kr/mcp \ --header "Authorization: Bearer $DRAFTERS_TOKEN"

stdio 전용 클라이언트(예: Codex) 연결 예 — mcp-remote 브리지:

[mcp_servers.drafters] command = "npx" args = ["-y", "mcp-remote", "https://drafters.kr/mcp", "--header", "Authorization: Bearer ${DRAFTERS_TOKEN}"]

인증 · 스코프

인증은 기존 PAT(drf_…) 체계를 그대로 씁니다 — drafters.kr/app/tokens에서 발급하고, sha256 저장·TTL·폐기(revoke)·감사로그가 붙습니다. initialize는 통과하되 툴 호출에서 스코프를 게이트합니다. 미인증·스코프 부족 시 next_action(다음 행동)이 담긴 자가수정형 에러가 돌아옵니다.

스코프용도
cases:read프로젝트·문서·자료·이력 조회
cases:write프로젝트 생성·문서 편집(2단 게이트)
jobs:read잡 조회·상태·완료 대기
jobs:enqueue잡 견적·착수
account:read계정 현황·요금·업그레이드 딥링크

툴 명세 (18종)

구분스코프용도
list_projects
내 프로젝트 목록 · 읽기전용
조회 cases:read 이 계정에 이미 있는 특허 작업 프로젝트
list_jobs
내 작업(잡) 목록 · 읽기전용
조회 jobs:read 이 계정의 백그라운드 작업
read_document
문서·결과물 읽기(페이지네이션) · 읽기전용
조회 cases:read / jobs:read 사용자 소유 프로젝트 본문 또는 잡 결과물의 내용을 읽는다
search_sections
등록특허 섹션 예시 검색 · 읽기전용
조회 cases:read 같은 기술분야 **실제 등록특허**에서 지정 섹션
list_materials
업로드 자료 목록 · 읽기전용
조회 cases:read 특정 프로젝트에 업로드된 자료
list_revisions
문서 수정 이력 · 읽기전용
조회 cases:read 프로젝트 문서의 수정 이력
get_account_status
계정·크레딧·진행 잡 현황 · 읽기전용
조회 account:read 이 계정의 현황을 한 번에 조회한다
get_pricing
요금·크레딧 단가·플랜 비교 · 읽기전용
조회 account:read 기능별 크레딧 단가표 + 플랜 티어 비교
request_plan_upgrade
플랜 업그레이드 딥링크 요청
계정 account:read 지정한 플랜으로 업그레이드하기 위한 **웹 딥링크**를 반환하고 업그레이드 의도를 audit 원장에 기록한다
create_project
새 프로젝트 만들기
생성 cases:write 새 작업 프로젝트
update_document
문서 일부 교체 제안(미반영)
쓰기 cases:write 사용자 소유 프로젝트 문서의 **일부 원문을 다른 내용으로 교체**하는 수정을 제안한다
append_document
문서 끝에 추가 제안(미반영)
쓰기 cases:write 사용자 소유 프로젝트 문서의 **기존 본문 끝에 내용을 덧붙이는** 추가를 제안한다
confirm_edit
제안한 수정을 문서에 반영
쓰기 cases:write update_document/append_document 로 제안
propose_job
작업 견적 + 확인 토큰 발급
jobs:enqueue 크레딧이 드는 백그라운드 작업을 착수하기 **전에** 예상 비용을 산정하고 confirm_token 을 발급한다
start_job
확인 토큰으로 작업 착수(과금)
jobs:enqueue propose_job 이 발급한 confirm_token 으로 실제 작업을 착수한다
wait_for_job
작업 완료 롱폴 대기 · 읽기전용
jobs:read 잡이 끝날 때까지 **롱폴로 대기**한다
get_job_status
작업 상태 즉답 스냅샷 · 읽기전용
jobs:read 잡의 현재 상태를 **즉답 스냅샷**으로 조회한다
upload_material
자료 업로드(base64)
쓰기 cases:write 특허 자료 파일
워크플로우 계약. 문서 편집은 update_document/append_document가 diff를 스테이징하고 confirm_edit로만 반영됩니다(2단 게이트). 잡은 propose_job이 견적·confirm_token(10분)을 주고 start_job이 그 토큰을 요구합니다. 완료 대기는 wait_for_job 롱폴, 중간 확인은 get_job_status 즉답, 결과 수령은 read_document입니다.

과금 원칙

대화는 무과금. 이 서버의 대화 계층에는 우리 LLM 호출이 없습니다 — 크레딧은 오직 백그라운드 잡(spec·check·search·figures·translate) 실행에만 듭니다. 조회·문서 편집·계정 조회는 무과금입니다.
잡 종류(feature:action)크레딧
search:pipeline10
studio:spec_full15
studio:chat_turn1
chat:turn_charge1
normalize:run2
compare:run2
figures:generate5
figures:instruct1
translate:per_10k_chars5

플랜·가격 전체 비교는 요금제를, 잔액·사용량은 툴 get_account_status를, 결제는 반드시 웹 체크아웃을 씁니다(MCP에 결제 실행 경로 없음 — request_plan_upgrade는 딥링크만 반환). 최상위 플랜을 넘는 수요는 엔터프라이즈 문의로 안내됩니다.

기밀 유지 고지

입력하신 발명 정보와 문서는 자체 인프라에서 처리하며, 모델 학습에 재사용하지 않습니다. 모든 조회·수정은 토큰 계정의 자원에만 적용되고(소유자 격리 — 남의 문서·잡은 보이지 않음), 툴 호출은 감사로그(append-only)에 기록됩니다. 결과물(AI 생성물)은 참고용 제안이며, 드래프터즈는 특허 명세서 작업을 돕는 보조 도구입니다. 최종 문서의 확인·확정은 변리사가 수행합니다. 자세한 내용은 이용약관보안을 보세요.