MCP
툴
search·read·remember·skills 입력 스키마.
MCP 서버는 네 가지 캐노니컬 툴을 노출합니다. 각 툴은 mode/format/action 으로 동작이 갈립니다.
search
워크스페이스 통합 검색 단일 진입점.
| 인자 | 타입 | 기본 | 설명 |
|---|---|---|---|
query | string | 필수 | 자연어 질의 (최대 4000자) |
mode | answer | evidence | timeline | context | answer | answer=합성 답변+인용, evidence=검증용 팩, timeline=기간 내 전수 열거, context=워크스페이스 다이제스트 |
conversation_id | string | 선택 | 멀티턴 스레드 id |
scope | workspace | personal | 선택 | 팀 전용 또는 개인 포함 |
limit | number | 20 (1–50) | 인용 개수 |
time_after / time_before | ISO 8601 | 선택 | 소스 시각 범위 |
author | string | string[] | 선택 | 원저자/발신자 부분일치 |
uploader | string | string[] | 선택 | 등록한 멤버(이름/이메일/id)로 제한 |
from / to | ISO 8601 | 선택 | timeline 윈도우 |
max_sources | number | 선택 | timeline/evidence 열거 개수 (최대 50) |
include_answer | boolean | true | answer 모드에서 false 면 인용만 |
model | string | 선택 | answer 모드 LLM (모델) |
locale | ko | en | 선택 | answer 모드 — 답변 언어 고정 (기본: 질문 언어를 따름) |
speed | normal | fast | normal | answer 모드 — fast 는 질의이해·리랭크를 건너뛰는 저지연 리더(품질 크게 하락), 라이브 UI 에만 |
detail | brief | detailed | detailed | fast 모드 상세도 |
"두 날짜 사이에 무엇이 바뀌었나"류 질문엔 mode="timeline" + from/to 를 쓰세요 — 상위 매칭만이 아니라 그 기간의 모든 신규/변경 소스를 열거합니다.
read
특정 문서/소스를 직접 엽니다(검증·정독용).
| 인자 | 타입 | 기본 | 설명 |
|---|---|---|---|
format | text | outline | grep | sources | text | 읽기 경로 분기 |
source_item_id | uuid | 주소 | 단일 문서 주소 (text/outline) |
source_id | uuid | 주소 | 소스 단위 주소 (outline path/grep) |
path | string[] | 선택 | 소스 내 하위 경로 |
heading_path | string[] | 선택 | 특정 헤딩 섹션으로 슬라이스 (text) |
page | number | 선택 | PDF 페이지 (text) |
kind | table | 선택 | 표 청크만 (text) |
query | string | 선택 (text) | 본문 내 문구 위치 찾기 (1–200자) |
fuzzy | boolean | false | query 매칭 완화 |
depth | number | 3 (max 8) | 아웃라인 트리 깊이 (outline) |
pattern | string | grep 필수 | 검색어 (1–400자) |
grep_mode | hybrid | semantic | literal | hybrid | grep 검색 모드 |
limit | number | 20 (max 100) | 결과/소스 상한 |
remember
메모를 저장합니다. save 전용 — 삭제는 REST DELETE /sources/api/items 로 합니다.
| 인자 | 타입 | 기본 | 설명 |
|---|---|---|---|
action | save | save | 저장 전용 |
content | string | 필수 | 본문 (1B–2MB) |
title | string | 선택 | 표시 제목 |
external_id | string | 선택 | 같은 값 재호출 = 버전 갱신 |
scope | private | workspace | private | 기본 개인. 팀 공유 시 workspace |
source_name | string | "MCP memory" | 소스 그룹 |
metadata | object | 선택 | 임의 JSON |
사용자가 명시적으로 "기억해/저장해" 할 때만 호출하세요. 추론한 사실을 자동 저장하면 채팅 기록(이미 색인됨)과 충돌합니다.
skills
워크스페이스 스킬 목록·불러오기.
| 인자 | 타입 | 기본 | 설명 |
|---|---|---|---|
name | string | 선택 | 생략 시 전체 목록, 주면 해당 스킬 전체 지침 |
질의가 스킬과 매칭되면 search 가 자동으로 적용해 matchedSkill 로 돌려주므로, 보통 이 툴을 따로 부를 필요는 없습니다.