ONLYOFFICE DocSpace MCP Server
OfficialONLYOFFICE DocSpace MCP 서버
Model Context Protocol (MCP)은 대규모 언어 모델(LLM)과 외부 시스템 간의 컨텍스트를 관리하기 위한 표준화된 프로토콜입니다. 이 저장소는 ONLYOFFICE DocSpace를 위한 MCP 서버를 제공합니다.
DocSpace MCP 서버는 AI 도구를 ONLYOFFICE DocSpace에 직접 연결합니다. 이를 통해 AI 에이전트, 어시스턴트 및 챗봇은 자연어 상호작용을 통해 룸 관리, 파일 협업, 권한 처리 및 문서 워크플로우 자동화를 수행할 수 있습니다.
주요 기능
세밀한 제어가 가능한 도구 - 논리적 도구 세트로 구성된 도구에 액세스하며, 세밀한 활성화/비활성화 기능 및 메타 도구를 제공합니다.
다중 전송 프로토콜 - stdio, SSE 및 Streamable HTTP 전송을 지원합니다.
다양한 인증 방식 - API 키, 개인 액세스 토큰, 기본 인증 및 동적 클라이언트 등록을 포함한 OAuth 2.0을 지원합니다. 예제를 참조하세요.
요청 수준 구성 - 사용자 지정 HTTP 헤더를 사용하여 세션 초기화 중에 인증 및 도구 선택을 구성할 수 있습니다.
다양한 배포 형식 - Docker 이미지, Docker MCP 서버, MCP 번들 및 Node.js 애플리케이션으로 제공됩니다.
Related MCP server: LibreOffice MCP Tools
사용 사례
룸 관리: 룸 생성, 업데이트 및 보관. 룸 유형 구성, 멤버십 관리 및 액세스 수준 제어.
폴더 및 파일 작업: 폴더 생성, 문서 업로드, 항목 일괄 복사 또는 이동, 콘텐츠 이름 변경 또는 삭제, 파일 또는 폴더 세부 정보 확인.
협업 및 권한: 사용자 초대 또는 제거, 보안 설정 조정, 룸 및 공유 공간에 대한 현재 액세스 권한 검토.
콘텐츠 액세스: "내 문서" 또는 "룸" 폴더 검색, 폴더 콘텐츠 가져오기, 파일을 텍스트로 다운로드 및 진행 중인 파일 작업 모니터링.
인물 디렉토리: 포털의 모든 인물을 나열하여 초대 및 액세스 관리를 간소화.
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 서버 도구는 여기에 설명되어 있습니다.
문서
문서는 docs 디렉토리에서 확인할 수 있습니다.
샘플
다음 예제는 ONLYOFFICE DocSpace MCP 서버 사용 방법을 보여줍니다.
개인정보 처리방침
정책은 법적 고지 및 개인정보 처리방침에서 확인할 수 있습니다.
라이선스
DocSpace MCP 서버는 LICENSE 파일에 있는 MIT 라이선스에 따라 배포됩니다.
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect AI agents to 1000+ apps with managed authentication and tool-calling.
Connect AI assistants to Stellary projects, boards, documents, and governed agent workflows.
- mcp-serverOAuthcom.make
Give your AI agents the tools to build, manage, and run automation workflows.
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to create, read, edit, and manipulate LibreOffice documents with support for track changes, comments, search/replace, and real-time document operations through a native extension or HTTP API.11MIT
- AlicenseAqualityDmaintenanceEnables AI agents to read, write, and edit Office documents via LibreOffice with token-efficient design. Supports multiple formats including DOCX, XLSX, PPTX, and legacy formats through LibreOffice bridge.2728 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to read, edit, and create Microsoft Word documents (.docx) with support for rich text, tables, and images, deployable locally or via SSE.3MIT
- AlicenseBqualityCmaintenanceEnables complete Office document lifecycle management for AI agents, including creation, editing, conversion, and templating of DOCX, XLSX, PPTX, PDF, and EML files.40MIT