Claude Media
ClaudeとEgnyteを連携する方法 — 社内ファイルの検索と分析をMCPで任せる

ClaudeとEgnyteを連携する方法 — 社内ファイルの検索と分析をMCPで任せる

EgnyteのリモートMCPサーバーをClaudeにつなぐ手順です。接続先URL、OAuth、対象プラン、AI Add-Onの有無で変わるツール、毎日・毎分のリクエスト上限をまとめます。

Egnyteは企業向けのファイル共有・コンテンツ管理サービスです。そのリモートMCPサーバー(https://mcp-server.egnyte.com/mcp)をClaudeにつなぐと、Egnyte上のファイルの検索、内容の取得、文書への質問、要約までを会話で任せられます。認証はOAuth 2.0で、読めるのは接続したユーザーに権限のあるファイルとフォルダだけです。

つないだあとに効いてくるのは、契約プランとAI Add-Onの有無、それにAPIの呼び出し上限です。接続手順は数分で終わりますが、条件を知らないと「ツールが少ない」「途中で止まる」に当たります。

EgnyteのMCPサーバーでClaudeは何ができるか

コネクタ紹介ページは、EgnyteのMCPサーバーを「Egnyteの公開APIを包み、標準の権限・コンプライアンス規則・監査ログを守るもの」と説明しています。ツールは役割ごとに次の6群に分かれます。

ツール

ツールの6群

  • 検索と取得

    search(全文検索)、advanced_search(メタデータ・日付・フォルダでの絞り込み)、fetch(文書の取得。内容は1万文字で切り詰め)。

  • 文書への質問と要約

    ask_document、summarize_document。ファイルを開かずに、条項や数値を質問できます。

  • Egnyte AIへの質問

    ask_ai_assistantは、最大20個のファイル・フォルダを指定するか、権限のある全コンテンツを検索対象にして質問します。

  • Agent

    list_agents、ask_agent。目的別に作られたEgnyteのAgentへ質問します。

  • ファイル操作

    list_filesystem_by_path、get_file_content、create_folder、upload_file、get_upload_url、get_download_url、set_file_metadata。

  • 共有と連絡

    コメント(create_commentなど)と共有リンク(create_linkなど)。whoamiで接続中のアカウントも確認できます。

読み取り専用のツールと、書き込みを伴うツールが混在します。たとえばcreate_folder、upload_file、set_file_metadata、create_comment、create_linkは書き込みです。ask_ai_assistantとask_agentも、公式の一覧では書き込み(Write)に分類されています。

set_file_metadataには注意が要ります。指定した名前空間のメタデータを、追記ではなく丸ごと置き換える仕様です。1つの項目だけ直したい場合は、先に現在値を読み出し、残したい値もすべて渡す必要があります。

接続前に確認する条件

対象プランとAI Add-On

リモートMCPサーバーの対象プランは次のとおりです。

  • 第4世代(Gen 4): Essential、Elite、Ultimate
  • 第3世代(Gen 3): Platform Team、Platform Business、Platform Enterprise Lite、Platform Enterprise(AFSまたはCFS)

使えるツールの数は、ここからさらに分かれます。Gen 3でAI Add-Onがない場合、使えるのはlist_filesystem_by_path、advanced_search、get_file_content、get_upload_url、get_download_url、whoamiの6つだけです。AI Add-Onがあれば全ツールが使えます。つまりGen 3のAdd-Onなし契約では、検索とファイル操作はできても、文書への質問や要約はClaude側に頼ることになります。

Agentのツールはさらに条件が付きます。AI Add-OnまたはGen 4のプランが必要で、ドメインでAgentが有効になっている必要があります。使えるのはPower UserとAdminで、標準ユーザーは使えません。

2つのページで食い違う箇所

ClaudeのヘルプセンターにあるEgnyte連携の記事は、Gen 3の条件を「Platform EnterpriseまたはPlatform Enterprise LightでCo-Pilotアドオンあり」と書いています。Egnyte側のドキュメントは、Gen 3の4プランを対象に挙げ、AI Add-Onの有無はツールの範囲で分けています。接続の可否を知りたいときはEgnyte側の記述が詳しいので、自社の契約がどの世代か、AI Add-Onがあるかは、Egnyteの担当者に確認するのが確実です。

ヘルプセンターの記事には、ask_copilotやKnowledge Baseへの問い合わせも載っています。Egnyte側のドキュメントでは、Knowledge BaseのツールはDeprecatedです。2026年10月からKnowledge BaseがAgentに変換され、移行済みのドメインではask_knowledge_baseとlist_knowledge_basesがエラーを返します。以前のkb_idはask_agentのagent_idとしてそのまま渡せます。新しく組むなら、Agentのツールを前提にします。

ClaudeにEgnyteをつなぐ手順

Claude.aiの場合

Claudeの「設定 → コネクタ」から、一覧にあるEgnyteを追加します。一覧に出ない場合は、カスタムコネクタとして次のURLを登録します。

https://mcp-server.egnyte.com/mcp

追加して「接続」を押すとEgnyteの認証ページに移ります。Egnyteのドメイン名(例: apidemo.egnyte.com)と資格情報を入力し、求められた権限を承認すると、Egnyteのツールが一覧に現れます。

組織で使う場合の流れはヘルプセンターに別途あります。Organization Ownerが「Admin settings → Connectors」で「Add custom connector」を選び、同じURLと名前(例: Egnyte)を入れて追加し、「Connect」で認証します。個人のユーザーは、そのあとで各自がコネクタを接続します。

コネクタ紹介ページでは、サインインが必須と表示されています。

Claude Codeの場合

ターミナルから、HTTPトランスポートでMCPサーバーを追加します。

claude mcp add --transport http egnyte \
  https://mcp-server.egnyte.com/mcp

追加したら、Claude Codeのセッション内で/mcpを開いて認証を済ませます。このときもEgnyteのドメインを入力する画面に移ります。接続中のアカウントとドメインは、whoamiツールで確かめられます。複数のドメインを持つ人は、最初にこれを呼ばせると取り違えを防げます。

検索から分析まで、会話の組み立て方

Egnyteの開発者向け資料は、典型例として「あるプロジェクトの最新の署名済み契約を探し、支払条件を要約する」を挙げています。クライアントがsearch、get_file_content、ask_documentをつなぎ、コードを書かずに実行します。

ヘルプセンターの記事も、契約レビューでadvanced_searchによるPDFと日付の絞り込み、ask_documentによる条項の質問、summarize_documentによる要約を順に使う流れを示しています。依頼は、場所・種類・期間を具体的に書くほどツールが絞れます。

Legal/Vendor フォルダにある2024年のPDF契約書を探して、
それぞれの解約条件と責任上限額を表にしてください。

「契約書を探して」とだけ書くより、フォルダ・ファイル種別・年を添えたほうが、advanced_searchのフィルタに素直に落ちます。

数十件の文書を一度に調べさせる依頼は、次の節の上限に直結します。

リクエスト上限 — 毎分・毎日で止まる条件

MCPサーバーには、Egnyte APIと同じレート制限が適用されます。ドキュメントによれば、既定の上限はプランで決まり、AI関連のAPIはより厳しい上限を持ちます。ベストプラクティスのページに載っている既定値は次のとおりです。

数字

トークンごとの既定の上限

  • 通常のAPI

    1,000回/日

    毎秒2回まで

  • AI関連のAPI

    100回/日

    毎分10回、毎秒2回まで

制限はAPIキーではなくアクセストークン単位

注意したいのは、ask_document、summarize_document、ask_ai_assistant、ask_agentのようなAI系のツールです。1日100回という上限は、数十ファイルを順番に要約させる使い方だと、あっという間に尽きます。MCPのドキュメントも、AI系やAgentのツールをファイル数だけループさせるとこの上限に早く届くため、対象を必要なファイルに絞るよう促しています。

上限の使い方は、次の3点で変わります。

  • ファイル全体を読めば足りる質問は、get_file_content(通常のAPI扱い)で本文を取り、Claude側で読む。AI系の枠を温存できます
  • 複数文書をまたぐ質問は、ask_ai_assistantにフォルダIDを渡して1回で聞く。ファイル1つずつのask_documentを繰り返さない
  • fetchは内容が1万文字で切れる。長い文書はget_file_contentのページ送りで読む

本番用途で上限が足りない場合は、Egnyteに個別の取り決めを相談する形になっています。

データの扱いと運用上の線引き

EgnyteのMCPサーバーは、通過させたコンテンツを保存もキャッシュもしないと説明されています。アクセスはユーザー本人の権限の範囲に限られます。一方で、どのAIクライアントにアクセスを許すかを管理するのは顧客側の責任で、AIクライアントは自社のプライバシーポリシーに従って内容を扱います。つまりEgnyteの権限で守られるのは「読める範囲」までで、読んだ内容がClaude側でどう扱われるかは、Claudeのプランと管理設定の問題です。

書き込み系のツールは、権限の範囲で実際に動きます。upload_fileは同じパスに既存ファイルがあれば新しいバージョンとして追加し、create_linkは共有リンクを発行します。共有リンクの発行や上書きまで任せるかどうかは、ツールごとの承認の扱いで決める事柄です。

アップロードにも制約があります。upload_fileはUTF-8のテキストのみで最大8MB、バイナリはget_upload_urlで署名付きURLを取得して送ります。MCP経由の転送は約200MBまでが目安で、大きなファイルや一括移行にはREST APIのほうが向くとされています。

つまずいたときの切り分け

切り分け

Egnyteのツールが期待どおりに動かないとき

  1. Q接続中のドメインとアカウントは正しいですか?(whoamiで確認)
    答えがいいえのとき

    別のドメインに認証していないか確認し、コネクタを接続し直します。

    答えがはい
  2. Q契約はGen 4、またはGen 3でAI Add-Onありですか?
    答えがいいえのとき

    Gen 3でAdd-Onなしの場合、使えるのは6つのツールです。質問や要約はClaude側で本文を読んで行います。

    答えがはい
  3. QAgentのツールが出ない、または失敗しますか?
    答えがいいえのとき

    AI Add-OnかGen 4であること、ドメインでAgentが有効なこと、ユーザーがPower UserまたはAdminであることを確認します。

    答えがはい

上限に当たっている可能性

AI系ツールの1日100回、毎分10回を超えていないか見直します。

Agentの実行中に確認の承認や外部アプリへのサインインが必要になると、MCP経由では完了できません。ステータスはAWAITING_USER_CONFIRMATIONで止まるため、そのAgentはEgnyteの画面で実行します。Agentの回答待ちは最大2分かかることがあり、get_agent_ask_statusをPLANNINGやIN_PROGRESSの間ポーリングする構造です。

よく似たコネクタとの使い分け

ファイル保管先によって、つなぐコネクタは変わります。Egnyteが主なら今回の方法です。AI検索の分析サービスはClaudeとAirOpsを連携する方法、CRMの更新まで任せたいならClaudeとDay AIを連携する方法が同じ型で読めます。書き込み系ツールの線引きは、会計データを扱うClaudeとDualEntryを連携する方法でも同じ論点になります。

コネクタ紹介ページの関連コネクタには、Google Drive、Microsoft 365、Notionなどが並びます。Egnyteを使っている組織では、ファイルの出どころが複数になりがちです。どのコネクタが何を引けるかは、接続の都度、ツール一覧で確かめられます。

まとめ

接続自体は、URLを登録してEgnyteのドメインで認証するだけです。差が出るのは、契約世代とAI Add-Onで使えるツールが6つに絞られること、AI系ツールが1日100回で止まること、書き込み系が権限の範囲で実際に動くことの3点です。Knowledge Baseのツールは移行が進むため、Agent前提で組むほうが先々の手戻りが少なくなります。

参照した一次ソース

この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。

  1. developers.egnyte.com/integration/cfs/api-docs/remote-mcp-server
  2. developers.egnyte.com/integration/cfs/api-docs/best-practices
  3. claude.com/marketplace/connectors/egnyte
  4. support.claude.com/en/articles/12651659-using-egnyte-for-data-room-management…
この記事を共有:XはてブLinkedIn