MCP を AI アシスタントとコーディングエージェントに接続する

Note

接続できるAzure Databricks MCP は、さまざまなリリース段階にあります。各機能の現在のステージについては、マネージド MCP サーバー、 MCP サービス、 Databricks でホストされる MCP サーバーを参照してください。

モデルコンテキストプロトコル (MCP) をサポートするクライアント、AI アシスタント、IDE を Databricks MCP に接続します。これにより、開発環境で Databricks のデータとツールに直接アクセスできます。

クライアントを Databricks MCP に接続すると、次のことができます。

IDE または AI アシスタントから Unity カタログの関数、テーブル、ベクターインデックスにアクセスする
Claude、Claude Code、Cursor、Replit、またはその他の MCP 対応ツールから Databricks データに直接クエリを実行する

どのように機能するのか

すべてのクライアントは、同じ方法で Databricks MCP に接続します。サーバー URL をクライアントの MCP 構成に追加し、OAuth または個人用アクセストークンで認証し、クライアントは Streamable HTTP 経由でツールを呼び出します。 URLはアクセスするMCPを決定します:Unityカタログのデータとツール用のマネージドMCPサーバー、外部ツール用の MCPサービス、または DataBricksホストのMCPサーバーのいずれかです。

Claude、Claude Code、Cursor、ChatGPT などの MCP クライアントは、Databricks MCP サーバー URL を使用して構成され、OAuth または個人用アクセストークンを使用して認証を行い、次の 3 つのエンドポイントの種類のいずれかで Streamable HTTP 経由でツールを呼び出します。Databricks データとコードは、マネージド MCP サーバーを介して行われます。MCP サービスを介したGitHubや Slack などのサードパーティ製ツール、または Databricks Apps でホストされている独自の MCP サーバー。

Requirements

サーバー URL: 使用する Databricks MCP サーバーの適切なサーバー URL を取得します。
- Azure Databricks データとコード用のマネージド MCP サーバー
- Slack、GitHub、Google Drive などのサードパーティ製アプリ向け MCP サービス
- Databricks ホステッドの MCP サーバー（Databricks Apps 上の独自の MCP サーバー向け）
リソースアクセス: 使用する MCP サーバーと基になるリソースへのアクセス権があることを確認します。たとえば、Genie マネージド MCP サーバーを使用する場合は、基になる Genie エージェントにアクセスする必要があります。
ネットワークアクセス: Databricks ワークスペースに IP アクセス制限がある場合は、クライアントの送信 IP アドレスを許可リストに追加して、ワークスペースに接続できるようにします。
- ワークスペース IP アクセスリストとアカウント IP アクセスリストのドキュメントに従って、制限が適用されているかどうかを確認します
- IP アクセスリストが有効になっている場合は、クライアントの送信 IP を識別します。通常、この情報はクライアントドキュメントで入手できます。たとえば、Claude は送信 IP アドレスをここに文書化します。
- クライアントの送信 IP が一覧に追加されていることを確認します。

認証方法

セキュリティ要件に最適な認証方法を選択します。

Method	管理対象 MCP サーバーと MCP サービス	Databricks でホストされる MCP サーバー	セキュリティレベル	最適な用途
OAuth (推奨)	サポートされている	サポートされている	高いスコープのアクセス許可、トークンの自動更新	運用環境、チーム環境、長期アクセス
個人用アクセストークン	サポートされている	サポートしていません	中 - 有効期限が切れるトークンベースのアクセス	個々の開発、テスト、短期アクセス

OAuth 認証を使用してクライアントを接続する

OAuth は、スコープ付きアクセス許可とトークンの自動更新を使用してセキュリティで保護された認証を提供します。

Note

Databricks MCP サーバーは、 MCP 承認仕様に従って両方のクライアントの種類をサポートします。

パブリッククライアント: クライアントシークレットは必要ありません
機密クライアント: クライアントシークレットを含める

クライアントの OAuth リダイレクト URL を取得する

各 MCP クライアントには、認証コールバック用の特定の OAuth リダイレクト URL が必要です。一般的なリダイレクト URL パターンは次のとおりです。

Web ベースのクライアント: https://<domain>/oauth/callback または https://<domain>/api/mcp/auth_callback
ローカル開発ツール: http://localhost:<port>/oauth/callback

