# 사내 지식베이스 구축, 세 가지 방식과 도구 선택 기준

- 게시: 2026.07.17
- 원문(HTML): https://trendbrief.news/articles/%EC%82%AC%EB%82%B4-%EC%A7%80%EC%8B%9D%EB%B2%A0%EC%9D%B4%EC%8A%A4-%EA%B5%AC%EC%B6%95-%EC%84%B8-%EA%B0%80%EC%A7%80-%EB%B0%A9%EC%8B%9D%EA%B3%BC-%EB%8F%84%EA%B5%AC-%EC%84%A0%ED%83%9D-%EA%B8%B0%EC%A4%80.html
- 발행: [트렌드브리프](https://trendbrief.news/)

![사내 지식베이스 구축, 세 가지 방식과 도구 선택 기준](https://trendbrief.news/assets/articles/%EC%82%AC%EB%82%B4-%EC%A7%80%EC%8B%9D%EB%B2%A0%EC%9D%B4%EC%8A%A4-%EA%B5%AC%EC%B6%95-%EC%84%B8-%EA%B0%80%EC%A7%80-%EB%B0%A9%EC%8B%9D%EA%B3%BC-%EB%8F%84%EA%B5%AC-%EC%84%A0%ED%83%9D-%EA%B8%B0%EC%A4%80/hero-1.png)

> 사내 지식베이스는 도구보다 운영이 문제다. SaaS 위키·오픈소스 자체 호스팅·docs-as-code 세 방식의 비용과 선택 기준, 컨플루언스·노션 무료 플랜 한도, MkDocs 시작법과 AI 검색 도입까지 개발팀 관점으로 정리했다.

사내 지식베이스를 새로 구축한다면 도구 선택보다 먼저 정할 것이 있다. 문서를 코드와 얼마나 가까이 둘지다. 방식은 크게 세 갈래로 나뉜다. 컨플루언스·노션 같은 SaaS 위키(설치 없이 구독해 쓰는 클라우드 서비스), Outline·Wiki.js 같은 오픈소스 자체 호스팅, MkDocs·Docusaurus 같은 docs-as-code(문서를 코드처럼 저장소에 두고 관리하는 방식)다. 아틀라시안 공식 요금 페이지에 따르면 2026년 7월 기준 컨플루언스 무료 플랜은 최대 10명·2GB까지 쓸 수 있고, 노션 공식 요금 페이지 기준 무료 플랜은 멤버가 2명 이상이면 워크스페이스당 블록 1,000개로 막힌다. 이 글은 소규모에서 중견 규모의 개발팀이 처음 지식베이스를 세우는 상황을 기준으로 방식별 비용과 선택 기준을 다룬다. 대기업용 컴플라이언스 요건이나 특정 제품 도입 매뉴얼은 다루지 않는다.

## 왜 대부분의 지식베이스는 방치되는가

지식베이스가 죽는 이유는 대개 도구가 아니라 운영 방식이다. 위키를 아무리 잘 골라도 아무도 찾지 않고 아무도 고치지 않으면 반년 만에 낡은 문서 무덤이 된다. 특히 개발 문서는 코드가 바뀌는 속도를 못 따라가면서 어긋난다. API 응답 형식은 진작 바뀌었는데 위키의 예제만 옛날 그대로 남아 있는 식이다.

그래서 도구 선정보다 먼저 세울 것은 최신화 규칙이다. 문서마다 소유자와 마지막 검토일을 남기고, 코드 리뷰(PR) 템플릿에 "관련 문서를 갱신했는가" 체크 항목을 넣는 방식이 실무에서 잘 통한다. 6개월 넘게 아무도 손대지 않은 문서는 검토 대상으로 표시해 두면, 최소한 낡은 내용을 최신 정보로 착각하는 사고는 줄어든다. 이 규칙 없이 도구만 바꾸면 무덤의 위치만 옮겨질 뿐이다.

## 어떤 도구를 골라야 할까

정답은 팀 구성과 데이터를 직접 쥐어야 하는 정도에 달렸다. 비개발 부서까지 함께 쓰면 SaaS 위키, 데이터를 사내 서버에 두어야 하면 오픈소스 자체 호스팅, 코드와 붙여 관리할 개발 문서면 docs-as-code가 무난한 기본값이다.

| 방식 | 대표 도구 | 비용 구조 | 적합한 경우 |
| --- | --- | --- | --- |
| SaaS 위키 | 컨플루언스, 노션 | 사용자당 월 구독 | 비개발 부서 포함 전사 |
| 오픈소스 자체 호스팅 | Outline, Wiki.js | 서버 운영비만 | 데이터 통제·좌석비 회피 |
| docs-as-code | MkDocs, Docusaurus | 정적 호스팅(사실상 무료) | 코드와 함께 갈 개발 문서 |

비용 감각을 잡아 두면 선택이 쉬워진다. [아틀라시안 공식 요금 페이지](https://www.atlassian.com/software/confluence/pricing) 기준 컨플루언스 무료 플랜은 최대 10명, 저장 용량 2GB까지다. [노션 공식 요금 페이지](https://www.notion.com/pricing) 기준 무료 플랜은 2인 이상 워크스페이스에서 블록 1,000개를 넘기면 새 블록 추가가 막히고, 유료 Plus 플랜은 연간 결제 시 멤버당 월 10달러, Business 플랜은 월 20달러다. 팀 인원이 열 명을 넘는 순간 무료 티어는 사실상 체험판이라고 보는 편이 안전하다.

오픈소스 자체 호스팅은 좌석당 비용이 없는 대신 운영 부담이 생긴다. Outline은 자체 호스팅할 때 PostgreSQL, Redis, S3 호환 스토리지, 그리고 구글이나 GitHub 같은 OAuth 로그인 제공자를 함께 갖춰야 한다(Outline 호스팅 문서 기준). 데이터를 외부 SaaS에 두기 어려운 조직이 아니라면, 이 서버 운영 비용이 좌석 구독료보다 정말 싼지부터 따져 봐야 한다.

## 개발 문서는 코드 옆에 두는 편이 오래간다

개발팀이라면 docs-as-code부터 검토할 만하다. 문서를 마크다운 파일로 코드 저장소 안에 두고, 코드처럼 PR로 리뷰하고 버전 관리하는 방식이다. 문서가 코드와 같은 저장소에 있으니 기능을 고치면서 문서도 같은 PR에서 함께 바꾸게 되고, 앞서 말한 "코드는 바뀌는데 문서는 그대로"인 어긋남이 구조적으로 줄어든다. 팀의 결정과 관행을 [코드 저장소 안 파일로 남기자는 접근](https://trendbrief.news/articles/boris-cherny%EC%9D%98-%EC%A0%9C%EC%95%88-%ED%8C%80-%EC%A7%80%EC%8B%9D%EC%9D%84-claude-md-%EC%8A%A4%ED%82%AC%EB%A1%9C-%EB%82%A8%EA%B2%A8%EB%9D%BC.html)과도 같은 결이다.

가장 손쉬운 출발점은 정적 문서 사이트 생성기다. [MkDocs](https://www.mkdocs.org/)는 마크다운 문서를 단일 설정 파일(mkdocs.yml) 하나로 정적 사이트로 만들어 준다. 파이썬 환경만 있으면 시작은 명령 몇 줄이면 된다.

```
pip install mkdocs-material
mkdocs new team-docs
cd team-docs
mkdocs serve
```

mkdocs serve를 실행하면 기본 포트 8000에서 로컬 미리보기가 뜬다. Material 테마를 쓰려면 mkdocs.yml에 테마만 지정하면 된다.

```
theme:
 name: material
```

Material for MkDocs는 문서를 빌드할 때 브라우저에서 도는 전문 검색을 기본으로 제공하고, 코드 블록 안 내용까지 검색 대상에 넣는다(Material for MkDocs 문서 기준). 완성된 사이트는 순수 HTML이라 GitHub Pages나 사내 S3에 그대로 올릴 수 있다. Docusaurus도 비슷한 결이며, 리액트 기반이라 문서 안에 인터랙티브 요소를 넣기 좋다.

## AI 검색을 붙이면 해결될까

검색 경험은 분명히 나아지지만, 문서 품질이 나쁘면 AI도 틀린 답을 자신 있게 내놓는다. 요즘 지식베이스 도구들은 사내 문서를 근거로 답하는 RAG(검색 증강 생성 — 질문과 관련된 사내 문서를 먼저 찾아 그 내용을 근거로 답을 만드는 방식)를 앞다퉈 붙이고 있다. Atlassian Intelligence와 노션 AI가 각 제품 안에서 이 방향으로 움직이고, 여러 SaaS를 가로질러 검색하는 전용 도구도 있다. Glean은 컨플루언스·슬랙·GitHub 등 100개가 넘는 업무 앱을 색인해 접근 권한을 지키면서 통합 검색을 제공한다고 밝히고 있다.

사서 붙이는 것만이 선택지는 아니다. [Cerebras 엔지니어링 블로그](https://www.cerebras.ai/blog/how-we-built-our-knowledge-base)(2026년 7월 게시)에 따르면, AI 칩 기업 Cerebras는 사내 지식베이스를 직접 구축해 출시 3개월 만에 하루 15,000건 이상의 질문을 처리하고 있고, 사람뿐 아니라 자동화와 AI 에이전트도 같은 인터페이스를 쓴다. 설계 원칙이 이 글의 문제의식과 닿아 있는데, Cerebras는 "모든 정보를 한 플랫폼에 모으자"는 단일 저장소 시도가 현실에서 거의 실패한다고 설명한다. 정보는 각자 편한 곳 — 슬랙 스레드, GitHub PR, Jira 메타데이터, 문서 제안 편집 — 에서 생성되므로, 기존 행동을 바꾸는 대신 각 플랫폼에서 데이터를 직접 추출하는 쪽을 택했다. 모든 소스의 임베딩·요약·메타데이터는 단일 Postgres 테이블에 쌓이고, 같은 스키마만 지키면 팀별 커스텀 소스도 파이썬 플러그인 스크립트 PR로 붙일 수 있다.

검색 설계도 참고할 만하다. Cerebras는 검색이 한 기법이 아니라 하이브리드라고 설명한다. 에러 메시지 같은 리터럴은 정확 일치가 최우선이고, "restore hangs after manifest load"와 "checkpoint stalls on the NFS mount"처럼 어휘가 다른 질문-답변은 벡터 유사도로 잇는다. 희귀 토큰 가중치가 "sounds good, thanks!" 같은 잡음을 걸러내고, 동점이면 최신 스레드가 이긴다. 검색기별 결과 목록은 RRF(reciprocal rank fusion)로 융합해 여러 검색기에서 고르게 상위인 문서가 한 검색기 1위를 이기게 하고, 마지막에 소형 리랭커 모델이 0~10점으로 재채점해 상위 10개만 남긴다. 이 검색 빌딩블록들은 "질문에 답해줘" 단일 엔드포인트가 아니라 LLM 없이 동작하는 단순 도구들로 MCP에 노출했고, Claude Code 같은 MCP 에이전트가 이를 직접 오케스트레이션한다.

다만 순서를 착각하면 안 된다. RAG는 검색 대상 문서가 정확할 때만 정확하다. 낡고 서로 모순된 문서 위에 AI 검색을 얹으면, 사람이 직접 찾을 때보다 오히려 더 그럴듯하게 포장된 오답이 나온다. AI 검색은 잘 관리된 지식베이스를 증폭하는 도구지, 방치된 지식베이스를 대신 정리해 주는 도구가 아니다. 이런 도입이 [실험 단계에서 멈추는 지점](https://trendbrief.news/articles/ai-%EB%8F%84%EC%9E%85-%EB%8B%A8%EA%B3%84-%EA%B0%9C%EB%B0%9C%ED%8C%80%EC%9D%B4-%EC%8B%A4%ED%97%98%EC%97%90%EC%84%9C-%EB%A9%88%EC%B6%94%EB%8A%94-%EC%A7%80%EC%A0%90.html)도 대개 여기, 즉 밑바탕 데이터 정리를 건너뛴 자리다.

![채팅·코드·문서·데이터베이스 네 소스가 깔때기로 모인 뒤 그물망·자석·모래시계 모양의 서로 다른 필터 세 개를 병렬로 지나 하나의 순위 카드 묶음으로 합쳐지는 선화](https://trendbrief.news/assets/articles/%EC%82%AC%EB%82%B4-%EC%A7%80%EC%8B%9D%EB%B2%A0%EC%9D%B4%EC%8A%A4-%EA%B5%AC%EC%B6%95-%EC%84%B8-%EA%B0%80%EC%A7%80-%EB%B0%A9%EC%8B%9D%EA%B3%BC-%EB%8F%84%EA%B5%AC-%EC%84%A0%ED%83%9D-%EA%B8%B0%EC%A4%80/sec-hybrid-1.png)

하이브리드 검색은 서로 다른 검색기의 결과를 융합해 한 목록으로 만든다 — 한 기법의 약점을 다른 기법이 메운다.

## 처음 세운다면 이 순서로

맨땅에서 시작한다면 도구 결제부터 하지 말고 범위부터 좁히는 편이 낫다. 온보딩 문서, 배포 절차, 장애 대응 런북처럼 없으면 당장 아픈 문서 대여섯 개를 먼저 정한다. 그다음 팀 구성에 맞는 방식 하나를 골라 — 개발 문서 위주면 docs-as-code, 부서가 섞이면 SaaS 위키 — 그 대여섯 개를 옮긴다. 마지막으로 최신화 규칙, 곧 소유자 지정과 PR 문서 갱신 체크를 팀 관례로 못박는다. 도구는 나중에 바꿀 수 있지만, 아무도 안 고치는 습관은 어떤 도구로도 못 고친다.

## 관련 글

- [LLM 에이전트 종류, 세 가지 축으로 구분하기](https://trendbrief.news/articles/llm-%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8-%EC%A2%85%EB%A5%98-%EC%84%B8-%EA%B0%80%EC%A7%80-%EC%B6%95%EC%9C%BC%EB%A1%9C-%EA%B5%AC%EB%B6%84%ED%95%98%EA%B8%B0.md)
- [추상 구문 트리(AST), 코드를 트리로 다루는 원리와 실무 도구](https://trendbrief.news/articles/%EC%B6%94%EC%83%81-%EA%B5%AC%EB%AC%B8-%ED%8A%B8%EB%A6%AC-ast-%EC%BD%94%EB%93%9C%EB%A5%BC-%ED%8A%B8%EB%A6%AC%EB%A1%9C-%EB%8B%A4%EB%A3%A8%EB%8A%94-%EC%9B%90%EB%A6%AC%EC%99%80-%EC%8B%A4%EB%AC%B4-%EB%8F%84%EA%B5%AC.md)
- [웹마스터 도구란? 색인과 크롤링을 점검하는 콘솔](https://trendbrief.news/articles/%EC%9B%B9%EB%A7%88%EC%8A%A4%ED%84%B0-%EB%8F%84%EA%B5%AC%EB%A1%9C-%EC%82%AC%EC%9D%B4%ED%8A%B8-%EC%83%89%EC%9D%B8%EA%B3%BC-%ED%81%AC%EB%A1%A4%EB%A7%81-%EC%A0%90%EA%B2%80%ED%95%98%EA%B8%B0.md)
- [OfficeCLI 사용법: 설치부터 AI 에이전트 연동까지](https://trendbrief.news/articles/officecli-%EC%82%AC%EC%9A%A9%EB%B2%95-%EC%84%A4%EC%B9%98%EB%B6%80%ED%84%B0-ai-%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8-%EC%97%B0%EB%8F%99%EA%B9%8C%EC%A7%80.md)
- [AI 도입 단계, 개발팀이 실험에서 멈추는 지점](https://trendbrief.news/articles/ai-%EB%8F%84%EC%9E%85-%EB%8B%A8%EA%B3%84-%EA%B0%9C%EB%B0%9C%ED%8C%80%EC%9D%B4-%EC%8B%A4%ED%97%98%EC%97%90%EC%84%9C-%EB%A9%88%EC%B6%94%EB%8A%94-%EC%A7%80%EC%A0%90.md)