MS 365-21V MCP Server

MS 365-21V MCP Server

MCP に対応した AI クライアントから、あなたのアカウントで世纪互联の Microsoft 365 を利用できます。

メールの確認、予定の調整、OneDrive と SharePoint の検索を行い、Microsoft Graph 中国リージョンに接続します。ユーザー権限、操作の確認、監査の境界は維持されます。

クイックスタート · 完全なデプロイ · 利用シナリオ · ツール一覧 · English

ワンクリックで接続（管理者によるデプロイ済みの場合）

管理者がサービスをデプロイし、利用権限を割り当てたら、各クライアントの手順に従って MCP アドレスを追加し、OAuth にログインします。クライアントで client id / secret を手動入力する必要はありません。

Claude Code：プロジェクトのルートディレクトリにある .mcp.json に以下の設定を追加します。既存の mcpServers がある場合は、サービス項目を統合してください。

{
  "mcpServers": {
    "ms365-21v": {
      "type": "http",
      "url": "https://your-mcp-host.example.cn/mcp"
    }
  }
}

url を管理者から受け取ったアドレスに置き換え、Claude Code を起動して /mcp を実行し、プロンプトに従ってログインします。Claude Code 公式ドキュメント

Claude Desktop：Customize（カスタマイズ）→ Connectors（コネクタ）→ Add custom connector（カスタムコネクタを追加） でリモート MCP アドレスを入力し、プロンプトに従って接続してログインします。上記の Claude Code 用 JSON を Desktop のローカル設定に直接追加しないでください。リモート接続は Anthropic のクラウドから開始されるため、サービスアドレスは Anthropic からアクセスできる必要があります。お使いのコンピューターの localhost は指定できません。Claude Desktop 公式ドキュメント

WorkBuddy、Qoder Work、Codex、または Dify を使用していますか？クライアント接続ガイドをご覧ください。ゼロから自分でデプロイしますか？クイックスタートをご覧ください。

Microsoft または 21Vianet の公式製品ではありません。世纪互联テナントと管理者の承認が必要です。グローバル版 Microsoft 365 や個人用 Outlook アカウントへの直接接続には対応していません。この記事の業務例には、該当するモジュールと権限が必要です。初期設定では個人プロフィールの照会のみが有効です。

どのようなことができるか

AI への指示	機能	有効化の条件
「自分のプロフィールを取得して、現在ログインしているアカウントを確認してください。」	OAuth → Graph の接続確認	クイックスタートのデフォルトシナリオ
「最近のメールを 5 件表示してください。件名と送信者のみ表示してください。」	メールの読み取り	Mail モジュール、Mail.Read、mcp.mail
「明日の会議に時間の重複がないか確認してください。」	予定の競合分析	Calendar + Smart モジュール、該当する権限とロール
「OneDrive でプロジェクト計画を検索してください。」	ファイル検索	OneDrive モジュール、Files.Read、mcp.drive
「返信内容をまとめて、送信前に確認させてください。」	メールの書き込みと確認	追加の書き込み権限。MCP_SEND_MODE=confirm を維持

ツールは AI クライアントが利用するデータを返します。MCP に接続したことで、ユーザーが本来持っていないデータ権限が付与されることはありません。ロール、scope、ツールの対応関係についてはツール一覧をご覧ください。

21V 版を専用に開発した理由

• 中国リージョンの ID とデータエンドポイント：グローバル版サービスのドメインを置き換えるだけでなく、21V Entra と Microsoft Graph 中国リージョン向けに設計されています。
• クライアント接続の統一：Streamable HTTP + OAuth bridge により、1 つの MCP アドレスで接続できます。サーバー側では、現在のユーザーの delegated permissions / OBO を使用します。
• ツールと書き込み操作を制御：App Roles、モジュールと scope によるフィルタリング、よく使うツールへの直接アクセスと詳細なツールの検索、確認と秘匿化された監査に対応します。

メール、カレンダー、OneDrive、SharePoint、Teams、連絡先、組織ユーザー、Microsoft Search、インテリジェントな情報集約に対応しています。コードにツールが実装されていることは、テナントで承認済みであることや、グローバルクラウドのすべての API が 21V で利用できることを意味しません。

クイックスタート

すでにデプロイされたサービスを利用しますか？

リポジトリのクローンや Entra アプリの作成は不要です。管理者から HTTPS の MCP アドレスと利用権限を受け取り、Streamable HTTP と OAuth に対応したクライアントに追加してからログインします。ユーザーガイドをご覧ください。

初めてデプロイしますか？まずは「自分のプロフィールを読み取る」から始めましょう

