Docspace MCP

🚀 ONLYOFFICE DocSpace MCP Server

[モデルコンテキストプロトコル] (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 アプリケーション として利用可能です。

📋 使用例

• ルーム管理：ルームの作成、更新、およびアーカイブ。ルームタイプの設定、メンバーシップの管理、およびアクセスレベルの制御。
• フォルダとファイルの操作：フォルダの作成、ドキュメントのアップロード、項目のバッチコピーまたは移動、コンテンツの名前変更または削除、およびファイルまたはフォルダの詳細の確認。
• 共同作業と権限：ユーザーの招待または削除、セキュリティ設定の調整、およびルームと共有スペースの現在のアクセス権の確認。
• コンテンツアクセス：「My documents」または「Rooms」フォルダの取得、フォルダコンテンツの取得、ファイルのテキストとしてのダウンロード、および進行中のファイル操作の監視。
• ユーザーディレクトリ：ポータル内のすべてのユーザーを一覧表示し、招待とアクセス管理を合理化します。

🖥️ クライアントを DocSpace MCP サーバーに接続する

任意の MCP クライアントを使用して、DocSpace MCP サーバーに接続することができます。一部の人気のあるクライアントについては、こちら で説明しています。

リモート 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 を編集者権限で招待する。
• このファイルを「My documents」にアップロードする。

🛠️ ツール

DocSpace MCP サーバーは、[MCP 仕様] で説明されているツールの概念を実装しています。

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

📚 ドキュメント

ドキュメントは docs ディレクトリにあります。

📄 ライセンス

DocSpace MCP サーバーは、LICENSE ファイルに記載されている Apache-2.0 ライセンスの下で配布されています。