ONLYOFFICE DocSpace MCP 서버

(MCP)은 대규모 언어 모델(LLM)과 외부 시스템 간의 컨텍스트를 관리하기 위한 표준화된 프로토콜입니다. 이 저장소는 를 위한 MCP 서버를 제공합니다.

DocSpace MCP 서버는 AI 도구를 ONLYOFFICE DocSpace에 직접 연결합니다. 이를 통해 AI 에이전트, 어시스턴트 및 챗봇은 자연어 상호 작용을 통해 룸 관리, 파일 공동 작업, 권한 처리 및 문서 워크플로 자동화를 수행할 수 있습니다.

주요 기능

• 세밀한 제어가 가능한 도구 - 논리적 도구 세트로 구성된 도구에 액세스하며, 세밀한 활성화/비활성화 기능 및 메타 도구를 제공합니다.

• 다양한 전송 프로토콜 - stdio, SSE 및 Streamable HTTP 전송을 지원합니다.

• 다양한 인증 방식 - API 키, 개인 액세스 토큰, 기본 인증 및 동적 클라이언트 등록을 포함한 OAuth 2.0을 지원합니다. 예제를 참조하세요.

• 요청 수준 구성 - 사용자 지정 HTTP 헤더를 사용하여 세션 초기화 중에 인증 및 도구 선택을 구성할 수 있습니다.

• 다양한 배포 형식 - Docker 이미지, Docker MCP 서버, MCP 번들 및 Node.js 애플리케이션으로 제공됩니다.

사용 사례

• 룸 관리: 룸 생성, 업데이트 및 보관. 룸 유형 구성, 멤버십 관리 및 액세스 수준 제어.

• 폴더 및 파일 작업: 폴더 생성, 문서 업로드, 항목 일괄 복사 또는 이동, 콘텐츠 이름 변경 또는 삭제, 파일 또는 폴더 세부 정보 확인.

• 공동 작업 및 권한: 사용자 초대 또는 제거, 보안 설정 조정, 룸 및 공유 공간에 대한 현재 액세스 권한 검토.

• 콘텐츠 액세스: "내 문서" 또는 "룸" 폴더 검색, 폴더 콘텐츠 가져오기, 파일을 텍스트로 다운로드 및 진행 중인 파일 작업 모니터링.

• 인원 디렉터리: 포털의 모든 인원을 나열하여 초대 및 액세스 관리를 간소화.

DocSpace MCP 서버에 클라이언트 연결하기

모든 MCP 클라이언트를 사용하여 DocSpace MCP 서버에 연결할 수 있습니다. Claude Desktop, Cursor, Windsurf 등과 같은 인기 있는 클라이언트를 다루었으며, 여기에서 관련 내용을 읽어볼 수 있습니다.

원격 DocSpace MCP 서버

원격 DocSpace MCP 서버는 ONLYOFFICE에서 호스팅하며 AI 에이전트 내에서 DocSpace 도구를 가장 빠르게 시작할 수 있는 방법을 제공합니다. 머신에 아무것도 배포하거나 구성할 필요 없이 즉시 연결할 수 있습니다.

공용 인스턴스는 최신 Streamable HTTP 전송을 지원하는 클라이언트의 경우 https://mcp.onlyoffice.com/mcp 에서, 레거시 SSE 전송만 지원하는 클라이언트의 경우 https://mcp.onlyoffice.com/sse 에서 사용할 수 있습니다. 가능한 경우 Streamable HTTP 전송을 사용하는 것이 좋습니다.

원격 DocSpace MCP 서버에 클라이언트를 연결하는 모든 옵션은 여기를 참조하세요.

로컬 DocSpace MCP 서버

MCP 호스트가 원격 MCP 서버를 지원하지 않는 경우, 대신 DocSpace MCP 서버의 로컬 버전을 실행할 수 있습니다.

MCP 프로토콜을 구현하는 대부분의 클라이언트에는 JSON 형식의 공통 구성 파일이 있으며, 그 안에 ONLYOFFICE DocSpace MCP 로컬 서버를 추가할 수 있습니다.

참고: 아래의 일반적인 예제는 Docker 이미지에 적용되므로 시스템에 Docker가 설치되어 있어야 합니다.

1단계. 구성 파일 찾기

클라이언트 .json 구성 파일을 찾으세요.

2단계. DocSpace MCP 서버 항목 추가

.json 구성 파일의 mcpServers 섹션에 다음 블록을 삽입하세요:

{
	"mcpServers": {
		"onlyoffice-docspace": {
			"command": "docker",
			"args": [
				"run",
				"--interactive",
				"--rm",
				"--env",
				"DOCSPACE_BASE_URL",
				"--env",
				"DOCSPACE_API_KEY",
				"onlyoffice/docspace-mcp"
			],
			"env": {
				"DOCSPACE_BASE_URL": "https://your-instance.onlyoffice.com",
				"DOCSPACE_API_KEY": "your-api-key"
			}
		}
	}
}

3단계. 환경 변수 설정

• DOCSPACE_BASE_URL - DocSpace 인스턴스의 URL (예: https://portal.onlyoffice.com).

• DOCSPACE_API_KEY - DocSpace 설정 -> 개발자 도구 -> API 키에서 생성된 개인 API 키.

사용 가능한 모든 매개변수는 여기에 나열되어 있습니다.

4단계. 클라이언트 재시작

클라이언트를 닫았다가 다시 여세요. 대부분의 경우 DocSpace MCP 서버가 자동으로 시작되며 다음과 같은 자연어 명령을 내릴 수 있습니다:

• 새 프로젝트 룸을 만들고 Anna를 편집자 권한으로 초대해 줘.

• 이 파일을 "내 문서"에 업로드해 줘.

도구

DocSpace MCP 서버는 [MCP 사양]에 설명된 도구 개념을 구현합니다.

모든 DocSpace MCP 서버 도구는 여기에 설명되어 있습니다.

문서

문서는 디렉터리에서 확인할 수 있습니다.

샘플

다음 [예제]는 ONLYOFFICE DocSpace MCP 서버 사용 방법을 보여줍니다.

개인정보 처리방침

정책은 [법적 약관] 및 [개인정보 처리방침]에서 확인할 수 있습니다.

라이선스

DocSpace MCP 서버는 파일에 있는 MIT 라이선스에 따라 배포됩니다.