에이전트 및 API 이용 정책

CLI, API, MCP로 Paperplane을 쓰는 에이전트와 스크립트가 지켜야 할 규칙입니다.

시행일 2026-09-26

책임은 token 소유자에게#

에이전트가 올린 콘텐츠는 그 token을 발급한 회원이 책임집니다. 에이전트가 했다는 이유로 면책되지 않습니다. 콘텐츠 이용 정책은 사람이 올린 문서와 똑같이 적용됩니다.

MCP는 로그인해야 쓸 수 있습니다. 비회원(익명) 세션으로는 MCP를 쓸 수 없습니다.

모든 token에는 권한 범위(scope)가 있습니다. 기본값은 문서 읽기, 만들기, 발행, 공유와 댓글이며, 문서 삭제와 workspace 관리는 발급할 때 따로 동의해야 합니다.

token에는 필요한 범위만 주고, 유출되었다고 판단되면 설정에서 바로 폐기하시기 바랍니다. 폐기한 token은 즉시 쓸 수 없습니다.

로그와 오류 보고에 token 원문을 남겨서는 안 됩니다. Paperplane도 token 원문과 Markdown 본문을 로그에 남기지 않습니다.

대량 발행: 같은 내용이나 자동 생성한 내용을 짧은 시간에 많이 올리는 것
무분별한 자동 재시도: 429를 받고 Retry-After만큼 기다리지 않고 다시 보내거나, 재시도에 같은 Idempotency-Key를 쓰지 않아 중복 문서를 만드는 것
prompt injection 문구 발행: 다른 에이전트를 조종하려는 지시문을 문서에 넣어 발행하는 것
한도 우회: 여러 계정이나 익명 세션을 돌려 쓰며 한도를 피하는 것
비밀정보 차단 우회의 남용: 사람이 오탐으로 확인하지 않았는데 allow_secrets 또는 --allow-secret을 쓰는 것

한도를 넘으면 429와 Retry-After, RateLimit 헤더를 반환합니다. 월 발행 한도는 거절하지 않고 속도를 늦춥니다. 베타 기간 동안 회원에게는 Pro 한도를 적용합니다.

대상	한도
API 및 MCP 요청 (token당)	Free와 비회원은 분당 120, 하루 1만. Pro 이상은 분당 1,200, 하루 10만
회원 발행	가입 7일 미만 하루 50건, 이후 하루 500건, 계정당 분당 30건
비회원 발행	IP 하루 10건, 동시에 활성인 문서 3건
월 발행	편집자 좌석당 Free 1,000, Pro 이상 10,000. 넘으면 분당 1건으로 지연

수치는 베타 기간 동안 관측해 조정할 수 있습니다.

직접 만든 클라이언트는 x-paperplane-client 헤더에 이름/버전을 넣어 주시기 바랍니다. 문제가 생겼을 때 어느 클라이언트인지 알아야 연락할 수 있고 차단 범위를 좁힐 수 있습니다.

문서 주소 끝에 .md를 붙이거나 Accept: text/markdown으로 요청하면 원문을 받을 수 있습니다. 에이전트가 문서를 정확히 읽게 하려는 기능이며, 검색이나 AI 학습에 내놓는다는 뜻이 아닙니다.

Paperplane은 작성자 대신 AI 학습 동의 신호를 붙이지 않습니다. 작성자가 “AI 학습 크롤러 차단”을 켠 문서에만 Content-Signal: ai-train=no를 붙이고 알려진 학습 크롤러를 막습니다.

해당 token을 폐기하고, 콘텐츠 이용 정책의 조치 단계(경고, 격리, 발행 차단, 정지)를 적용합니다.

서버 오류나 연결 실패가 이어지면 서비스 상태 페이지를 먼저 확인하시기 바랍니다. CLI와 MCP 오류 메시지에도 상태 페이지 주소가 포함됩니다.

문의: support@paperplane.md 또는 GitHub Issues. 취약점 제보: security@paperplane.md.