クライアントのドキュメントを調べて、必要な正確なリダイレクト URL を見つけます。

Databricks OAuth アプリケーションを作成する

アカウント管理者に Databricks OAuth アプリケーションを作成してもらう。クライアント ID を取得し、クライアントが必要とする場合はクライアントシークレットを取得します。

UI ベース (アカウントコンソール)

アカウントコンソールを使用して Databricks OAuth アプリケーションを作成します。

Databricks アカウントコンソールで、[設定]> [App Connections>Add connection] に移動します。
アプリケーション設定を構成します。
- 名前: OAuth アプリケーションのわかりやすい名前を入力します (例: claude-mcp-client、 mcp-inspector)
- リダイレクト URL: 外部クライアントに必要なリダイレクト URL を追加する
- クライアントの種類: パブリッククライアント (ブラウザーベース、モバイル) の場合は、[ クライアントシークレットの生成] をオフにします。機密クライアント (サーバー側) の場合は、オンのままにします。
- スコープ: API スコープを構成します (使用可能なスコープについては、 Databricks OAuth スコープのリファレンスを参照してください)
- トークンの有効期限: 適切なトークンアクセスと更新時間を設定する

CLI

Databricks CLI を使用して Databricks OAuth アプリケーションを作成します。

all-apis スコープを使用する

custom-app-integration はアカウントレベルのコマンドであるため、ワークスペースの資格情報では機能しません。 databricks auth login --host <account-console-url> --account-id <account-id>を使用して、最初にアカウント管理者としてアカウントコンソールに対して認証を行います。

databricks account custom-app-integration create --json '{
  "name": "mcp-oauth-client",
  "redirect_urls": ["https://<your-client-redirect-url>"],
  "confidential": false,
  "scopes": ["all-apis"],
  "token_access_policy": {
    "access_token_ttl_in_minutes": 60,
    "refresh_token_ttl_in_minutes": 10080
  }
}'

詳細なスコープを使用します。 最小限の特権の原則に従って、より制限の厳しいアクセスを行う場合

より制限の厳しいアクセスを指定するには、 all-apisではなく詳細なスコープを使用します。この例では、Genie と Unity カタログのスコープを持つパブリック OAuth アプリを作成します。

databricks account custom-app-integration create --json '{
  "name": "mcp-public-oauth-app",
  "redirect_urls": ["https://<your-client-redirect-url>"],
  "confidential": false,
  "scopes": ["genie", "unity-catalog", "offline_access"],
  "token_access_policy": {
    "access_token_ttl_in_minutes": 60,
    "refresh_token_ttl_in_minutes": 10080
  }
}'

成功すると、CLI はクライアント資格情報を含む応答を返します。

{
  "client_id": "<your-client-id>",
  "client_secret": "",
  "integration_id": "<your-integration-id>"
}

<your-client-redirect-url>をクライアントの実際のリダイレクト URL に置き換えます。使用可能なスコープの一覧については、 Databricks OAuth スコープのリファレンスを参照してください。

ネットワークアクセスの構成 (省略可能)

Databricks ワークスペースに IP アクセス制限がある場合は、クライアントの送信 IP アドレスをワークスペースの許可リストに追加します。それ以外の場合、ワークスペースはクライアントからの認証要求をブロックします。 IP アクセスリストの管理を参照してください。

クライアントを構成する

Databricks で OAuth アプリケーションを作成した後、OAuth 資格情報を使用して特定の MCP クライアントを構成します。各クライアントには、独自の構成方法があります。一般的な MCP クライアントの詳細な手順については、次のプラットフォーム固有の例を参照してください。

OAuth の例

次の例では、OAuth 認証を使用して特定の MCP クライアントを構成する方法を示します。前のセクションの一般的な OAuth セットアップ手順に従い、次にこれらの例を使用して特定のクライアントを構成します。

Tip

コーディングエージェント(Claude Code、Cursor、OpenAI Codexなど)にとっては、 ucode が最も速い接続方法です。 DatabricksのCLIログインを通じて認証し、エージェントとそのMCPサーバーを一つのコマンドで設定するため、Databricks OAuthアプリケーションの作成やクライアントIDやシークレットの管理が不要です。

