Skip to main content

MCP 連携設定

MCP 連携設定

Model Context Protocol（MCP） を使い、Cursor や Claude Desktop などの AI クライアントから Docmost のワークスペースを操作する設定手順です。ページの検索・取得に加え、権限の範囲内で作成・更新・移動なども行えます。

Enterprise 機能: MCP 連携は Enterprise ライセンスが必要です。

こんなときに読む

管理者：MCP を有効化する

  1. Settings > AI & MCP の MCP タブ（/settings/ai/mcp）を開く
  2. Enable MCP を ON
  3. 表示される MCP URL をコピー（形式: {APP_URL}/mcp）

WS Admin / Owner のみ設定できます。オフの間はクライアントから接続できません。

有効化後、管理画面の Supported tools に利用可能なツール名が表示されます。

ユーザー：API キーを用意する

MCP クライアントは 個人 API キー で認証します。

  1. Settings > Account > API keys（/settings/account/api-keys）でキーを発行
  2. シークレットを安全な場所に保存（再表示不可）

→ 詳細: 「個人 API キーの発行」（No.8.5）

クライアント設定例

mcp.json または各クライアントの MCP 設定に追加します。トランスポートはクライアントのバージョンに合わせて選んでください。

Cursor（HTTP トランスポート）

{
  "mcpServers": {
    "docmost": {
      "url": "https://your-docmost.example.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cursor / Claude Desktop（mcp-remote 経由）

公式ドキュメントで推奨される形式です。

{
  "mcpServers": {
    "docmost": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://your-docmost.example.com/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

提供ツール一覧

MCP サーバーが公開するツールは Docmost 側で固定されています（全 21 件）。クライアントが対応していれば、いずれのクライアントからも同じツールが利用できます。

Pages

ツール 説明
search_pages キーワードでページを検索
get_page 指定ページの内容を取得
create_page スペース内に新規ページを作成
update_page 既存ページのタイトルや内容を更新
list_pages スペース内の最近のページを一覧
list_child_pages 指定ページの子ページを一覧
duplicate_page 同一スペース内でページを複製
copy_page_to_space ページを別スペースへコピー
move_page ページの位置や親を変更
move_page_to_space ページを別スペースへ移動

Spaces

ツール 説明
get_space 指定スペースの詳細を取得
list_spaces アクセス可能なスペースを一覧
create_space 新規スペースを作成
update_space スペース名や説明を更新

Comments

ツール 説明
get_comments ページのコメントを取得
create_comment ページにコメントを追加
update_comment 既存コメントを更新

Other

ツール 説明
search_attachments ワークスペース内の添付ファイルを検索
list_workspace_members ワークスペースメンバーを一覧
get_current_user 認証済みユーザーの情報を取得

権限

MCP は Web UI と同じ権限 が適用されます。接続ユーザー（API キーの所有者）が閲覧・編集できるスペースとページにのみアクセスでき、作成・更新・移動などの操作も、そのユーザーのロールとスペース権限の範囲内でのみ成功します。

REST API との使い分け

手段 向いていること
MCP Cursor 等の AI エージェントから、会話の流れでページ・スペースを検索・作成・更新する
REST API CI/CD・バッチ・外部システムから、エンドポイントを直接呼ぶ自動化（No.9.5）
ブラウザ 日常の編集・レビュー・共同作業

MCP でもページやスペースの作成・更新は可能ですが、大規模な一括処理や細かい API 制御には REST API の方が向いています。

トラブルシューティング

症状 確認
接続できない MCP が有効か、URL・APP_URL が正しいか。クライアントのトランスポート（HTTP / mcp-remote）を切り替えてみる
401 / 403 API キーの有効性、Revoke されていないか。対象リソースへの閲覧・編集権限
ツールが空 ライセンス、管理者の MCP 設定
Member がキー作れない restrictToAdmins 設定（No.8.5）

関連ナレッジ