ONLYOFFICE DocSpace MCP 서버

“ONLYOFFICE DocSpace” MCP 서버란 무엇인가요?

ONLYOFFICE DocSpace MCP 서버는 AI 어시스턴트 및 도구와 협업 문서 관리 플랫폼인 ONLYOFFICE DocSpace를 연결하는 브릿지 역할을 합니다. 이 서버는 Model Context Protocol(MCP)을 통해 DocSpace의 데이터와 작업을 노출하여, 문서·공간·사용자·권한과 상호작용하는 AI 기반 워크플로우 및 자동화를 실현합니다. 개발자는 이 서버를 활용해 워크스페이스 데이터 쿼리, 파일 관리, 협업 작업 오케스트레이션, 외부 API/서비스와의 통합이 가능한 어시스턴트를 만들 수 있습니다. 이를 통해 문서 관련 작업의 자동화, 안전한 파일 접근, 고급 문서 관리 시나리오를 표준 프로토콜 인터페이스로 손쉽게 구현할 수 있습니다.

프롬프트 목록

사용 가능한 저장소 파일에서 프롬프트 템플릿이 언급되지 않았습니다.

리소스 목록

사용 가능한 저장소 파일에서 별도의 MCP 리소스가 설명되어 있지 않습니다.

도구 목록

사용 가능한 저장소 파일에서 별도의 도구 정의가 발견되지 않았습니다. 서버는 DocSpace API 기능을 노출할 수 있지만, MCP 도구 이름이나 세부 내용은 없습니다.

이 MCP 서버의 활용 사례

• 협업 문서 관리: AI 어시스턴트가 DocSpace 내에서 문서 업로드, 공유, 권한 관리를 자동화하여 팀 워크플로우를 간소화합니다.
• 워크스페이스 자동 오케스트레이션: 개발자가 공간, 폴더, 사용자 접근 권한을 프로그래밍 방식으로 관리할 수 있어 대규모 조직의 효율을 높입니다.
• AI 기반 파일 검색: AI 도구와 연계해 DocSpace에 저장된 파일과 문서의 지능형 검색, 요약 기능을 제공합니다.
• API 연동 문서 자동화: DocSpace를 외부 API(예: CRM, 프로젝트 관리)와 연결해 엔드투엔드 워크플로우 자동화를 실현합니다.
• 안전한 문서 처리: 환경 변수 기반 인증을 활용하여, 민감한 문서 작업을 허가된 AI 에이전트만 안전하게 수행할 수 있습니다.

설정 방법

Windsurf

1. 시스템에 Node.js가 설치되어 있는지 확인하세요.
2. Windsurf 설정 파일을 찾으세요.
3. 아래 JSON을 사용해 mcpServers 객체에 ONLYOFFICE DocSpace MCP 서버를 추가하세요:

   {
     "onlyoffice-docspace": {
       "command": "npx",
       "args": ["--yes", "@onlyoffice/docspace-mcp@latest"]
     }
   }
   

4. 설정 파일을 저장하고 Windsurf를 재시작하세요.
5. MCP 서버 로그 또는 Windsurf UI에서 설정이 제대로 되었는지 확인하세요.

API 키 보안:
설정 파일에서 환경 변수로 민감한 키를 추가하세요:

{
  "env": {
    "DOCSPACE_BASE_URL": "${input:docspace_base_url}",
    "DOCSPACE_API_KEY": "${input:docspace_api_key}"
  },
  "inputs": [
    {"type": "promptString", "id": "docspace_base_url", "description": "DocSpace 인스턴스의 기본 URL."},
    {"type": "promptString", "id": "docspace_api_key", "description": "DocSpace에 접근하기 위한 API 키.", "password": true}
  ]
}

Claude

1. Node.js가 설치되어 있지 않다면 설치하세요.
2. Claude 설정 파일을 여세요.
3. MCP 서버를 추가하려면 아래 JSON을 삽입하세요:

   {
     "onlyoffice-docspace": {
       "command": "npx",
       "args": ["--yes", "@onlyoffice/docspace-mcp@latest"]
     }
   }
   

4. 변경사항을 저장하고 Claude를 재시작하세요.
5. 서버가 정상적으로 실행되고 접근 가능한지 확인하세요.

Cursor

1. Node.js가 설치되어 있는지 확인하세요.
2. Cursor 설정 파일을 수정하세요.
3. DocSpace MCP 서버를 추가하세요:

   {
     "onlyoffice-docspace": {
       "command": "npx",
       "args": ["--yes", "@onlyoffice/docspace-mcp@latest"]
     }
   }
   

4. 저장 후 Cursor를 재시작해 서버를 활성화하세요.
5. 시스템 로그에서 정상적으로 시작되었는지 확인하세요.

Cline

1. 필요하다면 Node.js를 설치하세요.
2. Cline 설정 파일을 여세요.
3. MCP 서버를 아래와 같이 구성하세요:

   {
     "onlyoffice-docspace": {
       "command": "npx",
       "args": ["--yes", "@onlyoffice/docspace-mcp@latest"]
     }
   }
   

4. 설정을 저장하고 Cline을 재시작하세요.
5. MCP 서버가 오류 없이 실행되는지 확인하세요.

API 키 보안:
위 Windsurf 예시처럼 환경 변수로 설정하세요.

플로우 내에서 MCP 활용 방법

FlowHunt에서 MCP 사용하기

FlowHunt 워크플로우에 MCP 컴포넌트를 추가하고, AI 에이전트와 연결하여 MCP 서버를 통합할 수 있습니다:

MCP 컴포넌트를 클릭하면 설정 패널이 열립니다. 시스템 MCP 설정란에 아래 형식의 JSON으로 MCP 서버 정보를 입력하세요:

{
  "onlyoffice-docspace": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

설정이 완료되면, AI 에이전트가 이 MCP를 툴로 활용해 모든 기능과 역량을 사용할 수 있습니다. “onlyoffice-docspace"를 실제 MCP 서버 이름으로, URL을 본인의 MCP 서버 주소로 변경하는 것을 잊지 마세요.

개요

공개된 정보를 기반으로 ONLYOFFICE DocSpace MCP 서버 저장소는 기본적인 설정 가이드와 라이선스 정보는 제공하지만, 프롬프트, 리소스, 도구에 대한 자세한 문서는 부족합니다. DocSpace용 MCP 서버로는 동작하지만, 개발자 온보딩을 위한 추가 문서가 보강되면 좋겠습니다. 즉각적인 활용성과 투명성 측면에서 3/10점을 부여합니다.

MCP 점수