MCP インスペクター

MCP インスペクターは、MCP サーバーをテストおよびデバッグするための開発者ツールです。

MCP インスペクター

上記の OAuth 認証の設定に従って、インスペクター固有の設定を実行します。

リダイレクト URL:
- http://localhost:6274/oauth/callback
- http://localhost:6274/oauth/callback/debug
クライアントの種類: パブリック ([ クライアントシークレットの生成] チェックボックスをオフ)

MCP Inspector の構成:

インスペクターを実行します: npx @modelcontextprotocol/inspector。
トランスポートの種類をStreamable HTTPに設定します。
Databricks MCP サーバーの URL を入力します。
[ 認証 ] セクションで、OAuth クライアント ID を追加します。
[ 認証設定を開く] をクリックし、[ ガイド付き フロー] または [クイック フロー] を選択します。
認証が成功したら、アクセストークンを [API トークン認証] セクションのベアラートークンに貼り付けます。
[Connect] をクリックします。

MCP Inspector 認証フロー

Claude コネクタ

Claude コネクタとリモート MCP を使用して、 Claude を Databricks マネージド MCP サーバーと MCP サービスに接続します。

上記の OAuth 認証の設定に従い、次の Claude 固有の設定を使用します。

リダイレクト URL: https://claude.ai/api/mcp/auth_callback と https://claude.com/api/mcp/auth_callback
IP 許可リスト (必要な場合): Claude の送信 IP アドレスを追加します

Claude を構成します。

Claude の [設定] >Connectors に移動します。
[ カスタムコネクタの追加] をクリックします。
Databricks MCP サーバーの URL を入力します。
OAuth アプリケーションのクライアント ID (Databricks OAuth アプリ接続が機密クライアントの場合はクライアントシークレット) を入力します。
[ 追加] をクリックして完了します。

Claude でのコネクタの構成

クロード符号

Claude Codeを最速で接続する方法は ucodeで、DatabricksのCLIログインを通じて認証されます。OAuthアプリケーション、クライアントID、クライアントシークレットは不要です。

uv tool install git+https://github.com/databricks/ucode
ucode configure --agents claude --mcp <catalog>.<schema>.<service>
ucode claude

<catalog>.<schema>.<service> をMCP サービスの完全修飾名に置き換えてください。詳細は「コーディングエージェントとの統合」を参照してください。

手動設定 — 静的なOAuthクライアントを自分で設定

上記の OAuth 認証の設定に従い、次の Claude Code 固有の設定を使用します。

リダイレクト URL: http://localhost:8080/callback (Claude Code 構成のコールバックポート値と一致します)

Claude Code を構成する:

ターミナルで次のコマンドを実行し、プレースホルダーの値を置き換えます。

claude mcp add-json databricks-mcp-server \
  '{"type":"http","url":"https://<your-workspace-hostname>/api/2.0/mcp/functions/{catalog_name}/{schema_name}","oauth":{"clientId":"<your-client-id>","callbackPort":8080}}' \
  --client-secret <your-client-secret>

<your-workspace-hostname>を Databricks ワークスペースのホスト名に置き換えます。
<your-client-id>を OAuth アプリケーションのクライアント ID に置き換えます。
<your-client-secret>を OAuth アプリケーションのクライアントシークレットに置き換えます (機密クライアントを使用している場合)。
選択した MCP サーバーの URL パスを調整します。

OpenAIコデックス

OpenAI CodexをDatabricks MCPサーバーにucode接続し、Databricks CLIログインを通じて認証します。OAuthアプリケーション、クライアントID、クライアントシークレットは不要です:

uv tool install git+https://github.com/databricks/ucode
ucode configure --agents codex --mcp <catalog>.<schema>.<service>
ucode codex

<catalog>.<schema>.<service> を MCP サービスの完全修飾名に置き換えてください。 ucode MCPサーバーをあなたのCodex設定に書き込み、OAuthトークンを自動的に更新します。詳細は「コーディングエージェントとの統合」を参照してください。

ChatGPT アプリ

開発者モードと完全な MCP アプリでカスタム ChatGPT アプリを使用して、ChatGPT を Databricks マネージド MCP サーバーと MCP サービスに接続します。

