外部MCPサーバーを登録したりHTTP接続を作成したりする際に、このリファレンスを使ってプロバイダーの設定やスコープを確認してください。
Azure Databricksでは、一部の API ツール プロバイダー用のマネージド OAuth フローが提供されます。 独自の OAuth アプリを登録したり、資格情報を管理したりする必要はありません。 Azure Databricks では、開発とテストにマネージド OAuth を推奨しています。 運用環境のユース ケースでカスタム OAuth 資格情報の生成が必要な場合は、プロバイダーのドキュメントを参照してください。
Requirements
OAuth User to Machine Per User認証タイプでUnity CatalogのHTTP接続を作成し、OAuth Providerのドロップダウンメニューからプロバイダーを選択してください。 詳細な手順については、「 外部サービスへの接続を作成する」を参照してください。
マネージドOAuthサポートのあるサービス
次の統合では、Azure Databricksが管理し、バックエンドに安全に格納する OAuth 資格情報を使用します。 プロバイダーは、最初の使用時に承認するように各ユーザーに求めます。
| プロバイダー | 構成に関する注意事項 | サポートされているスコープ | Description |
|---|---|---|---|
| Google Drive API | なし | https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/documents.readonly https://www.googleapis.com/auth/spreadsheets.readonly offline_access |
ユーザーがアクセスできるGoogleドライブファイル(GoogleドキュメントやGoogleスプレッドシートなど)、共有、コメント、ファイル管理へのアクセスも可能です。 |
| Gmail API | なし | https://www.googleapis.com/auth/gmail.modify offline_access |
Gmailのメッセージ、スレッド、下書き、ラベルへのアクセスと書き込みが可能です。 |
| Google カレンダー API | なし | https://www.googleapis.com/auth/calendar.readonly https://www.googleapis.com/auth/calendar.events offline_access |
Google Calendar のカレンダーと空き時間情報への読み取りアクセス、およびイベントへの読み取り/書き込みアクセス。 |
| Microsoft 365 API | なし | Microsoft 365のスコープを参照してください。 | Microsoft Graphを通じてSharePointやOneDriveファイル、Outlookメールやカレンダー、Microsoft Teamsのチャット、チャンネル、会議への読み書きアクセスが可能です。 |
| グリーン | ホストが必要です。 ベース パスは構成可能です (既定値は /mcp/default)。 |
mcp |
Glean エンタープライズ検索、チャット、ドキュメント、エージェント ツールにアクセスします。 |
| GitHub | OAuthのスコープではなくGitHubアプリの権限を使用しています。 OAuthのスコープフィールドは使用されません。 | コンテンツ: 読み取りと書き込み、Issue: 読み取りと書き込み、プル要求: 読み取りと書き込み、メタデータ: 読み取り、メンバー: 読み取り、プロジェクト: 読み取り | GitHubリポジトリのコンテンツ、課題、プルリクエストへの読み書きアクセス、組織メンバーやプロジェクトデータへの読み取りアクセス。 |
| Atlassian | なし | read:jira-work read:page:confluence read:space:confluence read:comment:confluence read:hierarchical-content:confluence search:jira-work search:confluence read:me read:account write:jira-work write:page:confluence offline_access |
Jira の課題と Confluence のページへの読み取りおよび書き込みアクセス、ならびに Jira と Confluence のコンテンツの検索。 |
| Slack | なし | search:read.public search:read.private search:read.mpim search:read.im search:read.files search:read.users channels:history groups:history mpim:history im:history canvases:read users:read users:read.email chat:write canvases:write channels:read groups:read im:read mpim:read channels:write groups:write im:write mpim:write reactions:read reactions:write |
Slackのメッセージ、ファイル、チャンネル、キャンバス、ユーザーの検索;チャンネル、グループ、MPIM、DMの履歴や詳細を読む;メッセージを投稿しキャンバスを書き;会話を作成・管理;反応を読み、追加できます。 |
もしAzure Databricksがユーザーが接続を承認した後にプロバイダーにスコープを追加しても、そのユーザーの接続は自動的に新しいスコープを受け取るわけではありません。 ユーザーは新しいスコープを必要とする機能を利用する前に再接続する必要があります。
Microsoft 365 の適用範囲
Microsoft 365 APIプロバイダーはMicrosoft Graph APIを介して接続されます。 以下の表は、Azure Databricksが要求する各Microsoft Graph権限(スコープ)の目的を、そのスコープがサポートするMicrosoft 365コンテンツごとにまとめています。
スコープは、接続がユーザーのために試みることができる最大アクションセットを定義します。 接続がアクセスできるコンテンツは、組織が接続をどのように設定するかや、アクセスするユーザー自身のMicrosoft 365権限に依存します。
.Allで終わるスコープは組織全体の権限であり、通常は組織を代表してMicrosoft 365管理者の同意が必要です。実効的なアクセスは依然として接続の権限モデルとアクセスユーザーの権限に依存します。
ここに挙げられている範囲は代表的なものであり、変更されることがあります。 ユーザーが接続した際に、Microsoftの同意画面に、接続のために要求された正確なスコープセットが表示されます。
以下の表はSharePointおよびOneDriveファイルのスコープを示しています:
| Scope | Purpose |
|---|---|
Sites.Read.All |
すべてのサイトコレクションのアイテムを読み、接続がSharePointサイトを検索できるようにします。 |
Sites.ReadWrite.All |
すべてのサイトコレクションのアイテムを読み書きしてください。 |
Files.Read.All |
サインインしているユーザーがアクセスできるすべてのファイルを読みます。 |
以下の表はMicrosoft Teamsのスコープを示しています:
| Scope | Purpose |
|---|---|
Chat.Read |
サインインしているユーザーのチャットメッセージを読んでください。 |
Channel.ReadBasic.All |
サインインしたユーザーがアクセスできるチャンネル名や説明を読みます。 |
ChannelMessage.Read.All |
サインインしているユーザーがアクセスできるチャネルのメッセージを読み取る。 |
ChatMessage.Send |
サインインしているユーザーの代わりにチャットメッセージを送信してください。 |
ChannelMessage.Send |
サインインしているユーザーの代わりにチャネルメッセージを送信します。 |
Team.ReadBasic.All |
サインインしたユーザーがアクセスできるチーム名や説明を読みましょう。 |
以下の表はOutlookメールのスコープを示しています:
| Scope | Purpose |
|---|---|
Mail.Read |
サインインしたユーザーのメールを読みましょう。 |
Mail.Read.Shared |
サインインしたユーザーがアクセスできるメール、共有メールや委任メールも読み取れます。 |
Mail.ReadWrite |
サインインしたユーザーのメールを読み書きします。 |
Mail.Send |
サインイン済みユーザーとしてメールを送信します。 |
以下の表はカレンダーの範囲を示しています:
| Scope | Purpose |
|---|---|
Calendars.Read |
サインインしているユーザーのカレンダーでイベントを読みます。 |
Calendars.Read.Shared |
サインインしたユーザーがアクセスできるカレンダーのイベントを読み、共有カレンダーも含まれます。 |
Calendars.ReadWrite |
サインインしているユーザーのカレンダーでイベントを読み書きします。 |
以下の表はオンライン会議の範囲を示しています:
| Scope | Purpose |
|---|---|
OnlineMeetingTranscript.Read.All |
サインインユーザーのオンライン会議の書き起こしを読みましょう。 |
OnlineMeetingAiInsight.Read.All |
サインインユーザーのオンライン会議から作成されたAI生成の洞察(会議ノートなど)を読みましょう。 |
OnlineMeetingArtifact.Read.All |
サインインユーザーのオンラインミーティングから、出席報告書などのアーティファクトを読み取ることができます。 |
OnlineMeetingRecording.Read.All |
サインインしたユーザーのオンライン会議の録画を読みましょう。 |
以下の表は、識別と認証のスコープを示しています:
| Scope | Purpose |
|---|---|
User.Read |
サインインしているユーザーのプロフィールを読んで識別してください。 |
User.ReadBasic.All |
他のユーザーの基本的なプロフィールを読み、コンテンツで言及されている人物を特定しましょう。 |
offline_access |
ユーザーが毎回のリクエストで再認証しないように、リフレッシュトークンで接続を維持してください。 |
openid |
OpenID Connectでサインインしてください。 |
profile |
サインイン時にユーザーの基本プロフィールを読みます。 |
email |
サインイン時にユーザーのメールアドレスを読みます。 |
必要に応じて、マネージド OAuth で使用される次のリダイレクト URI を許可リストに登録します。
| 雲 | リダイレクト URI |
|---|---|
| AWS | https://oregon.cloud.databricks.com/api/2.0/http/oauth/redirect |
| Azure | https://westus.azuredatabricks.net/api/2.0/http/oauth/redirect |
| GCP | https://us-central1.gcp.databricks.com/api/2.0/http/oauth/redirect |
Glean、GitHub、Atlassian、Slackなど、公開されたModel Context Protocol(MCP)サーバーを持つマネージドOAuthプロバイダーの場合、Azure DatabricksはMCPサービスとしてサーバーを登録した際にOAuthの認証情報を管理できます。 外部 MCPサーバーを参照してください。