MCP 経由で Microsoft SharePoint を Gemini に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → SharePoint (Microsoft 365) をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Microsoft SharePoint + Gemini

AI に SharePoint で作業させます。サイトの検索、ドキュメントライブラリの閲覧と検索、ファイルの詳細とアクセスできる人の確認、リストアイテムの読み取り、作成、更新、リスト、フォルダー、テキストファイルの作成、サイトページの読み取り、Microsoft Search による全体の検索ができます。Microsoft Graph 経由で Microsoft 365 に対応し、職場アカウントでサインインします。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

MICROSOFT_CLIENT_ID, MICROSOFT_CLIENT_SECRET, MICROSOFT_TENANT_ID

ステップ 1 — 認証情報を取得

1. Microsoft Entra 管理センター（entra.microsoft.com）または Azure portal を開き、Applications → App registrations → New registration に進みます。

2. アプリに名前を付け（例: 「AnythingMCP Microsoft 365」）、Supported account types を選びます。この選択によって MICROSOFT_TENANT_ID に入れる値が決まります。

   • Accounts in this organizational directory only（シングルテナント）: 自組織のユーザーだけがサインインできます。アプリの Overview ページにある Directory (tenant) ID（GUID）か、contoso.onmicrosoft.com のようなドメインを入れます。
   • Accounts in any organizational directory（マルチテナント）: organizations を入れます。
   • Accounts in any organizational directory and personal Microsoft accounts: common を入れます。個人用 Microsoft アカウントには SharePoint がないため、サインインはできてもデータは取得できません。

   値がアカウントの種類と一致しないと、Microsoft はサインインを拒否します（AADSTS50194 または AADSTS50020）。

3. Redirect URI でプラットフォーム Web を選び、https://cloud.anythingmcp.com/api/mcp-oauth/callback を入力します。AnythingMCP をセルフホストしている場合は、代わりに https://your-anythingmcp-host/api/mcp-oauth/callback を入力します。URI は 1 文字単位で一致している必要があり、一致しないと Microsoft は AADSTS50011 を返します。

4. API permissions → Add a permission → Microsoft Graph → Delegated permissions を開き、offline_access、User.Read、Sites.ReadWrite.All、Files.ReadWrite.All を追加します。offline_access があることで Microsoft はリフレッシュトークンを発行します。これがないと、コネクターは承認から 1 時間後に動かなくなります。

5. Certificates & secrets → New client secret を開きます。Secret ID ではなく、シークレットの Value をコピーします。表示されるのは一度だけです。有効期限を控えておいてください。期限が切れると、新しいシークレットを作成して入力し直すまでコネクターは動作しません。

6. Overview ページの Application (client) ID を MICROSOFT_CLIENT_ID に、シークレットの値を MICROSOFT_CLIENT_SECRET に、手順 2 のテナントの値を MICROSOFT_TENANT_ID に入力し、コネクターをインストールします。

7. コネクターのページで Authorize with Provider をクリックし、AI に扱わせる SharePoint サイトにアクセスできる職場アカウントでサインインします。リフレッシュトークンは暗号化して保存され、アクセストークン（有効期間は約 1 時間）は自動で更新されます。

8. まず sharepoint_get_root_site を実行します。組織のルートサイトが表示され、SharePoint に接続できることを確認できます。

「.All」の意味: これらの委任されたアクセス許可における All は、「サインインしたユーザーが開けるすべてのサイト」という意味です。AI がそのユーザー自身の SharePoint へのアクセス権を超える権限を得ることはありません。

すべての Microsoft コネクターに 1 つの Entra アプリ: Outlook、OneDrive、Excel のコネクター用に作成したアプリの登録は、ここでもそのまま使えます。登録を開いて API permissions で手順 4 のアクセス許可を追加し、リダイレクト URI はそのままで、同じクライアント ID、シークレット、テナントを使い回してください。各コネクターは、承認時に自分に必要なアクセス許可だけを求めます。

• Outlook: Mail.ReadWrite、Mail.Send、Calendars.ReadWrite
• OneDrive: Files.ReadWrite
• Excel: Files.ReadWrite（SharePoint 内のブックや共有されたブックには Files.ReadWrite.All も必要）
• SharePoint: Sites.ReadWrite.All と Files.ReadWrite.All

どのコネクターにも offline_access と User.Read が必要です。