カスタム ChatGPT アプリを追加するには、次のものが必要です。

開発者モードが有効になっている
ChatGPT Business、Enterprise、または Edu のワークスペース

上記の OAuth 認証の設定に従って、ChatGPT 固有の設定を実行します。

リダイレクト URL: https://chatgpt.com/connector_platform_oauth_redirect
IP 許可リスト: ChatGPT の送信 IP アドレスを追加する

ChatGPT を構成する:

ChatGPT で、[>> に移動します。
Databricks MCP サーバーの URL を入力します。
認証方法として OAuth を使用します。
OAuth アプリケーションのクライアント ID とシークレット (該当する場合) を入力します。
構成を完了し、アプリを保存します。

カーソル/ウィンドサーフ

Cursor や Windsurf などのローカル IDE を Databricks MCP サーバーに接続するには、 MCP サーバーを MCP 構成ファイルに追加します。

MCP 構成ファイルを見つけます。
- カーソル: ~/.cursor/mcp.json
- ウィンドサーフィン: ~/.codeium/windsurf/mcp_config.json
次のいずれかの構成を追加します。カーソルに関しては、 ucode が最もシンプルな選択肢です。それ以外の場合は、クライアントの種類に一致する OAuth オプションを使用します。

ucode（Cursor） — 推奨。Databricks CLI のログインを通じて認証されます

ucode MCPサーバーをローカルプロキシとして ~/.cursor/mcp.json 登録し、リクエストごとに新しいDatabricks OAuthトークンを発行します—OAuthアプリケーションやトークン保存は不要です。

Prerequisites:

Databricks CLI のインストールと認証 (databricks auth login)
uv がインストールされている

uv tool install git+https://github.com/databricks/ucode
ucode configure --agents cursor --mcp <catalog>.<schema>.<service>
ucode cursor

<catalog>.<schema>.<service> を MCP サービスの完全修飾名に置き換えてください。詳細は「コーディングエージェントとの統合」を参照してください。

機密性の高い OAuth クライアント (クライアントシークレットあり) - サーバー側または自動使用に推奨

クライアントシークレット (通常は管理者がプロビジョニング) を使用して OAuth アプリを登録している。 OAuth で mcp-remote を使用します。 mcp-remote リポジトリの手順に従って mcp-remote を設定し、OAuth 認証のセットアップに従って資格情報を構成します。

{
  "mcpServers": {
    "databricks-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://<your-workspace-hostname>/api/2.0/mcp/functions/system/ai",
        "--static-oauth-client-info",
        "{ \"client_id\": \"$MCP_REMOTE_CLIENT_ID\" }",
        "--client-secret"
      ]
    }
  }
}

<your-workspace-hostname>を Databricks ワークスペースのホスト名に置き換えます。 OAuth クライアント ID で MCP_REMOTE_CLIENT_ID 環境変数を設定し、クライアントシークレットで MCP_REMOTE_CLIENT_SECRET します。

パブリック OAuth クライアント (クライアントシークレットなし) - 個人用または対話型の使用に推奨

OAuth を使用するが、クライアントシークレットを持っていない (または管理したくない) 場合。 OAuth で mcp-remote を使用します。 mcp-remote リポジトリの手順に従って mcp-remote を設定し、OAuth 認証のセットアップに従って資格情報を構成します。

{
  "mcpServers": {
    "databricks-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://<your-workspace-hostname>/api/2.0/mcp/functions/system/ai",
        "--static-oauth-client-info",
        "{ \"client_id\": \"$MCP_REMOTE_CLIENT_ID\" }"
      ]
    }
  }
}

<your-workspace-hostname>を Databricks ワークスペースのホスト名に置き換えます。 OAuth クライアント ID を使用して環境変数 MCP_REMOTE_CLIENT_ID を設定します。

個人用アクセストークン (PAT) 認証を使用してクライアントを接続する

個人用アクセストークンは、Databricks MCP サーバーへの個々の開発、テスト、および短期的なアクセスに適した、よりシンプルな認証方法を提供します。

Note

個人用アクセストークンは、管理対象の MCP サーバーと MCP サービスでのみサポートされます。 Databricks でホストされる MCP サーバーには OAuth 認証が必要です。

