Wiki

개요

위키 도구는 회의 노트에서 추출한 엔티티, 개념, 관계를 검색하고 읽는 읽기 전용 도구입니다.

search_wiki: 키워드로 위키 페이지를 검색합니다.
get_wiki_page: 페이지 본문과 메타데이터, mentions, aliases, links를 반환합니다.
list_wiki_mentions: 페이지가 언급된 노트 단락을 반환합니다.
get_wiki_graph: 연결된 페이지의 노드와 엣지를 반환합니다.

search_wiki로 페이지를 찾고 list_wiki_mentions로 출처를 확인한 뒤 get_wiki_graph로 연결된 개념을 탐색하세요. 모든 위키 도구에는 list_workspaces에서 확인한 workspaceGuid를 전달하세요.

새 호출에서는 항상 workspaceGuid를 명시적으로 전달하세요. 기존 클라이언트와의 호환성을 위해 서버 스키마는 workspaceGuid 생략을 허용합니다. 생략하면 자격 증명에 연결된 워크스페이스나 접근 가능한 후보로 대상을 하나로 정할 수 있을 때만 서버가 워크스페이스를 선택합니다.후보가 여러 개면 오류 JSON의 status_code는 409이고 detail.workspaces에 각 후보의 guid와 name이 담깁니다. 하나를 선택해 다시 호출하세요. 유효한 자격 증명으로 접근 가능한 워크스페이스가 없으면 status_code는 404입니다.서버는 이 오류를 MCP HTTP 200 응답 안에서 result.isError: true로 반환합니다. 오류 JSON은 텍스트 콘텐츠에 담깁니다.

읽기 전용 (v1). 위키 페이지 생성, 이름 변경, 병합, 삭제는 지원하지 않습니다. 노트 내용은 search_notes나 get_note로 조회하세요.

접근 권한과 요금제 게이트

위키는 유료이며 워크스페이스에서 별도로 활성화해야 합니다. 도구는 항상 목록에 보이지만 호출할 때 요금제와 활성화 상태를 확인합니다. 다음 두 조건을 모두 충족해야 위키를 사용할 수 있습니다.

자격 있는 요금제: 워크스페이스의 구독이 Pro, Max, Team, Enterprise 중 하나입니다. Free와 Lite는 자격이 없습니다.
활성화됨: 워크스페이스 관리자가 해당 워크스페이스에서 위키를 켰습니다.

요금제나 활성화 조건을 충족하지 않으면 도구는 error_code와 status_code: 402가 담긴 오류 JSON을 반환합니다. MCP 응답은 HTTP 200이며 result.isError: true입니다.

`error_code`	의미	호출자가 취할 조치
`WIKI_PLAN_REQUIRED`	요금제에 위키가 포함되어 있지 않음(Free/Lite/구독 없음/비활성).	업그레이드. `action_url`은 요금제(B2C) 또는 팀 결제(팀 관리자) 페이지를 가리킵니다. 팀 구성원의 경우 `null`이며, 관리자에게 요청하라는 메시지가 표시됩니다.
`WIKI_NOT_ACTIVATED`	요금제 자격은 있으나 관리자가 위키를 활성화하지 않음.	워크스페이스 설정에서 위키를 활성화하거나(관리자), 관리자에게 요청(구성원). 업셀 없음. `required_plans`는 `null`입니다.

엔벨로프 형태(백엔드에서 그대로 전달됨):

{
  "success": false,
  "error_code": "WIKI_PLAN_REQUIRED",
  "message": "위키 기능은 Pro 이상 요금제에서 사용할 수 있어요. 웹에서 로그인 후 요금제를 업그레이드해 주세요.",
  "current_plan": "Lite",
  "required_plans": ["pro", "max", "team", "enterprise"],
  "action_url": "https://tiro.ooo/#pricing",
  "status_code": 402
}

current_plan: 워크스페이스의 현재 요금제 표시 이름, 구독이 없을 경우 null.
required_plans: WIKI_PLAN_REQUIRED의 업그레이드 대상. WIKI_NOT_ACTIVATED에서는 null. (Team Free Trial은 의도적으로 제외됩니다. 이미 보유 중인 체험이지 업그레이드 대상이 아니기 때문입니다.)
action_url: 조치를 취할 웹 링크, 호출자가 직접 조치할 수 없을 때(팀 구성원이거나 관리자에 의한 활성화)는 null.

`search_wiki`

키워드로 위키 페이지를 검색합니다. 가장 먼저 사용하세요. 반환된 pageGuid를 다른 도구에 전달합니다.

매개변수	타입	필수 여부	설명
`keyword`	string	필수	페이지 이름과 매칭되는 검색어.
`size`	number	선택	반환할 최대 결과 수. 기본값 있음, 최대 `100`.
`workspaceGuid`	string	필수	대상 워크스페이스의 GUID. `list_workspaces`에서 확인합니다.

순위가 매겨진 페이지 결과를 반환하며, 각각 pageGuid, name, pageType(예: CONCEPT, ENTITY), 관련도 점수를 포함합니다.

