ONLYOFFICE DocSpace MCP Server

ONLYOFFICE Apps MCP サーバー

Model Context Protocol（MCP）は、LLM（大規模言語モデル）と外部システム間のコンテキストを管理する標準化されたプロトコルです。このリポジトリでは、ONLYOFFICE Apps 用の MCP サーバーを提供します。

ONLYOFFICE Apps MCP サーバーは、AI ツールを ONLYOFFICE Apps に直接接続します。これにより、AI エージェント、アシスタント、チャットボットが、自然言語でのやり取りを通じて、ルームの管理、ファイルでの共同作業、権限の処理、ドキュメントのワークフローの自動化を行えるようになります。

機能

• 細かな制御が可能なツール - 論理的なツールセットに整理されたツールにアクセスできます。きめ細かく有効／無効を切り替えられるほか、メタツールも利用できます。
• 複数のトランスポートプロトコル - stdio、SSE、Streamable HTTP のトランスポートをサポートしています。
• さまざまな認証方式 - API キー、パーソナルアクセストークン、Basic 認証、動的なクライアント登録を伴う OAuth 2.0 をサポートしています。例をご覧ください。
• リクエストレベルの設定 - セッションの初期化時に、カスタム HTTP ヘッダーを使用して認証とツールの選択を設定できます。
• さまざまな配布形式 - Docker イメージ、Docker MCP Server、MCP バンドル、Node.js アプリケーションとして利用できます。

ユースケース

• ルーム管理：ルームの作成、更新、アーカイブを行います。ルームの種類を設定し、メンバーシップを管理し、アクセスレベルを制御します。
• フォルダーとファイルの操作：フォルダーの作成、ドキュメントのアップロード、複数のアイテムの一括コピーや移動、コンテンツの名前変更や削除、ファイルやフォルダーの詳細の確認を行います。
• 共同作業と権限：ユーザーの招待や削除、セキュリティ設定の調整、ルームや共有スペースの現在のアクセス権の確認を行います。
• コンテンツへのアクセス：「マイドキュメント」または「ルーム」フォルダーの取得、フォルダーの内容の確認、ファイルのテキスト形式でのダウンロード、進行中のファイル操作の監視を行います。
• ユーザーディレクトリ：ワークスペース内のすべてのユーザーを一覧表示し、招待やアクセス管理を効率化します。

クライアントを ONLYOFFICE Apps MCP サーバーに接続する

任意の MCP クライアントを使用して、ONLYOFFICE Apps MCP サーバーに接続できます。Claude Desktop、Cursor、Devin Desktop などの一般的なクライアントをいくつか紹介しています。詳しくはこちらをご覧ください。

リモート ONLYOFFICE Apps MCP サーバー

リモート ONLYOFFICE Apps MCP サーバーは ONLYOFFICE がホストしており、AI エージェント内で ONLYOFFICE Apps のツールをすぐに使い始めるための最も簡単な方法です。マシン上で何もデプロイしたり設定したりせずに、すぐに接続できます。

パブリックインスタンスは、最新の Streamable HTTP トランスポートをサポートするクライアント向けに https://mcp.onlyoffice.com/mcp で、従来の SSE トランスポートのみをサポートするクライアント向けに https://mcp.onlyoffice.com/sse で利用できます。可能な場合は、Streamable HTTP トランスポートを使用することをおすすめします。

リモート ONLYOFFICE Apps MCP サーバーへのクライアント接続方法については、こちらですべてのオプションをご確認ください。

ローカル ONLYOFFICE Apps MCP サーバー

MCP ホストがリモート MCP サーバーをサポートしていない場合は、代わりに ONLYOFFICE Apps MCP サーバーのローカル版を実行できます。

MCP プロトコルを実装するほとんどのクライアントには共通の JSON 形式の設定ファイルがあり、その中に ONLYOFFICE Apps MCP ローカルサーバーを追加できます。

注：以下の一般的な例は Docker イメージ向けのため、システムに Docker をインストールしておく必要があります。

ステップ 1. 設定ファイルを探します

クライアントの .json 設定ファイルを探します。

ステップ 2. ONLYOFFICE Apps MCP サーバーのエントリを追加します

.json 設定ファイルの mcpServers セクションに、次のブロックを挿入します。

{
  "mcpServers": {
    "onlyoffice-apps": {
      "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 - ONLYOFFICE Apps インスタンスの URL（例：https://your-instance.onlyoffice.com）。
• DOCSPACE_API_KEY - ONLYOFFICE Apps の Developer Tools → API keys で生成した個人用 API キー（左サイドバー下部のバナーから Developer Tools を開きます）。

利用可能なすべてのパラメーターはこちらに記載されています。

ステップ 4. クライアントを再起動します

クライアントを終了して、再度開きます。ほとんどの場合、ONLYOFFICE Apps MCP サーバーは自動的に起動し、次のような自然言語のコマンドを実行できます。

• 新しいプロジェクトルームを作成し、Anna を編集者として招待します。
• このファイルを「My documents」にアップロードします。

ツール

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

ONLYOFFICE Apps MCP サーバーのすべてのツールについては、こちらをご覧ください。

ドキュメント

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

サンプル

以下の[サンプル]では、ONLYOFFICE Apps MCP サーバーの使用方法を紹介しています。

プライバシーポリシー

ポリシーはLegal TermsおよびPrivacy Policyでご確認いただけます。

ライセンス

ONLYOFFICE Apps MCP サーバーは、LICENSE ファイルに記載されている MIT ライセンスに基づいて配布されています。