Microsoft 365 CopilotとGRiXを接続する


Microsoft 365 CopilotからGRiXを利用するための接続方法を説明します。
Microsoft 365 Copilot:https://m365.cloud.microsoft/chat

GRiXとMicrosoft 365 Copilotは、MCP(Model Context Protocol)を利用して接続します。
認証にはOAuth 2.0を使用します。

設定は大きく以下の3ステップです。
GRiXでCopilot用の接続情報を確認する
Teams Developer PortalでOAuthクライアントを登録する
Microsoft 365管理センターでMCPコネクタを作成する

<事前準備>
Microsoft 365側で以下が必要です。
Microsoft 365管理センターへの管理者権限
Teams Developer Portalへのアクセス
GRiXのMCP利用権限
MicrosoftのCustom Federated Connectorを作成する場合、Microsoft 365管理センターではGlobal AdministratorまたはAI Administratorなどの権限が必要です。

セキュリティ・認証・MCPの技術仕様を確認したい場合は、以下の[技術仕様・セキュリティ情報]をご確認ください。

1. GRiXでMCPを有効にする
GRiXの設定画面から、[MCP / AIエージェント] を開きます。
[MCP利用]を[有効にする] に設定します。
続いて、AIツールとして [Copilot] を追加し、右側の [設定] をクリックします。


<Copilotの接続情報を確認する>
Copilotの設定画面では、Microsoft側の設定で使用する以下の情報を確認できます。
MCP URL
Client OAuth ID
OAuth Client Secret
Authorization Endpoint
Token Endpoint
Refresh Endpoint
OAuth Scopes
Callback URL
各項目は [コピー] ボタンからコピーできます。


これらの値は、次のTeams Developer PortalでのOAuth設定に使用します。
※ Client OAuth IDやOAuth Client Secretを再発行すると、既存のMicrosoft側の接続設定に影響する場合があります。

2. Teams Developer PortalでOAuthクライアントを登録する
Teams Developer Portalの [OAuth クライアントの登録] を開きます。
画面上部の [+ 新しい OAuth クライアントの登録] をクリックします。


※Microsoftでは、外部サービスをOAuth 2.0で認証する場合、Teams Developer PortalにOAuthクライアントを登録します。

<GRiXのOAuth情報を入力する>
GRiXのCopilot設定画面に表示されている値を、Teams Developer Portalの各項目に入力します。
_
【Teams Developer Portal】【GRiX】
Client IDClient OAuth ID
Client secretOAuth Client Secret
Authorization endpointAuthorization Endpoint
Token endpointToken Endpoint
Refresh endpointRefresh Endpoint
ScopesOAuth Scopes

<Callback URLについて>
GRiXの [Callback URL] には、Microsoft 365 Copilot用のCallback URLが表示されています。
MicrosoftがOAuth 2.0用のRedirect URIとして指定しているURLは以下です。
https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect
GRiX側のCallback URLにも同じURLが設定されていることを確認してください。

<OAuthクライアントを保存する>
必要な情報を入力したら、OAuthクライアントを保存します。
保存すると、Teams Developer Portal上で OAuth Client Registration ID が発行されます。
このIDは、後ほどMicrosoft 365管理センターでMCPコネクタを作成する際に使用するため、コピーしておいてください。

3. Microsoft 365管理センターでコネクタを作成する
Microsoft 365管理センターを開きます。

左メニューから、
[Copilot]→[コネクタ]
を選択します。
続いて [ギャラリー] タブを開きます。

<新しいコネクタを作成する>
[ギャラリー]で [組織によって作成されました] を選択します。
表示される [新しいコネクタを作成する] の [追加] をクリックします。



4. 「MCP サーバーに接続する」を選択する
カスタムコネクタの種類が表示されます。
[MCP サーバーに接続する] の [追加] をクリックしてください。


GRiXは、データをMicrosoft 365側へ事前同期するのではなく、CopilotからGRiXのMCP Serverへ接続してデータを取得します。そのため、[データ ソースから同期する]ではなく[MCP サーバーに接続する] を選択します。MicrosoftもCustom Federated Connectorを、MCP Serverへリアルタイムに接続する方式として案内しています。

5. GRiXのMCP情報を入力する
[MCP サーバーに接続する]画面で、コネクタの情報を入力します。

表示名
Copilot上でユーザーに表示される名称です。
例: GRiX

