개인부터 팀 차원으로 문서를 정리하고 관리할 수 있는 오픈소스 도구 Docmost가 출시되었습니다.

Notion처럼 쉽게 문서를 작성하고, Confluence처럼 팀 단위로 체계적으로 관리할 수 있으며, Cloud로 바로 사용하거나 자체 서버에 설치할 수 있어, 팀원과 함께 문서를 작성하고 검색·댓글·권한 관리까지 하나의 환경에서 처리할 수 있습니다.

여기에 MCP 연동까지 지원해 AI 에이전트를 활용한 ‘제2의 두뇌’처럼 사용할 수 있습니다.

이번 글에서는 Docmost의 주요 특징부터 설치·사용 방법, AI·MCP 연동, 실제 사용 전 알아두어야 할 주의사항까지 정리해보겠습니다.

Docmost 핵심 요약

• Docmost는 Notion과 Confluence의 장점을 결합한 오픈소스 협업 Wiki입니다. 문서를 쉽게 작성하면서 자체 서버나 Cloud에 구축해 팀의 지식을 한곳에서 관리할 수 있습니다.
• 실시간 공동 편집과 검색·댓글은 물론, 유료 플랜에서는 Kanban·Bases와 다이어그램까지 활용할 수 있습니다. 문서 관리뿐 아니라 프로젝트 업무와 기술 자료를 함께 정리하는 데 유용합니다.
• 유료 라이선스에서는 MCP를 통해 Claude Code·Codex·Cursor 같은 AI 에이전트와 연결할 수 있습니다. Docmost에 저장된 문서를 검색·불러오고, 새로운 내용을 추가하거나 기존 문서를 수정하는 방식으로 활용할 수 있습니다.
• 아직 개발이 진행 중인 프로젝트이며, Self-hosted 환경에서는 서버 운영도 직접 책임져야 합니다. Docker 업데이트와 백업, 보안 설정, 장애 대응까지 관리해야 하므로 도입 전 운영 환경을 함께 고려하는 것이 좋습니다. 

Docmost란?

Docmost는 기업이나 팀에서 문서와 지식을 직접 구축한 서버에서 작성·공유할 수 있도록 만든 오픈소스 협업 Wiki입니다.

Notion이나 Confluence처럼 페이지를 만들고 여러 사람이 함께 문서를 작성하고, 자체 서버나 클라우드에 직접 설치해 데이터를 관리할 수 있어, 기업이나 팀에서 흩어진 정보를 모아 관리하는 하나의 지식 저장소로 활용할 수 있습니다.

Docmost가 주목받는 이유

1. 자체 서버에서 문서를 관리하면서 

여러 사람이 함께 편집할 수 있습니다

Docmost는 Notion 같은 외부 SaaS에 문서를 저장하지 않고 회사 서버나 자체 클라우드에 직접 설치해 데이터를 관리할 수 있습니다.

내부 개발 문서, 업무 매뉴얼, 시스템 정보처럼 외부 서비스에 보관하기 부담스러운 자료를 기업이 직접 관리할 수 있다는 점이 큰 장점입니다.

여기에 여러 사람이 같은 문서를 동시에 수정할 수 있는 실시간 공동 편집 기능까지 제공해, Self-hosted 환경에서도 일반 협업 도구처럼 함께 문서를 작성하고 수정할 수 있습니다.

2. Notion처럼 쉽게 작성하면서 

프로젝트 업무까지 함께 관리할 수 있습니다

Docmost는 전통적인 Wiki처럼 별도의 문법을 익힐 필요 없이 일반 문서처럼 바로 작성할 수 있는 편집 환경을 제공합니다.

페이지와 하위 페이지를 만들어 문서를 체계적으로 정리할 수 있고, 여러 사람이 함께 작성하면서 팀별 Space로 업무를 나눠 관리할 수 있습니다.

또한 Bases와 Kanban 기능을 통해 프로젝트명, 담당자, 진행 상태, 마감일 같은 정보를 구조화해 관리할 수 있어 단순한 사내 Wiki를 넘어 프로젝트와 업무 데이터를 함께 관리하는 협업 공간으로 활용할 수 있습니다.

3. 문서 안에서 시스템 구조와 

업무 흐름까지 표현할 수 있습니다

Docmost는 Mermaid, Draw.io, Excalidraw 같은 다이어그램 도구를 문서 안에서 바로 사용할 수 있어 시스템 구조, 업무 흐름, 네트워크 구성, 개발 프로세스 등을 시각적으로 표현할 수 있습니다.

글만으로 설명하기 어려운 개발 문서나 업무 매뉴얼을 설명 문서와 구조도로 표현하고, 수정할 수 있어 기술 문서 관리에 특히 유용합니다.

4. 사내 문서를 AI 에이전트와 직접 연결할 수 있습니다

