실제 화면으로 따라 하는
7단계 핸즈온 가이드
로그인부터 문서 업로드, 파이프라인 모니터링, 저장소 탐색, 설정 커스터마이즈, 그리고 MCP로 AI 에이전트를 연결하기까지. 운영 화면 그대로 캡처한 스크린샷과 함께 순서대로 따라 해보세요.
로그인
저장소는 로그인한 사용자만 이용할 수 있습니다. 기본은 Microsoft 계정 SSO이며, 비상시에는 비밀번호 로그인도 지원합니다.
- /login 페이지에서 Microsoft로 로그인 버튼을 누르면 조직의 Microsoft 계정으로 바로 로그인됩니다.
- SSO를 사용할 수 없는 상황이라면 버튼 아래 비상용 비밀번호 로그인 텍스트를 클릭하세요. 이메일(또는 사용자명)과 비밀번호 입력 폼이 펼쳐지고, 비밀번호로 로그인 버튼으로 접속합니다.
- 로그인에 성공하면 문서 저장소(/storage/documents)로 이동합니다.
문서 업로드와 파이프라인 모니터링
문서를 올리는 순간 파이프라인이 자동으로 시작됩니다. OCR, 정제, 메타 생성, 온톨로지 인덱싱 4단계를 거쳐 조직의 지식으로 다듬어집니다.
- 문서 저장소 오른쪽 위 문서 업로드 버튼을 누릅니다. 업로드는 관리자·운영자 역할에서 사용할 수 있습니다.
- 모달에서 카테고리를 고르고 문서제목을 입력한 뒤(소제목은 선택), 문서 파일을 선택하고 업로드를 누릅니다. PDF, HWP, HWPX, DOC, DOCX, PPT, PPTX, TXT, MD, CSV, XLS, XLSX 형식을 지원합니다.
- 여러 파일을 한 번에 선택하면 입력한 제목의 한 문서로 묶여 처리됩니다.
- 업로드 후 화면 상단 처리 현황 버튼을 누르면 큐 상태와 작업별 진행률, 현재 단계(예: OCR 전사 3/12)를 실시간으로 확인할 수 있습니다. 실패한 단계는 재시도 버튼으로 그 지점부터 다시 실행합니다.
문서저장소 탐색 — 검색과 카테고리 필터
왼쪽 카테고리 레일로 분류를 좁히고, 텍스트 검색과 의미 검색 두 가지 모드로 원하는 페이지를 찾습니다.
- 왼쪽 카테고리 레일에서 분류를 선택하면 해당 카테고리의 페이지 목록이 펼쳐집니다. 전체를 선택하면 저장소 전체를 봅니다.
- 검색바의 텍스트 모드는 제목·서브타이틀을 검색하고, 의미 검색 모드는 하이브리드 RAG로 질의와 의미적으로 유사한 페이지를 유사도 점수 순으로 정렬합니다. 결과 수와 최소 유사도도 조절할 수 있습니다.
- 필터 칩으로 번역·메타 생성·인덱싱의 완료/미완료 상태를 걸러낼 수 있고, 오른쪽 토글로 갤러리/목록 보기를 전환합니다.
- 페이지 카드를 클릭하면 해당 페이지의 상세 화면으로 이동합니다.
문서 상세 — 원문·번역·메타데이터
문서 개요에서 요약과 메타데이터, 파이프라인 처리 상태를 한눈에 보고, 페이지 단위 리더에서 원문과 정제·번역 텍스트를 원본 이미지와 나란히 비교합니다.
- 왼쪽 분류 트리로 카테고리, 문서, 챕터, 페이지를 오갑니다. 오른쪽 패널에는 카테고리·챕터·페이지 수·문서 유형·키워드 같은 메타데이터와 처리 파이프라인 현황이 표시됩니다.
- 페이지를 열면 리더 상단에서 텍스트, 이미지, 텍스트+이미지, 청크 보기를 전환할 수 있습니다.
- 텍스트+이미지 보기는 원문, 텍스트 정제, 텍스트 번역 결과를 원본 스캔 이미지와 나란히 놓고 비교합니다.
- 키보드 ← →로 페이지를 이동하고, 1~4 숫자 키로 보기 방식을 바꿉니다.
에셋저장소 — 이미지도 지식으로
문서만이 아니라 이미지 에셋도 임베딩해 관리합니다. 자연어로, 또는 이미지로 유사한 에셋을 찾습니다.
- 상단 메뉴의 에셋저장소로 이동합니다. PNG, JPG, GIF 이미지를 에셋 업로드 버튼으로 올립니다.
- 의미 검색은 자연어로 에셋을 찾고, 이미지 검색은 이미지를 업로드해 시각적으로 유사한 에셋을 유사도 순으로 찾아줍니다.
- 문서 저장소와 동일하게 카테고리 레일, 상태 필터, 갤러리/목록 보기를 지원합니다.
설정 커스터마이즈 — 카테고리·프롬프트·사용자·조직
도메인에 맞는 분류 체계와 파이프라인 프롬프트를 직접 설계하고, 사용자 권한과 조직을 관리합니다. 설정은 관리자·운영자 역할에서 진입할 수 있습니다.
- 상단 메뉴 설정으로 들어가면 카테고리, 프롬프트, MCP 관리, 사용자 관리, 조직 관리 탭이 있습니다.
- 카테고리에서 저장소 분류와 표시 메타데이터를 관리합니다. 카테고리 추가로 도메인에 맞는 분류를 만드세요.
- 프롬프트에서는 카테고리별로 파이프라인 각 단계(OCR 전사, 텍스트 정제, 텍스트 번역, 메타데이터 추출, 엔티티/키워드 추출)의 프롬프트 버전을 관리합니다. 같은 단계에서 활성 버전은 하나만 유지됩니다.
- 사용자 관리에서 회원 권한(사용자·운영자·관리자)과 조직·계정 상태를, 조직 관리에서 운영자·사용자가 소속될 조직을 관리합니다. 두 메뉴는 관리자 전용입니다.
- 운영자는 카테고리·프롬프트·MCP 관리 탭만 보이며, 본인이 생성한 카테고리만 수정·삭제할 수 있습니다. 일반 사용자는 설정 중 MCP 관리만 이용합니다.
MCP로 에이전트 연결
API 키를 발급해 Claude, Cursor 등 어떤 MCP 클라이언트든 이 저장소에 연결합니다. 조직의 에이전트가 저장소의 지식을 직접 검색해 답합니다.
- 설정, MCP 관리에서 API 키 생성 버튼으로 키를 발급합니다. MCP 관리는 일반 사용자를 포함한 모든 역할이 이용할 수 있습니다.
- 발급된 키의 전체 값은 생성 직후 한 번만 표시됩니다. 즉시 복사해 안전한 곳에 보관하세요.
- 아래 연결 가이드에 MCP 서버 URL과 클라이언트별 설정 예시가 준비되어 있습니다. 목록에서 키를 클릭하면 해당 키 기준으로 예시가 채워집니다.
- Cursor는 .cursor/mcp.json에 서버 URL과 Authorization: Bearer 헤더를, Claude Desktop은 claude_desktop_config.json에 mcp-remote 설정을 붙여 넣습니다.
- Claude 웹(claude.ai)은 커스텀 커넥터에서 이름과 서버 URL만 입력하면 됩니다. OAuth 2.0 자동 클라이언트 등록(DCR)을 지원해 API 키 없이 로그인·승인만으로 연결됩니다.
- 일반 사용자 키는 문서·에셋 조회만 가능하고, 파일 저장·챕터 생성은 운영자·관리자 키에서만 동작합니다.
