Specify

• 지식 검색 — 팀의 Specify 워크스페이스 지식을 의미 기반(본문 시맨틱)과 제목 매칭으로 함께 검색한다. 코딩 중 도메인·요구사항·결정·용어에 대한 가정이 필요할 때, 추측하기 전에 먼저 호출하라. 결과의 snippet 은 히트한 본문 발췌이고, nodeId 로 read_document 를 호출하면 전문을 얻는다. 워크스페이스에 연결된 외부 커넥터(Notion/Slack/Jira/Linear/Drive)도 같은 호출에서 출처별 그룹으로 함께 검색된다.
• 문서 읽기 (윈도우) — search/browse 결과의 nodeId 로 Specify 문서 본문을 가져온다. text 문서는 기본 전문을, PDF 등 업로드 파일은 윈도우 단위로 반환한다 — search 의 snippet 을 around 로 넘기면 해당 위치 주변을 읽고, offset/page 로 다른 구간을 탐색한다.
• 문서 트리 탐색 — 정확한 검색어가 없을 때 워크스페이스 문서 트리(폴더·최근)를 탐색해 어떤 지식이 있는지 발견한다.
• 문서 생성 — 워크스페이스에 새 text 문서를 만든다(본문은 markdown). 조사 결과·결정사항처럼 팀이 다시 찾을 지식을 남길 때 사용하라. 생성 문서는 앱에 실시간 표시되고 RAG 인입 후 search 로도 검색된다. parentNodeId(폴더)를 지정하면 그 아래에 생성된다(미지정 = 루트). mcp:write scope 토큰 필요.
• 문서 편집 — 기존 text 문서를 편집한다. search 에 현재 본문 일부를 정확히(공백·줄바꿈 포함) 넣으면 replace 로 교체되고, search 를 생략하면 문서 끝에 replace 를 추가(append)한다. 편집 전 read_document 로 현재 본문을 확인하라. 업로드 파일(PDF 등)은 편집 불가. mcp:write scope 토큰 필요.

Schemas and invoke metadata: Directory API