MCP를 연동해 Claude Code, Cursor 같은 AI 에이전트에서 Docmost에 저장된 문서를 직접 업무에 활용할 수 있습니다.

별도의 새로운 AI 도구로 옮길 필요 없이, 현재 사용 중인 개발 환경에서 Docmost의 개발 규칙, 프로젝트 문서, 배포 가이드 등을 검색하고 참고할 수 있어 회사 내부 지식을 AI 에이전트의 작업에 바로 연결해 활용하고 업데이트할 수 있습니다. 

Docmost 로컬 사용법

Docmost를 사용하는 방법은 크게 Docmost Cloud 사용, Docker를 이용한 Self-hosted 설치, 개발 환경에서 직접 실행하는 방식이 있습니다. 

이 중 Docmost의 공식 문서에는 Docker를 이용한 설치를 권장하고 있어, Docker를 통해 사용하는 방법을 알려드리겠습니다.

Docmost 설치하기

1. 서버에 Docker를 설치합니다 

먼저 Docmost를 실행할 서버에 Docker와 Docker Compose를 설치해야 합니다.

• Windows: Docker Desktop을 설치합니다. Docker Engine과 Docker Compose가 함께 설치됩니다.
• Mac: Docker Desktop을 설치합니다. Docker Engine과 Docker Compose가 함께 설치됩니다.
• Linux: Docker Engine과 Docker Compose Plugin을 직접 설치합니다.

2. Docmost 설치 파일을 다운로드합니다 

Docker 설치가 끝났다면 Docmost를 설치할 폴더를 만든 뒤 공식 docker-compose.yml 파일을 내려받아야 합니다.

터미널에서 위의 명령어를 입력해 docker-compose.yml 파일을 내려받습니다.

Docker Desktop을 실행한 뒤 위의 명령어를 입력해 Docmost와 PostgreSQL, Redis에 필요한 이미지를 다운로드하고 컨테이너를 실행합니다 

3. APP_SECRET을 설정합니다 

Docmost는 보안을 위해 APP_SECRET 값을 설정합니다. APP_SECRET은 Docmost가 로그인 정보나 세션 같은 중요한 데이터를 안전하게 보호하기 위해 사용하는 비밀 키로 기본값인 REPLACE_WITH_LONG_SECRET을 그대로 두면 Docmost가 정상적으로 실행되지 않습니다. 

APP_SECRET 값 설정을 위해 터미널에서 위의 명령어를 입력해 docker-compose.yml 파일을 엽니다. 

APP_SECRET이라 적힌 부분을 찾아 32자의 문자열을 임의로 입력합니다. 입력한 문자열은 추후 서버 이전이나 복구를 위해, 다른 곳에 저장해 보관하는 것을 추천드립니다.

변경한 APP_SECRET 설정을 적용해 Docmost를 다시 실행하기 위해 위의 명령어를 순서대로 입력합니다.

재설정한 APP_SECRET으로 Docmost가 정상 실행되는지 확인하기 위해 명령어를 입력해 컨테이너 상태를 확인합니다 

STATUS가 모두 Up으로 표시되면 Docmost와 PostgreSQL, Redis가 정상적으로 실행되고 있는 상태입니다. 

\Docmost 설치가 완료되면 브라우저에서 http://localhost:3000에 접속해 대시보드가 정상적으로 실행되는지 확인합니다. 

제대로 실행되었을 경우 Docmost 초기 설정 화면이 실행되며, Workspace 이름과 관리자 정보를 입력하는 창이 나타납니다. 

Docmost 문서 관리 환경 구성하기 

1. Workspace를 생성합니다 

Docmost 초기 설정 화면에 계정 정보를 입력해 Workspace를 생성합니다.

Docmost의 Workspace 대시보드가 화면이 나옵니다. 

프로젝트별로 사용할 새로운 Space를 위해 왼쪽 사이드바에서 Space를 클릭한 뒤 오른쪽 상단의 파란색 Create space 버튼을 클릭합니다.

각 항목에 Space 이름과 주소, 설명을 입력해 새로운 문서 공간을 생성합니다.

왼쪽 사이드바의 New page를 클릭해 새로운 문서를 만들고 필요한 내용을 작성합니다. 

하위 문서를 생성한 뒤에는 검색으로 필요한 자료를 빠르게 찾고, 댓글로 의견을 주고받으며, 다이어그램을 생성할 수 있어 팀이나 기업의 문서 관리와 협업에 활용하기 좋습니다. 

Docmost를 MCP로 

AI 에이전트와 연결하기

Docmost는 Claude Code나 Codex, Cursor 같은 외부 AI 에이전트에 MCP로 연동해 AI 에이전트에서 사용이 가능합니다.

1. Docmost에서 MCP 기능 활성화하기

* 이미지 출처: Docmost 메인 홈페이지

MCP 연동은 Docmost의 유료 라이선스에서 제공되는데, 초기 가입시 90일 무료 체험을 통해 체험해 볼 수 있습니다.