MCPサービスでは、パーソナルアクセストークンを生成し、 Authorization ヘッダーのベアラートークンとして渡します。

このトークンはローカルテストに使用し、ワークフローに合った最短の有効期間を選択します。トークンをソース管理にコミットしたり、クライアント構成ファイルで共有したりしないでください。運用環境またはチーム全体のクライアント接続の場合は、PAT ではなく OAuth を使用します。コーディングエージェント(Claude Code、Cursor、OpenAI Codexなど)にとっては、 ucode が最もシンプルな選択肢です。DatabricksのCLIログインを通じて認証し、トークンを自動的に更新します。

Databricks ワークスペースで個人用アクセストークンを生成します。「Azure Databricks の個人用アクセストークン (レガシ) を使用した認証」を参照してください。
ネットワークアクセスを構成します (省略可能)。

Databricks ワークスペースに IP アクセス制限がある場合は、クライアントの送信 IP アドレスを許可リストに追加します。必要な IP アドレスを取得するには、クライアントのドキュメントまたはデプロイ環境のネットワーク構成を参照してください。
クライアントを構成します。

PAT を生成したら、認証に使用するように MCP クライアントを構成します。各クライアントには、独自の構成方法があります。一般的な MCP クライアントの詳細な手順については、以下のプラットフォーム固有の例を参照してください。

クライアントがカスタムヘッダーを要求したら、 Authorization ヘッダーのベアラートークンとしてトークンを渡します: Authorization: Bearer <YOUR_TOKEN>。

PAT の例

次の例は、個人用アクセストークン認証を使用して特定の MCP クライアントを構成する方法を示しています。最初に上記の PAT 認証の設定に従い、これらの例を使用して特定のクライアントを構成します。

Cursor

カーソルは、設定構成によって MCP をサポートします。

カーソルの設定を開きます。

次の構成を追加します ( 選択した MCP サーバーの URL を調整します)。

{
  "mcpServers": {
    "uc-function-mcp": {
      "type": "streamable-http",
      "url": "https://<your-workspace-hostname>/api/2.0/mcp/functions/{catalog_name}/{schema_name}",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      },
      "note": "Databricks UC function"
    }
  }
}

<your-workspace-hostname>を Databricks ワークスペースのホスト名に置き換えます。
<YOUR_TOKEN>を個人用アクセストークンに置き換えます。

クロードデスクトップ (Claude Desktop)

Claude Desktop は、 mcp-remote を使用して Databricks MCP サーバーに接続できます。

claude_desktop_config.json ファイルを見つけてください。
- macOS:~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:%APPDATA%\Claude\claude_desktop_config.json

次の構成を追加します ( 選択した MCP サーバーの URL を調整します)。

{
  "mcpServers": {
    "uc-function-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://<your-workspace-hostname>/api/2.0/mcp/functions/{catalog_name}/{schema_name}",
        "--header",
        "Authorization: Bearer <YOUR_TOKEN>"
      ]
    }
  }
}

<your-workspace-hostname>を Databricks ワークスペースのホスト名に置き換えます。
<YOUR_TOKEN>を個人用アクセストークンに置き換えます。
変更を有効にするには、Claude Desktop を再起動します。

Replit

Replit では、カスタム MCP サーバー構成を使用した Databricks MCP サーバーへの接続がサポートされています。

Replit ワークスペースで、[ MCP サーバーの追加] をクリックします。
Databricks MCP サーバーの URL を入力します。次に例を示します。
```
https://<your-workspace-hostname>/api/2.0/mcp/genie/{genie_space_id}
```
カスタムヘッダーを追加します。
- キー: Authorization
- 値: Bearer <YOUR_TOKEN>

Replit MCP のドキュメントを参照してください。

接続の問題のトラブルシューティング

一般的な接続の問題を診断して解決するには、次のトラブルシューティング手順に従います。

認証を検証する

接続をテストする前に、認証資格情報が正しく構成されていることを確認します。

OAuth ユーザーからマシンへの接続 (U2M)

OAuth ユーザー対マシン (U2M) 認証の場合は、 MCP Inspector との接続をテストします。 OAuth フローは、接続プロセス中に資格情報を検証します。

サービスプリンシパル (M2M)

