ONLYOFFICE DocSpace MCP Server 개발자 가이드 요약
카테고리
프로그래밍/소프트웨어 개발
서브카테고리
개발 툴
대상자
AI 통합 및 문서 관리 시스템 개발에 관심 있는 개발자, IT 전문가
핵심 요약
- MCP Server는 LLM(대규모 언어 모델)과 외부 시스템 간 통합을 위한 Model Context Protocol(MCP) 기반으로 문서 워크플로우 자동화를 지원
DOCSPACE_BASE_URL,DOCSPACE_API_KEY등 환경 변수를 통해 유연한 설정 가능- 29개의 사전 정의된 도구(예:
files_create_folder,files_archive_room)로 문서 및 공간 관리 자동화 가능 - Apache-2.0 라이선스 적용으로 개방형 소스 프레임워크 활용 가능
섹션별 세부 요약
1. 서버 개요
- MCP Server는 ONLYOFFICE DocSpace 내 LLM 통합을 위한 중개 서버
- MCP 프로토콜을 통해 파일 처리, 사용자 관리, 워크스페이스 업데이트 등의 복잡한 작업을 직관적 처리 가능
- 협업, 자동화, 통합을 지원하는 AI 기반 워크플로우 핵심 구성 요소
2. 설치 및 구성
- JSON 파일을 통해 환경 변수 설정 (예:
DOCSPACE_API_KEY) - 설치 예시
```json
"mcpServers": {
"onlyoffice-docspace": {
"env": {
"DOCSPACE_BASE_URL": "https://example.com",
"DOCSPACE_API_KEY": "your-api-key"
},
"command": "npx",
"args": ["--yes", "@onlyoffice/docspace-mcp"]
}
}
```
- Claude Desktop과 같은 예제 구성으로 워크플로우 최적화 가능
3. 주요 구성 변수
DOCSPACE_BASE_URL: DocSpace 인스턴스의 기본 URL (모든 API 요청 필수)DOCSPACE_API_KEY: 보안 통신을 위한 유일한 API 키DOCSPACE_AUTH_TOKEN: DocSpace API 인증을 위한 토큰
4. MCP Server 도구 목록
- 파일 관리 도구
- files_create_folder: 폴더 생성
- files_get_file_info: 파일 메타데이터 조회
- files_upload_file: 문서 업로드
- 공간 관리 도구
- files_create_room: 프로젝트별 협업 공간 생성
- files_set_room_security: 사용자 접근 제어
- 모니터링 도구
- portal_get_quota: 저장 공간 사용량 모니터링
- settings_get_time_zones: 국제 팀 시간대 조정
5. 라이선스 및 활용
- Apache-2.0 라이선스 적용으로 개방형 소스 수정 및 배포 가능
- LLM 통합을 통해 보안성, 협업 효율성, 자동화를 동시에 달성
결론
- MCP Server를 활용하여 LLM 기반 문서 워크플로우 자동화를 구현할 때,
files_archive_room과 같은 도구로 프로젝트 종료 후 자동 아카이빙이 가능 - API 키 및 환경 변수를 통해 보안성 강화 및 유연한 설정 가능
- Apache-2.0 라이선스를 통해 개방형 소스 기반의 확장성 활용 권장