Microsoft 365 SharePoint

@mindstone/mcp-server-microsoft-sharepoint

Microsoft 365 SharePoint MCP サーバーです。サイトの検出、ドキュメントライブラリの閲覧、ページやリストの読み取り、コンテンツの検索、Microsoft Graph API を介した SharePoint のファイル／リストの変更を行えます。

コホート形式の SharePoint MCP です。独自の authenticate_sharepoint ツールを備えており、ホストからコホートの基本的な Microsoft 365 OAuth の権限に加えて、段階的に Sites.Read.All の同意を要求できます。

ステータス

• バージョン： 0.2.1 · npm
• 認証： OAuth（ホストが調整する authenticate_sharepoint による段階的な同意）(MS_CLIENT_ID)
• ツール： 46（認証 + サイト、ライブラリ、ページ、リスト、メタデータ、検索、変更）
• サーフェス： cloud-api
• 機械可読情報： STATUS.json
• 共有ライブラリ： @mindstone/mcp-server-microsoft-shared

このプロジェクトの目的

2026 年 5 月にこれを移植した時点では、Microsoft 独自の Graph MCP のラインアップに、単独の SharePoint サーバーはまだ含まれていませんでした。また、当時のコミュニティ製の選択肢は、クロステナントのシナリオで SharePoint に必要な段階的同意フローを省略しているか、SharePoint を独立したログイン対象として扱っていました。そのため、コネクターごとに個別の OAuth 認証を行い、更新トークンもそれぞれ保存していました。そこで、MindstoneRebel に含まれていたコネクターを 1:1 で移植し、Microsoft 365 の同じ 5 つのコネクター（メール、カレンダー、ファイル、Teams、SharePoint）で、1 組の認証情報と、トークンの永続化およびリクエストのタイムアウト処理に使う 1 つの共有ライブラリパッケージを共有できるようにしました。SharePoint はコホートの authenticate_microsoft_account とは別に、独自の authenticate_sharepoint ツールを宣言します。これにより、既存のメール／カレンダー／ファイル／Teams のセッションに影響を与えずに、ホストから追加の Sites.Read.All スコープを要求できます。

やり取りの例

「Strategy チームのサイトで Q3 OKR のドキュメントを見つけて、チーム全員が使える読み取り専用の共有リンクを作成してください。」

ホストが呼び出すツール：

1. search_sharepoint — Strategy サイトに絞って Q3 OKR を検索し、一致するアイテムを返します。
2. create_sharing_link — そのアイテムに対して、読み取り専用、組織全体のスコープで共有リンクを作成します。

応答（抜粋）：

{
  "match": {
    "siteId": "example.sharepoint.com,...",
    "name": "Q3-OKRs.docx",
    "webUrl": "https://example.sharepoint.com/sites/Strategy/..."
  },
  "share": {
    "type": "view",
    "scope": "organization",
    "webUrl": "https://example.sharepoint.com/:w:/r/sites/Strategy/.../EZk..."
  }
}

必要条件

• Node.js 20+
• npm
• Microsoft OAuth フローを実行し、アカウントごとのトークンファイルを ${MS_CONFIG_DIR}/credentials/${sanitised-email}.token.json に、${MS_CONFIG_DIR}/accounts.json のインデックスを作成するホストアプリケーション。このサーバーはそれらのファイルを読み込みますが、OAuth 自体は開始しません。

ワンクリックインストール

ボタンをクリックすると、ホストから次の項目を入力するよう求められます：MS_CLIENT_ID、MS_CONFIG_DIR、MS_MCP_PACKAGE_ID、MICROSOFT_REQUEST_TIMEOUT_MS。

{
  "mcpServers": {
    "Microsoft 365 SharePoint": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-microsoft-sharepoint"
      ],
      "env": {
        "MS_CLIENT_ID": "",
        "MS_CONFIG_DIR": "",
        "MS_MCP_PACKAGE_ID": "Microsoft365SharePoint",
        "MICROSOFT_REQUEST_TIMEOUT_MS": "60000"
      }
    }
  }
}

クイックスタート

インストールとビルド

cd <path-to-repo>/connectors/microsoft-sharepoint
npm install
npm run build

npx（公開後に一度実行）

npx -y @mindstone/mcp-server-microsoft-sharepoint

ローカル

node dist/index.js

設定

このサーバーは、Microsoft 365 の OAuth フローを管理するホストアプリケーションと連携して動作します。ホストが認証情報をディスクに書き込み、このサーバーがそれを読み取ります。

必須の環境変数

任意の環境変数

ホスト設定の例

Claude Desktop / Cursor

{
  "mcpServers": {
    "Microsoft365SharePoint": {
      "command": "npx",
      "args": ["-y", "@mindstone/mcp-server-microsoft-sharepoint"],
      "env": {
        "MS_CLIENT_ID": "your-entra-application-client-id",
        "MS_CONFIG_DIR": "/absolute/path/to/microsoft-config"
      }
    }
  }
}

まず @mindstone/mcp-server-microsoft-mail の authenticate_microsoft_account でサインインして基本セッションを確立し、その後、このサーバーの authenticate_sharepoint を呼び出して、追加の SharePoint Sites.Read.All スコープを要求します。

ローカル開発（npm 公開は不要）

{
  "mcpServers": {
    "Microsoft365SharePoint": {
      "command": "node",
      "args": ["<path-to-repo>/connectors/microsoft-sharepoint/dist/index.js"],
      "env": {
        "MS_CLIENT_ID": "your-entra-application-client-id",
        "MS_CONFIG_DIR": "/absolute/path/to/microsoft-config"
      }
    }
  }
}

ツール（46）

セキュリティに関する注意

• authenticate_sharepoint は SharePoint 固有の増分同意設定ツールです。それ以外のツール群の基本認証は、@mindstone/mcp-server-microsoft-mail の authenticate_microsoft_account によって行われます。
• 手動のエラーペイロードには、既存の auth_required と成功時の形式を維持しつつ、復旧用フィールド action_required と next_step が含まれます。
• 同梱されていた SharePoint ページコンテンツのサイレントフォールバックは削除されました。ハンドラーのエラーは、古いページ本文を返すのではなく、実際の失敗を表面化させます。
• ツールごとの Graph 呼び出しは、.options({signal}) を介して、呼び出し元とツール群それぞれのタイムアウトシグナルを合成したシグナルのもとで実行されます。

ライセンス

FSL-1.1-MIT — Functional Source License, Version 1.1。将来的に MIT ライセンスとなります。競合しない用途では無料で使用でき、LICENSE に記載されたコンバーター日付に MIT ライセンスへ切り替わります。