マシン間 (M2M) OAuth によるサービスプリンシパル認証の場合は、Databricks CLI を使用して資格情報をテストします。

DATABRICKS_CLIENT_ID=<your-client-id> DATABRICKS_CLIENT_SECRET=<your-client-secret> databricks auth describe

このコマンドは、サービスプリンシパルの構成を検証し、認証された ID に関する情報を表示します。コマンドからエラーが返された場合は、サービスプリンシパルのセットアップを確認し、次のことを確認します。

Databricks アカウントにサービスプリンシパルが作成されました
クライアント ID とクライアントシークレットが正しく構成されている
サービスプリンシパルには、必要なリソースにアクセスするための適切なアクセス許可があります

ネットワーク構成を確認する

ネットワーク制限により、外部クライアントが Databricks ワークスペースに接続できなくなる可能性があります。クライアントが Databricks アカウントとワークスペースに接続できるように、Databricks IP アクセスリストポリシーが構成されていることを確認します。要件を参照してください。

クライアント固有の接続の問題を特定する

問題が解決しないかどうかを確認するには、別の MCP クライアントで接続してみてください。 Databricks では、 MCP インスペクターを使用したテストをお勧めします。接続が MCP インスペクターで動作するが、クライアントで失敗する場合は、クライアントのセットアップに問題がある可能性があります。その他のサポートについては、クライアントプロバイダーにお問い合わせください。

Databricks サポートに問題を報告する

これらのトラブルシューティング手順を完了した後も接続の問題が引き続き発生する場合:

エラーメッセージとスタックトレースについては、MCP クライアントのログ (Claude、Cursor、MCP Inspector など) を確認します。
次の診断情報を収集します。
- 使用される認証方法 (OAuth または PAT)
- MCP サーバー URL
- クライアントからのエラーメッセージ
- ネットワーク構成の詳細 (IP 制限、ファイアウォール規則)
問題を解決するには、サポートに連絡して診断情報を共有してください。

Limitations

動的クライアント登録: Databricks では、マネージド MCP サーバー、MCP サービス、または Databricks でホストされる MCP サーバーの動的クライアント登録 OAuth フローはサポートされていません。動的クライアント登録を要求する外部クライアントと IDE は、OAuth 認証を使用してサポートされていません。
Databricks でホストされる MCP サーバーの個人用アクセストークンのサポート: Databricks Apps でホストする MCP サーバーは、認証用の個人用アクセストークンをサポートしていません。

その他のリソース

マネージド MCP サーバーを使用してエージェントを Unity Catalog データに接続する
MCP サービスを使用してエージェントをサードパーティのツールに接続してサードパーティのサービスにアクセスする
組織固有のツール用に独自の MCP サーバーをホストする
Claude CodeやCursorのようなコーディングエージェントに開発パターンを教えるためのAIコーディングアシスタント向けのエージェントスキル Azure Databricks

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-08-17

MCP を AI アシスタントとコーディング エージェントに接続する

どのように機能するのか

Requirements

認証方法

OAuth 認証を使用してクライアントを接続する

クライアントの OAuth リダイレクト URL を取得する

Databricks OAuth アプリケーションを作成する

UI ベース (アカウント コンソール)

CLI

ネットワーク アクセスの構成 (省略可能)

クライアントを構成する

OAuth の例

MCP インスペクター

Claude コネクタ

クロード符号

OpenAIコデックス

ChatGPT アプリ

カーソル/ウィンドサーフ

個人用アクセス トークン (PAT) 認証を使用してクライアントを接続する

PAT の例

Cursor

クロードデスクトップ (Claude Desktop)

Replit

接続の問題のトラブルシューティング

認証を検証する

OAuth ユーザーからマシンへの接続 (U2M)

サービス プリンシパル (M2M)

ネットワーク構成を確認する

クライアント固有の接続の問題を特定する

Databricks サポートに問題を報告する

Limitations

その他のリソース

フィードバック

その他のリソース

MCP を AI アシスタントとコーディングエージェントに接続する

UI ベース (アカウントコンソール)

ネットワークアクセスの構成 (省略可能)

個人用アクセストークン (PAT) 認証を使用してクライアントを接続する

サービスプリンシパル (M2M)