ONLYOFFICE DocSpace MCPサーバー

Name: ONLYOFFICE DocSpace MCP Server
Author: ONLYOFFICE

(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サーバーは、で説明されているツール（Tools）の概念を実装しています。

すべてのDocSpace MCPサーバーツールについては、こちらで説明されています。

ドキュメント

ドキュメントはディレクトリで利用可能です。

サンプル

以下のは、ONLYOFFICE DocSpace MCPサーバーの使用方法を示しています。

プライバシーポリシー

ポリシーはおよびで確認できます。

ライセンス

DocSpace MCPサーバーは、ファイルにあるMITライセンスの下で配布されています。

ONLYOFFICE DocSpace MCP Server