`get_wiki_page`

pageGuid(search_wiki에서 가져옴)로 위키 페이지 하나를 가져옵니다.

매개변수	타입	필수 여부	설명
`pageGuid`	string	필수	`search_wiki`가 반환한 페이지 식별자.
`workspaceGuid`	string	필수	대상 워크스페이스의 GUID. `list_workspaces`에서 확인합니다.

페이지 본문(설명 + 생성 상태)과 메타데이터(제목, 타입, mention/alias/link 수, 타임스탬프), 그리고 페이지의 구조화된 mentions, aliases, links를 반환합니다. 이어서 list_wiki_mentions로 페이지가 노트 전체에서 어디에 참조되는지 확인하세요.

`list_wiki_mentions`

위키 페이지를 언급하는 노트 단락들을 나열합니다.

매개변수	타입	필수 여부	설명
`pageGuid`	string	필수	페이지 식별자(`search_wiki` / `get_wiki_page`에서 가져옴).
`cursor`	string	선택	이전 응답에서 받은 페이지네이션 커서.
`limit`	number	선택	반환할 최대 결과 수. 최대 `100`.
`workspaceGuid`	string	필수	대상 워크스페이스의 GUID. `list_workspaces`에서 확인합니다.

언급 레코드(소스 노트, 단락, 추출된 텍스트, kind)와 페이지네이션 커서를 반환합니다.

`get_wiki_graph`

위키 지식 그래프의 노드+엣지 단면을 가져옵니다. { nodes, edges }를 반환하며, 각 엣지는 두 페이지 사이의 타입이 지정된 관계를 담습니다.

매개변수	타입	필수 여부	설명
`mode`	string	선택	`seed`(기본값), `expand`, `around`, `links` 중 하나(아래 참조).
`pageGuid`	string	조건부	`expand` / `around`의 기준 페이지.
`pageGuids`	string[]	조건부	`links`를 위한 명시적 페이지 집합.
`depth`	number	선택	`expand`의 탐색 깊이.
`radius`	number	선택	`around`의 이웃 반경.
`limit`	number	선택	반환되는 최대 노드 수. 기본값 `50`, 최대 `200`.
`q` / `type` / `since`	—	선택	`seed`를 위한 개요 필터.
`folderId`	number	선택	`seed` 전용: 이 폴더(하위 폴더 포함, 재귀) 내 노트가 언급한 페이지로 그래프를 제한합니다. 비어 있거나 접근할 수 없는 폴더는 빈 그래프를 반환합니다.
`workspaceGuid`	string	필수	대상 워크스페이스의 GUID. `list_workspaces`에서 확인합니다.

`mode`	반환
`seed`	워크스페이스에 대한 개요 그래프(선택적으로 `q` / `type` / `since` / `folderId`로 필터링).
`expand`	`pageGuid`에서 `depth`만큼 바깥으로의 탐색.
`around`	`radius`로 정한 페이지의 이웃.
`links`	명시적인 `pageGuids` 집합 간의 링크들.

결과 상한. get_wiki_graph는 최대 limit개의 노드(기본값 50, 최대 200)와 그 반환된 노드들 사이의 엣지만 반환합니다(연결되지 않은 엣지는 제거되므로 모든 엣지의 양 끝점이 nodes에 존재합니다). 기반 그래프가 상한보다 컸던 경우, 응답에 truncated: true가 설정됩니다. mode / q / type 또는 더 작은 radius / depth로 좁혀 집중된 단면을 얻으세요. 이를 통해 허브 페이지의 이웃이 무한정 큰 페이로드를 반환하는 것을 방지합니다.

클러스터 기반 탐색은 아직 노출되지 않았습니다. 웹 앱의 최신 그래프 탐색 뷰(overview/context/cluster)는 내부 전용입니다. MCP get_wiki_graph 도구는 seed / expand / around / links 모드를 노출합니다. 클러스터 탐색의 외부 노출은 로드맵에 있습니다.

권장 체인

워크스페이스 먼저 선택: list_workspaces → 선택한 workspaceGuid를 아래 모든 도구에 전달.
위키가 어떤 주제에 대해 아는 내용 찾기: search_wiki → get_wiki_page.
페이지가 노트에서 어디에 근거하는지 찾기: search_wiki → list_wiki_mentions.
개념들이 어떻게 연결되는지 탐색하기: search_wiki → get_wiki_graph(mode: "around", pageGuid).

홈

시작하기

API

음성 파일

웹훅

MCP

CLI

개발자 리소스

개요

접근 권한과 요금제 게이트

`search_wiki`

`get_wiki_page`

`list_wiki_mentions`

`get_wiki_graph`

권장 체인

​개요

​접근 권한과 요금제 게이트

​search_wiki

​get_wiki_page

​list_wiki_mentions

​get_wiki_graph

​권장 체인

개요

접근 권한과 요금제 게이트

`search_wiki`

`get_wiki_page`

`list_wiki_mentions`

`get_wiki_graph`

권장 체인