Node.js 22+、Git、Entra アプリの設定、権限の同意、ロールの割り当てができる管理者を用意してください。まずクイックスタートに従って単一アプリの設定を完了し、次を実行します。

git clone https://github.com/mdwsk88/ms-365-21v-mcp-server.git
cd ms-365-21v-mcp-server
npm run setup

ウィザードで尋ねられるのは Tenant ID、API Client ID、サービスアドレスのみです。最小限の .env を生成し、既存ファイルを上書きせず、コマンドラインに client secret を入力するよう求めることもありません。.env の MS_CLIENT_SECRET を編集し、Secret ID ではなく Value を使用してから、次を実行します。

npm run doctor
npm ci
npm run build
npm run start:http

ローカルのデスクトップクライアントは http://localhost:3000/mcp に接続します。リモートまたはクラウドのクライアントには、アクセス可能な HTTPS アドレスが必要です。クラウドクライアントの localhost はお使いのコンピューターを指しません。

**成功の基準：**クライアントでログインし、auth_status を呼び出してから、graph_get_me の実行に成功することです。ヘルスチェックに合格したり、ツールが表示されたりしても、Graph の権限設定が完了したとは限りません。

初期設定では OAuth、App Roles、監査、操作の確認を有効にし、個人プロフィールのモジュールのみを読み込みます。必要に応じてメールやカレンダーなどの機能を有効にしてください。すべての権限を一度に申請する必要はありません。読み取り専用メールを段階的に有効にする

既存のデプロイでは、.env を再生成したり上書きしたりせず、まず npm run doctor を実行してください。Docker、2 アプリ構成、リバースプロキシ、本番環境の確認については完全なデプロイガイドをご覧ください。

公開済み Docker イメージを使用する

Entra と .env の設定後は、ローカルでビルドせずにイメージを直接利用できます。

docker compose -f docker-compose.release.yml pull
docker compose -f docker-compose.release.yml up -d

デフォルトのイメージは ghcr.io/mdwsk88/ms-365-21v-mcp-server:v0.2.0 で、Linux amd64 / arm64 に対応しています。古い Compose ファイルを使用する場合は、上記のコマンドを実行する前に .env で MCP_IMAGE_TAG=v0.2.0 を設定してください。すでに設定されている場合は、指定したバージョンが優先されます。設定ファイルのダウンロード、初回起動、アップグレードのロールバックについてはDocker イメージガイド、更新履歴についてはリリースをご覧ください。

設定を誤った場合、どこを確認すればよいですか？

npm run doctor
npm run --silent doctor -- --json

オフライン検査では、資格情報の不足やプレースホルダー、クラウドエンドポイントの誤り、アドレスの上書き、ポート形式、単一アプリ／2 アプリの資格情報の不一致など、よくある問題を確認できます。設定値は出力せず、ネットワークへのアクセスや Entra の変更も行いません。検査に合格しても、管理者の同意、Conditional Access、実際の OAuth／Graph 呼び出しが検証済みであることを意味しません。

よくある質問と検査の範囲

客户端兼容性

仓库此前记录 WorkBuddy、Qoder Work、Codex 和 Dify 已完成远程连接、OAuth、工具发现与调用验证；这不是本次维护对这些客户端最新版的重新认证。详细记录保留在完整部署说明。

其他客户端需要支持 Streamable HTTP、OAuth 资源元数据/授权服务器发现、浏览器回调和 Bearer token。客户端能打开登录页面，也仍可能被租户 MFA、设备合规或用户分配策略拦截。

安全边界

远程服务使用 HTTPS；生产凭据放入 Secret Manager；只授予实际需要的 Graph delegated permissions 和 App Roles。不要为解决登录问题关闭认证或直接开放全部模块。

使用中国区 Graph 不自动保证端到端数据不出境：工具结果还会发送给你选择的 AI 客户端/模型服务。上线前需审核客户端数据流、日志留存、模型供应商及组织合规要求。详见威胁模型和安全策略。

文档与参与

目标	入口
首次跑通、检查配置、逐步启用功能	快速上手
Docker、双应用、角色、生产部署	完整部署
实际使用方式与提示词	用户使用说明
工具及所需权限	工具目录
回调、设备策略与登录问题	Entra 登录排障
后续维护优先级与发布记录	维护路线 · Changelog

项目解决了你的 21V 接入问题，欢迎点一个 Star，也欢迎提交脱敏的使用反馈或客户端兼容性记录。贡献前请阅读 CONTRIBUTING.md；安全漏洞不要公开提交 Issue。

License

Apache License 2.0。Microsoft、Microsoft 365、Microsoft Entra、Microsoft Graph 等名称属于各自商标权利人，参见 TRADEMARKS.md。