管理者の同意: これらの委任されたアクセス許可には通常は管理者は不要ですが、多くの組織ではユーザーによる同意が無効になっています。サインイン時に「Need admin approval」（AADSTS65001 または AADSTS90094）と表示された場合は、テナント管理者がアプリの登録を一度開き、API permissions → Grant admin consent で組織全体に同意を付与します。その後は各ユーザーが承認できます。それでも各コネクターが扱えるのは、サインインしたアカウントが見られる範囲だけです。

読み取り専用の設定: アプリの登録に Sites.Read.All と Files.Read.All を追加し、コネクターの OAuth 設定でスコープを offline_access User.Read Sites.Read.All Files.Read.All に置き換えて再度承認し、sharepoint_create_list_item、sharepoint_update_list_item、sharepoint_create_list、sharepoint_create_folder、sharepoint_upload_text_file、sharepoint_rename_drive_item、sharepoint_move_drive_item を無効にします。

インストール時はオフ: sharepoint_delete_list_item、sharepoint_delete_drive_item、sharepoint_create_sharing_link、sharepoint_invite。共有リンクと招待は意図的にオフにしています。他の人に組織のファイルへのアクセス権を与えることになり、AI が読んだドキュメントに何かを共有するよう求める文章が含まれている可能性もあるからです。AI に本当に必要な場合だけツールをオンにしてください。削除したアイテムはサイトのごみ箱に移ります。

サイトの探し方: AI はキーワードやサイトのアドレス（例: https://contoso.sharepoint.com/sites/Marketing）からサイトを見つけ、そのドキュメントライブラリとリストを開きます。sharepoint_search は Microsoft Search を使って、あなたが見られるすべてのサイト、ファイル、リストアイテムを横断して検索します。モダンなサイトページは読み取れますが、クラシックページ、ニュース投稿、ページの編集には対応していません。

リスト: リストの値は各列の内部名で保存されており、画面に表示される名前とは異なる場合があります（「期限」と表示される列が DueDate であることもあります）。そのため AI は、先に sharepoint_list_columns で列を読み取ります。アイテムが 5,000 件を超えるリストでは、SharePoint はインデックス付きの列でしか絞り込みや並べ替えを行いません。

ファイルと内容: このコネクターはファイルの内容をダウンロードしません。代わりに AI がファイルのリンクを示します。約 4 MB までのテキストファイルを作成でき、既定では既存のファイルを上書きすることはありません。ライブラリ内の Excel ブックのセルを扱うには、Microsoft Excel コネクターを使います。

よくあるエラー: 401 InvalidAuthenticationToken は、承認が取り消されたかクライアントシークレットの期限が切れたことを示します。必要に応じて新しいシークレットを入力し、もう一度 Authorize with Provider をクリックします。403 accessDenied は、手順 4 のアクセス許可が不足しているか同意されていないこと、またはそのサイト、ライブラリ、リストへのアクセス権がないことを示します。404 itemNotFound は、サイト、ライブラリ、リスト、アイテムのいずれかが間違っているか、存在しないサイトパスであることを示します。個人用 Microsoft アカウントでは、すべての呼び出しが 404 または 400 になります。リストアイテムでの 400 invalidRequest は、列名が内部名ではないか、値が列に合っていないことを示します。「cannot be referenced in filter or orderby as it is not indexed」は、リストの設定でその列にインデックスを作成する必要があることを示します。409 nameAlreadyExists は、同じ名前のアイテムがすでにそのフォルダーにあることを示します。

このコネクターは、ファイルの内容のダウンロード、バイナリファイルのアップロード、サイトの作成やサイトのアクセス許可の変更、リストや列の削除、ページの編集、用語ストアとコンテンツタイプの管理は行いません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Gemini にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が Microsoft SharePoint のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「マーケティングのサイトを探して、その「ドキュメント」ライブラリで今月変更されたファイルを一覧にして。」
• 「「プロジェクト」リストで、ステータスが「オープン」で期限が金曜日より前のアイテムをすべて見せて。」
• 「「購入申請」リストにアイテムを追加して。「営業用の新しいノート PC」、金額 4,800、ステータス「保留中」で。」
• 「SharePoint で最新の出張規程を探して、どこに保存されているか教えて。」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Cursor に接続
• Meta Muse に接続