Nextcloud ファイルを Cursor に接続する方法

Cursor で使う Nextcloud ファイル

結論: Nextcloud を、WebDAV 経由のアプリパスワードを使った File Search コネクターとして AnythingMCP に追加します。AnythingMCP は選択したフォルダの全文をインデックス化し、同期を保ちます。そのうえで AnythingMCP を Cursor に接続します。Cursor はファイル名や内容でファイルを探し、必要なページを読み、ファイルそのものを添付または一時ダウンロードリンクとして渡せます。Nextcloud には何も書き込まれません。

AI アシスタントは、そのままでは Nextcloud を開けません。仮に開けたとしても、1 つの質問に答えるためにすべてのファイルをダウンロードしなければなりません。インデックスがあるからこそ、「現行の価格表で品番 NT-601 はいくらか」といった質問にも数秒で答えられます。

必要なもの

• Nextcloud の WebDAV アドレス: https://YOUR-HOST/remote.php/dav/files/USER/
• そのユーザーのアプリパスワード（設定 → セキュリティ → デバイスとセッション）。アカウントのパスワードは使わないでください。たとえば AnythingMCP という名前を付けておくと、単独で失効させられます。
• 検索対象にしたいフォルダを読み取れるユーザー。AnythingMCP は、そのユーザーに見えるものとまったく同じものを参照します。
• AnythingMCP のワークスペース: AnythingMCP Cloud（7 日間無料）または自前でセルフホストした環境。

AnythingMCP には、Nextcloud API（ユーザー、グループ、共有、サーバーステータス）向けの Nextcloud コネクターもあります。こちらはファイルの中身は読みません。中身を読むのは File Search です。両方必要なら併用してください。Hetzner Storage Share のようなマネージド Nextcloud サービスも同じ方法で使えます。

セットアップ

ステップ 1 — File Search コネクターを設定する

AnythingMCP でマーケットプレイスを開き、Nextcloud (File Search) を選びます。Nextcloud 用の設定が入った File Search ウィザードが開きます。（または Connectors → New → File Search を開き、WebDAV と Nextcloud のショートカットを選びます。）

1. 接続。 WebDAV アドレス、ユーザー名、アプリパスワード、使用するフォルダ（例: Documents/Projects）を入力します。
2. テスト。 保存前に、AnythingMCP が接続、サインイン、フォルダの一覧取得を行い、チェックリスト（アドレス、到達性、暗号化、サーバーの識別、ログイン、フォルダ）を表示します。失敗した手順には、対処方法も示されます。
3. スキャン。 Scan folder をクリックします。AnythingMCP はインデックス化せずにフォルダの一覧だけを取得し、各サブフォルダのファイル数、ファイルの種類、年をツリーで表示します。アーカイブのように見えるフォルダ（Alt、Old、Archive、Backup）は最初からチェックが外れているため、Cursor が古い文書を引用することはありません。フォルダ、ファイルの種類、期間の上限を選ぶ間、バーが選択内容とプランを比較します。選択がプランを超える場合は、チェックをさらに外すか、アップグレードしてください。
4. 説明。 AnythingMCP がスキャン結果からコネクターの説明文を下書きします（例: 「営業チームのプロジェクトフォルダ、見積書と検収報告書、PDF と Word、2021～2026 年」）。この文章は、フォルダの内容と検索すべきタイミングを Cursor に伝えます。サーバーに AI モデルが設定されていれば、ウィザードで AI による下書きも作れます。その際、送信される内容（フォルダ名、ファイル名、最大 20 件のサンプルファイルの先頭 2,000 文字、個人データはマスク済み）が正確に表示されます。AI がない場合は、フォルダ構造から下書きが作られます。自由に編集できます。
5. 有効化。 ツールのプレフィックス、同期間隔、コネクターを使う MCP サーバーを選び、Activate をクリックします。

