メインコンテンツまでスキップ

ONLYOFFICE MCPサーバーをClaude Desktopに接続する

はじめに​

ONLYOFFICE Apps MCPサーバーは、AIを活用したワークフロー、ドキュメントおよびタスク管理を効率化し、ONLYOFFICE Appsの可能性を最大限に引き出すためにカスタマイズされた言語モデルとのインタラクションを管理するツールです。

ONLYOFFICE Apps MCPサーバーは、リモートマシン上で実行されているMCPサーバーへの接続をサポートするクライアントに接続できます。

公開インスタンスは、最新のStreamable HTTPトランスポートをサポートするクライアント向けにhttps://mcp.onlyoffice.com/mcpで、レガシーSSEトランスポートのみをサポートするクライアント向けにhttps://mcp.onlyoffice.com/sseで利用可能です。可能であれば、Streamable HTTPトランスポートを使用することをお勧めします。

ONLYOFFICE Apps MCPサーバーは、次の3つの方法でClaude Desktopに接続できます：

  1. Connector - ほとんどのユーザーに適しています；
  2. Extension - ローカル開発環境に適しています；
  3. Local MCP - 高度な設定や、Dockerと設定ファイルを使用したい開発者に適しています。

まず、お使いのオペレーティングシステム用のClaude Desktopをダウンロードしてインストールします。Claude DesktopはmacOSとWindowsで利用できます。すでにClaude Desktopをインストールしている場合は、実行中のバージョンを確認してください。Claude Desktopメニューをクリックし、Check for Updatesを選択します。

Connector​

  1. Claude Desktopを開きます。

  2. メニューにアクセスし、Settingsを選択します。

  3. SettingsページでConnectorsに移動し、Add custom connectorボタンをクリックします。

    Claudeコネクタ

  4. コネクタ名を入力します（例：「ONLYOFFICE Apps MCP」）。

  5. URLを入力します：

    https://mcp.onlyoffice.com/mcp

  6. Addボタンをクリックします。

    Claudeコネクタ

  7. 新しく追加したコネクタの横にあるConnectをクリックします。

  8. OAuth認証プロセスを完了します。

Extension​

Claude Desktop Extensionは、ローカルで実行されているMCPサーバーに接続するもう1つの方法です。

MCPサーバーにはNode.jsが必要です。Node.jsのバージョン18以降を使用していることを確認してから、GitHub Releasesからmcpbファイルをダウンロードします。Node.jsがインストールされていない場合は、nodejs.orgにアクセスしてダウンロードしてください。

  1. Claude Desktopを開きます。

  2. メニューにアクセスし、Settingsを選択します。

  3. SettingsページでExtensionsに移動し、Advanced settingsをクリックします。

    Claudeコネクタ

  4. Install extensionをクリックします

    Claudeコネクタ

  5. ダウンロードしたMCPバンドルを選択します

    Claudeコネクタ

Local MCP​

Claude Local MCP serversは、ローカルで実行されているMCPサーバーに接続する3つ目の方法です。

Dockerがシステムにインストールされ、実行されていることを確認してください。

Apps APIキーを生成します。Appsにアクセスし、左側のパネルでデベロッパーツールタブをクリックします。上部のAPIキータブを選択し、新しいシークレットキーを作成ボタンをクリックします。生成されたキーをコピーします。

  1. Claude Desktopを開きます。

  2. メニューにアクセスし、Settingsを選択します。

  3. Settingsページで、左側のサイドバーにあるDeveloperタブに移動します。

  4. Edit configボタンをクリックします

    Claudeコネクタ

  5. テキストエディタで設定ファイルを開きます。ファイルのパス：

    • macOSの場合：

      ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windowsの場合：

      %APPDATA%\Claude\claude_desktop_config.json

  6. 次のJSON構造を追加します：

    {
      "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"
          }
        }
      }
    }
    • DOCSPACE_BASE_URL - Appsポータルのアドレス
    • DOCSPACE_API_KEY - 上記の手順に従って生成されたApps APIキー。
    • command: "docker" - Docker経由でMCPサーバーを起動するために使用するコマンド
    • onlyoffice/docspace-mcp - MCPサーバーのDockerイメージ

  7. ファイルを保存し、Claude Desktopを再起動します

ONLYOFFICE MCPサーバーの使用​

  • 認証が成功したら、チャットを開いてプロンプトを入力し、使用するツールのリストを確認するためにAlways allowまたはAllow onceをクリックします。

    ツールを承認