이 장에서는 AI 도구가 매뉴얼웍스 문서를 조회하고 검색할 때 사용하는 MCP 도구를 설명합니다. 문서 검색에는 다음 세 가지 도구를 사용합니다.

• 문서 목록 조회(get_documents)

• 키워드 검색(search)

• 시맨틱 검색(semantic_search)

문서 목록 조회

사용자가 접근할 수 있는 문서 목록을 가져옵니다. 책, 아티클, 블로그 유형 문서만 포함합니다. AI 도구에서 다음과 같이 요청합니다.

내 문서 목록을 보여줘.

각 문서의 아이디와 제목을 반환합니다. 검색이나 교정 작업을 시작하기 전에 어떤 문서가 있는지 확인할 때 사용합니다.

특정 프로젝트의 문서만 보려면 프로젝트 아이디를 함께 전달합니다. 프로젝트 아이디는 get_projects 도구로 확인합니다.

"사용자 가이드" 프로젝트의 문서만 보여줘.

키워드 검색

단어 단위로 문서를 검색합니다. N-gram 색인을 기반으로 동작합니다. AI 도구에서 다음과 같이 요청합니다.

"API 키" 키워드로 문서를 검색해줘.

일치한 단락을 문서별로 묶어서 반환합니다. 각 단락에는 단락 유형, 장 제목, 내용이 포함됩니다.

검색 범위를 특정 문서로 제한하려면 문서 아이디를 함께 전달합니다.

"API 키" 키워드로 다음 문서에서만 검색해줘. [문서 아이디]

시맨틱 검색

의미 기반으로 문서를 검색합니다. 사용자가 접근할 수 있는 활성 챗봇을 모두 사용해 검색하고 결과를 합쳐서 반환합니다.

"권한 설정 방법"에 대해 시맨틱 검색해줘.

각 결과에는 문서 아이디, 장 아이디, 단락 아이디, 내용이 포함됩니다. 이 아이디들은 다른 MCP 도구에 그대로 전달해서 후속 작업으로 이어갈 수 있습니다.