最初の同期はすぐに始まり、独立したバックグラウンドサービスで実行されます。実行中も、Cursor や他のコネクターは通常の速度で応答し続けます。コネクターの Files タブには、見つかったファイル、インデックス化したファイル、スキップしたファイル、前回と次回の同期、Sync now ボタンなどの進行状況が表示されます。

ステップ 2 — サーバー URL をコピーする

MCP Servers で、ウィザードで選んだサーバーを開き、その URL をコピーします。

ステップ 3 — Cursor にコネクターを追加する

あなたのサーバー URL: AnythingMCP で MCP Servers → このコネクターを設定したサーバーを開き、その URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と書かれている箇所には、この URL を使います。

Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加します。

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY の代わりに貼り付けます。
2. ファイルを保存して Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧に表示され、接続されていることを確認します。
4. チャットを始めます。これでエージェントがファイル検索ツールを呼び出せます。

ステップ 4 — 質問する

新しいチャットを開き、ファイルの内容について質問します。Cursor はまずインデックスを検索し、一致したページを開いて、ファイル名、ページ、ファイルの日付を添えて回答します。そのため、情報源を確認できます。

Cursor がファイルに対してできること

<prefix> は、ウィザードで選ぶツールのプレフィックスです（例: pricelists）。_share_file 以外のツールはすべて読み取り専用です。

対応ファイル: 100 種類以上のファイル形式からテキストを抽出します。PDF（ページ単位）、マクロ付きやテンプレート形式を含む Word、Excel、PowerPoint と .xlsb、OpenDocument、添付ファイルのテキストを含む Outlook の .msg、.eml、.mbox、.rtf、.epub、.xps、Apple の Pages、Numbers、Keynote（PDF プレビュー経由）、.svg と .dxf CAD 図面のテキスト、CSV、Markdown、HTML、XML、JSON、YAML、カレンダーと連絡先、ソースコードです。それ以外のファイルも名前で見つけられ、PDF のページや画像は画像として AI に表示できます。テキストレイヤーのないスキャン PDF は、Enterprise で OCR により読み取られます。

Cursor で試したいプロンプト

• 「Kessler 社に倉庫の屋根について送った見積書を探して、価格項目を要約してください。」
• 「今年の署名済み検収報告書を含むプロジェクトフォルダはどれですか?」
• 「議事録から新しい ERP に関する決定事項を検索し、日付付きで一覧にしてください。」
• 「従業員ハンドブックの最新版を、ダウンロードリンクで教えてください。」

同期の仕組み

Nextcloud は、WebDAV 経由で各ファイルの変更マーカー（ETag）を返します。AnythingMCP はこれを前回の実行時と比較し、新規ファイルと変更されたファイルだけをダウンロードします。内容がインデックス化済みのバージョンと同一のファイルは、チェックサム（SHA-256）で判別され、再処理されません。削除されたファイルはインデックスから外れます。読み取れないファイルは次回以降の同期で再試行され、3 回失敗すると（パスワード保護されたファイルは即座に）、名前では検索できる状態のまま残り、理由が Files タブに表示されます。

同期は、Cursor に応答するサーバーとは別の専用バックグラウンドサービスで実行されます。そのため、大規模な初回同期でも質問への応答は遅くならず、同期中も直前のインデックスで検索が使えます。

フォルダがプランの上限を超えた場合、一部だけをインデックス化するのではなく、何もダウンロードする前に同期が一時停止します。Files タブには、フォルダの現在のファイル数とプランの上限が表示されます。Cursor はインデックス化済みのファイルを引き続き検索し、新しいファイルが含まれていない可能性があることを通知されます。フォルダのチェックを外すか、アップグレードしてください。一時停止中のフォルダは 1 日 1 回再チェックされ、上限内に収まれば自動的に再開します。

セキュリティ