説明
GRiXコネクタの用途を入力します。
例: GRiXのコンテンツ情報や顧客の閲覧アクティビティをMicrosoft 365 Copilotから参照します。

MCP エンドポイント URL
GRiXのCopilot設定画面に表示されている [MCP URL] をコピーして入力します。
例: https://api.grixsales.com/mcp



6. 開発者・サービス情報を入力する
続いて、以下の情報を入力します。
開発者または会社名
WebサイトのURL
プライバシーポリシーのURL
使用条件のURL
Microsoftでは、Custom Federated Connectorの登録にこれらの開発者・法務情報を必要としています。

AimyTech / GRiXの場合は、自社サイト・プライバシーポリシー・利用規約のURLを設定してください。
会社名:AimyTech株式会社
プライバシーポリシーのURL:https://aimytech.notion.site/privacypolicy
使用条件のURL(利用規約):https://aimytech.notion.site/termsofuse



7. OAuth認証を設定する
画面下部の [認証の種類] からOAuth 2.0を選択します。
続いて、手順2でTeams Developer Portalに登録した OAuth Client Registration ID を参照IDとして入力します。

※Microsoft 365 Copilotは、このOAuth設定を利用してGRiXへアクセスします。
接続イメージは以下の通りです。
text
Copied!
Microsoft 365 Copilot
↓
OAuth 2.0
↓
GRiXユーザー認証
↓
GRiX MCP Server
↓
GRiX
必要事項をすべて入力したら、内容を確認してコネクタを作成します。

8. 作成したコネクタを確認する
Microsoft 365管理センターの
[Copilot]→[コネクタ]→[自分のつながり]
を開きます。
作成したGRiXコネクタが一覧に表示されていることを確認してください。



9. 利用ユーザーを設定する
作成したコネクタは、対象となるユーザーやグループへ段階的に公開できます。
Microsoftでは、以下の方法が用意されています。
特定のユーザーに公開
特定のグループに公開
すべてのユーザーに公開
最初はテストユーザーのみを対象にして接続確認を行うことをおすすめします。
MicrosoftのStaged rolloutを利用すると、選択したユーザー・グループで検証した後、全ユーザーへ展開できます。設定変更の反映には最大15分程度かかる場合があります。

<接続後にできること>
接続後は、Microsoft 365 CopilotからGRiXのMCP Toolsを利用できます。
例えば、GRiXの閲覧アクティビティについて以下のように確認できます。
・今日発生したGRiXの閲覧アクティビティを確認して
・株式会社○○の最近の閲覧履歴を確認して
・この閲覧アクティビティの詳細を確認して

<注意事項>
・Client OAuth ID / Secretの再発行
GRiX側でClient OAuth IDまたはOAuth Client Secretを再発行した場合、Microsoft側に登録しているOAuth設定も更新する必要があります。接続に問題がない場合は、原則として再発行しないでください。

・OAuth認証とMCP接続は別の設定です
Microsoft 365 Copilotとの接続では、
Teams Developer PortalでOAuthクライアントを登録
Microsoft 365管理センターでMCPコネクタを作成
の両方が必要です。
OAuthクライアントを登録しただけでは、CopilotからGRiX MCPを利用できません。

・「データ ソースから同期する」は選択しません
GRiXはMCP Serverを通じてリアルタイムに接続するため、
[MCP サーバーに接続する]
を選択してください。

・Microsoft側への反映に時間がかかる場合があります
Microsoftによると、コネクタの設定変更が反映されるまで最大15分程度かかる場合があります。

<設定の流れ>
text
Copied!
GRiX
MCPを有効化
↓
Copilotを追加
↓
Copilot設定情報を確認
↓
「Teams Developer Portal」で OAuthクライアントを登録
↓
OAuth Client Registration IDを取得
↓
「Microsoft 365管理センター」で新しいコネクタを作成
↓
「MCP サーバーに接続する」を選択
↓
GRiX MCP URLを登録
↓
OAuth Client Registration IDを設定
↓
コネクタ作成
↓
対象ユーザーへ公開
↓
Microsoft 365 CopilotからGRiXを利用


<技術仕様・セキュリティ情報>
GRiX MCPの認証方式、権限管理、テナント分離、MCP Tools、API / Webhook仕様など、技術的な詳細については以下をご確認ください。

GRiX MCP / API / Webhook 連携仕様・セキュリティガイド

対象:
情報システム部門
セキュリティ部門
Microsoft 365管理者
導入審査・セキュリティチェック担当者