계정 등록이 완료 됐다면 프로필 아이콘을 클릭한 뒤 Workspace settings를 클릭합니다.

왼쪽 사이드 바 하단의 AI settings를 클릭한 뒤 중앙에 있는 MCP 섹션을 클릭합니다.

MCP 기능을 활성화한 뒤 MCP Server URL 주소를 복사합니다.

2. Claude에 MCP 주소 입력하기

Docmost의 MCP 주소를 입력하기 위해 터미널에서 Docmost에서 복사한 MCP의 주소를 위의 명령어에 이어붙여 입력합니다.

위의 명령어를 입력해 Docmost의 MCP 주소가 추가되었는지 확인합니다.

Claude에서 /mcp를 입력하면 Docmost가 추가된 것을 볼 수 있습니다. Docmost 위에서 Enter를 누른 뒤 계정 인증을 진행합니다.

1. Authenticate를 클릭한 뒤 Docmost 홈페이지에 등록한 계정을 연동합니다.

Docmost와 Claude Code를 MCP로 연동하면, Docmost에 저장된 내용을 불러와 참고하거나 새로운 내용을 추가 또는 기존 문서를 수정해 정리할 수 있습니다.

Docmost 요금제

Docmost 사용 시 주의사항

1. 아직 개발 중인 프로젝트입니다

Docmost는 Beta 테스트 및 기능이 추가되고 있는 중입니다. 그래서 성능이 온전하지 않고, AI 에이전트 연동 기능과 관련된 버그도 계속 수정되고 있습니다.

중요한 업무에 적용한다면 새 버전을 바로 Production 환경에 적용하기보다 별도 환경에서 확인한 뒤 사용 유무를 전하는 것이 안전합니다.

2. Self-hosted 환경에서는 서버 운영도 직접 해야 합니다 

Docmost를 Docker로 직접 설치하면 데이터와 문서를 자체 서버에서 관리할 수 있지만, 그만큼 서버 유지관리도 직접 책임져야 합니다.

초기 설치뿐 아니라 HTTPS 설정, 데이터베이스와 첨부파일 백업, Docker 업데이트, 장애 대응, 보안 설정까지 함께 관리해야 합니다.

따라서 서버 운영 경험이 많지 않거나 별도의 관리 인력이 없다면, 직접 설치하는 Self-hosted 방식보다 Docmost Cloud를 사용하는 편이 더 수월할 수 있습니다.

3. 로컬 환경과 AI 에이전트 환경은 별도로 연결해야 합니다 

ocker로 설치한 Self-hosted Docmost에서도 AI와 MCP 기능을 사용할 수 있지만, 기본 Community 버전에서는 지원되지 않으며 Business 또는 Enterprise 라이선스가 필요합니다.

라이선스를 적용한 뒤 Docmost에서 MCP 기능을 활성화하고, Claude Code·Codex 같은 AI 에이전트에 Self-hosted Docmost의 MCP Server URL을 별도로 등록해야 합니다.

또한 Self-hosted 환경과 Docmost Cloud는 서로 다른 환경으로 운영되기 때문에, 한쪽에서 작성한 문서나 계정이 다른 환경으로 자동 동기화되지는 않습니다. 

Cloud에서 사용하려면 별도로 문서를 옮기거나 해당 환경에서 다시 구성해야 합니다.

AI 프로젝트, 

전문가가 없어 멈춰 있나요?

ChatGPT를 도입했지만 실무에 맞지 않아 활용하지 못하고 있거나, 프롬프트 설계와 시스템 연동을 맡을 전문가가 없어 프로젝트가 지연되고 있다면, 지금 필요한 것은 새로운 모델이 아니라 실무를 이해하는 전문가입니다.

프로젝트 단계에 맞는 전문가를 연결합니다

• PoC 단계: 바이브 코딩으로 빠르게 프로토타입을 검증할 전문가
• 개발 단계: 반복 업무 자동화, 사내 데이터를 AI에 연동해 AX 시스템을 구축하는 전문가
• 운영 단계: 클라우드, 보안, 코드 검수까지 고려해 안정적인 운영 기반을 마련할 전문가

단순히 이력만 보고 소개하지 않습니다

프로젝트 목표, 기술 스택, 기존 시스템 연동 요건, 협업 방식까지 검토해 24시간 이내 가장 적합한 AI 전문 프리랜서를 추천합니다.프로젝트 시작부터 전담 매니저가 함께하며, 필요한 경우 보안 검증 완료된 전문가만 매칭합니다. 

3분 등록으로, 24시간 내 AI 전문가를 추천받으세요 

1. 기업 고객 회원가입
2. 기업 고객 상담 문의에 프로젝트 내역 입력(약 3분)
3. 프로젝트에 적합한 AI 전문 프리랜서 확인(24시간 이내)