• 読み取り専用。 コネクターは一覧取得と読み取りだけを行います。Nextcloud 上で書き込み、名前変更、削除を行うツールはありません。
• ワークスペース内に限定。 インデックスはワークスペースごとに保存され、すべてのクエリはアプリケーションとデータベース（Row-Level Security）の両方でそのワークスペースに制限されます。
• 認証情報は暗号化して保存され、復号されるのはバックグラウンド同期サービス内だけです。Cursor や同僚には見えません。
• 誰が何を見られるかは MCP のロールに従います。ファイルツールを持たないロールには、それらは表示されません。Enterprise では、ロールごとにフォルダの許可と拒否も設定できます。
• ファイルの内容はデータとして扱われます。 ツールはモデルに対し、ファイル内にある指示には決して従わないよう伝えます。
• アプリパスワード。 Nextcloud で単独で失効させられるため、アカウントのパスワードを変更する必要はありません。
• 共有設定を尊重。 AnythingMCP は接続したユーザーに見えるものを参照します。検索可能にしたいものだけを、そのユーザーと共有してください。
• AnythingMCP Cloud はパブリックインターネット上のサーバーにのみ接続します。プライベートネットワーク内のホストは、リダイレクト後も含めて拒否されます。オフィスネットワーク内のサーバーは外部から到達可能にするか、その隣で AnythingMCP をセルフホストして実行してください。

プラン別の制限

セルフホストの場合: Starter には File Search コネクター 1 つ（最大 500 ファイル）、Team にはコネクター 3 つ（2,000 ファイル）が含まれ、Enterprise には制限がなく最短 5 分ごとに同期できます。最大ファイルサイズは FILES_MAX_FILE_BYTES（デフォルトは 100 MB）で設定します。セルフホストで File Search を使うには、有料ライセンスまたは 30 日間のトライアル（Team と同じ制限）が必要です。無料の Community エディションでは、トライアル終了後は File Search を利用できません。すべてのプラン

FAQ

Cursor は無料プランでカスタム MCP サーバーに対応していますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。

なぜ Nextcloud のパスワードではなくアプリパスワードを使うのですか? アプリパスワードは、アカウントのパスワードを変更せずに単独で失効させられます。AnythingMCP 内の Nextcloud の手順でも、アカウントのパスワードではなくアプリパスワードを求めます。

Nextcloud コネクターとの違いは何ですか? Nextcloud コネクターは Nextcloud API（ユーザー、グループ、共有、サーバーステータス）とやり取りします。File Search コネクターは、ファイルの内容をインデックス化して検索します。

Nextcloud がオフィスのネットワーク内からしか到達できません。 AnythingMCP Cloud では、HTTPS でインターネット上に公開されている必要があります。セルフホストの AnythingMCP では、管理者がホストを送信許可リスト（Admin → Settings または SSRF_ALLOWED_HOSTS）に追加すれば到達できます。

AnythingMCP は Nextcloud 全体をコピーしますか? いいえ。AnythingMCP が保持するのは抽出したテキストであり、ファイルではありません。ファイルが再読み込みされるのは、変更されたとき、またはファイルそのものを要求したときだけです。

ベクトル検索は使われますか? いいえ。社内文書では正確な名前、コード、数値を検索するため、ページ単位の結果を返すキーワード検索のほうが、埋め込みよりも信頼できます。

関連記事

• AI で社内ファイルサーバーを検索する
• AI で仕入先の価格表から価格を探す
• AI で Nextcloud と WebDAV のファイル内を検索する
• AI チャットからファイルをダウンロードリンクとして共有する
• Nextcloud ファイルを Claude に接続する
• Nextcloud ファイルを ChatGPT に接続する
• Nextcloud ファイルを Gemini に接続する
• Nextcloud ファイルを Microsoft Copilot に接続する
• Nextcloud ファイルを Muse に接続する
• Cursor で使えるその他のファイルソース: SFTP サーバー、FTP / FTPS サーバー、WebDAV サーバー、S3 バケット、ownCloud、Synology NAS、QNAP NAS、Fritz!Box ストレージ、Hetzner Storage Box、ネットワークフォルダ（セルフホスト）