| 항목 | 동작 |
|---|---|
store_text 크기 |
요청 전체(JSON 이스케이프 포함)는 4 MiB 까지이고, 넘으면 도구 오류가 아니라 HTTP 413 으로 끊깁니다. 업로드 상한(앱 설정, 기본 32 MiB)을 더 낮게 정했다면 content 가 그 상한을 넘을 때 도구 오류입니다. 더 큰 텍스트는 나눠서 보관하거나 REST 조각 업로드(GET /api)를 씁니다 |
| 문자 집합 | 토큰으로 보내는 텍스트는 UTF-8 만 받습니다. EUC-KR · UTF-16 바이트나 깨진 글자(U+FFFD)가 든 본문은 422 invalid_charset 으로 거부하고 보관하지 않습니다. BOM 은 허용합니다 |
revises |
같은 이름의 파일이 가진 hash 를 넘깁니다. 그 밖의 값이나 이름이 처음인 때는 거부됩니다 |
repaired |
같은 내용을 다시 넣을 때 보관 파일이 손상되어 있으면 받은 내용으로 다시 쓰고 repaired=true 로 알립니다. 기록과 로그에도 남습니다 |
verify_files |
보관소 전체에서 한 번에 하나만 돕니다. 겹치면 MCP 는 도구 오류, REST 는 HTTP 429(verify_busy)이니 잠시 뒤 다시 부릅니다 |
limit · max_chars · offset |
범위 밖 값은 오류가 아닙니다. 0 이하의 limit · max_chars 는 기본값, 최대를 넘으면 최대로 자르고, 음수 offset 은 0 입니다. read_file 의 offset 이 끝을 넘으면 빈 text 입니다 |
tag_notices.status |
synonym 같은 뜻 · 숨은 이름(preferred 가 대표 이름), existing 체계 밖이지만 이미 쓰는 값, new 체계 밖이고 다른 파일에도 안 쓰인 값(similar 가 비슷한 이름). 대표 이름 그대로 붙이면 알림이 없습니다 |
| 없는 메서드 | 프로토콜 판 2026-07-28 이상은 JSON-RPC -32601 과 HTTP 404 입니다. 그보다 낮은 판은 JSON-RPC 오류가 아니라 HTTP 400 과 문자열이 올 수 있으니 오류 코드만으로 판단하지 마세요 |
이전: 연합 · 다음: 기록 · 태그 책임 · 세션 · 위로: MCP 연결 (AI)