Claudeデスクトップに接続
Unity Gatewayを通じて、モデル、MCPツール、およびスキルを使用して コード または Cowork でClaude desktopを使用します。Claude desktopはAnthropicサブスクリプションリレーもサポートしています。
前提条件
Databricks ワークスペースの URL、使用するモデルとツールへのアクセス権、およびClaude デスクトップの最新バージョンが必要です。
Windows では、ug configure を実行する前に Claude デスクトップを少なくとも 1 回開き、アプリがローカルデータを初期化できるようにしてください。
Anthropicサブスクリプションリレーを使用する場合は、Claude Code CLIをインストールしてください。
Unity Gateway CLIを使用して接続する（推奨）
ugをインストールし、対話型ターミナルで次のコマンドをランします。
ug configure --agents claude
ワークスペースを選択してサインインしてください。このコマンドは、Claude Code とインストールされている Claude デスクトップ作業エージェントの両方を同じワークスペースに対して設定します。ug は、ワークスペースで利用可能なモデル、MCPサーバー、スキル、および認証情報の更新設定を使用して、Claude デスクトッププロファイルを作成および選択します。
Claudeデスクトップを開くか再起動し、 コード または コラボレーション で会話を開始します。モデルピッカーを使用してモデルを変更します。
MDM でデプロイ
モバイルデバイス管理（MDM）を使用して組織全体にClaudeデスクトップを導入するには、AnthropicのMDM導入ガイドをご覧ください。
サポートされている機能と制限事項
この設定では、Claudeデスクトップのサードパーティ推論モードを使用します。
機能 | サポート |
|---|---|
Code tabとCowork tab | Unity Gatewayを介したモデル推論でサポートされています。 |
MCPサーバー、ツール、スキル | Unity GatewayからのMCPサーバー、ツール、および共有スキルをサポートしています。 |
スケジュールされたタスク | サポートされています。スケジュールされたタスクは、標準のClaudeデスクトップと同じように機能します。 |
Anthropicサブスクリプションリレー | サポートされています。リレーを構成する前に、Claude Code CLIをインストールします。 |
Smart Routing | サポートされていません。 |
手動でセットアップ
このセットアップは、ugが使用できない場合にのみ使用してください。OAuthクライアントIDと、手動で構成されたClaude desktopプロファイルが必要です。
1. OAuth クライアント ID を取得する
defaultのClaudeクライアントID https://claude.ai/oauth/mcp-oauth-client-metadata を使用します。アカウント管理者がOAuthアプリを作成する必要はありません。default OAuth クライアント IDを参照してください。
独自のOAuthアプリを使用
アカウント管理者にOAuthアプリケーション接続を作成してもらう。Databricksアカウントコンソールで、 Settings > App connections > Add connection を開き、以下を使用します。
設定 | Value |
|---|---|
IDタイプ | 標準アプリケーション |
アプリケーション名 |
|
クライアントシークレットを生成 | 未チェック (パブリッククライアント) |
リダイレクトURL |
|
アクセススコープ |
|
接続を保存し、 Client ID をコピーします。スキルを接続する場合は、http://127.0.0.1:53280/callbackも登録してください。
2. Unity Gateway に接続する
Claude desktopのサインイン画面から、 ヘルプ > トラブルシューティング > 開発者モードを有効にする を選択し、次に 開発者 > サードパーティの推論を構成する を選択します。
接続 ページで ゲートウェイ を選択し、以下を入力します：
設定 | Value |
|---|---|
資格情報の種類 | インタラクティブサインイン |
ゲートウェイのベースURL |
|
クライアントID | OAuthクライアントID |
発行者URL |
|
ベアラートークン | アクセストークン |
スコープ |
|
追加 | 有効 |
リダイレクトポート |
|
<workspace-hostname> を Databricks ワークスペースのホスト名に置き換えます。その他の設定はdefaultのままにします。フィールドの詳細については、Anthropic のゲートウェイ設定を参照してください。
[接続のテスト] を選択してDatabricksにサインインします。 [変更の適用] 、次に [保存して再起動] を選択します。サインイン画面でサードパーティの構成を選択し、 [コード] または [共同作業] で会話を起動します。
3. MCPツールとスキルを追加する
開発者 > サードパーティ推論の設定 > コネクタ を開きます。 管理対象MCPサーバー の下に、使用する各MCPまたはスキルレジストリのエントリを追加します。
両方のタイプのコネクタに次の設定を使用します。
設定 | Value |
|---|---|
交通 | ストリーム可能なHTTP |
OAuth | 独自のクライアントを持ち込む |
クライアントID | OAuthクライアントID |
クライアントのシークレット | 空白のままにする |
認可サーバー |
|
スコープ |
|
リクエスト | 有効 |
コールバックホスト |
|
MCPの場合、ワークスペースの Unity Gateway > MCP の下で3部構成の名前を探します。コネクタにわかりやすい名前を付け、 コールバックポート を53180に設定し、このURLを使用します。
https://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service-name>?o=<workspace-id>
スキルについては、コネクタに databricks-skill-registry という名前を付け、 コールバックポート を 53280 に設定して、次を使用します。
https://<workspace-hostname>/ai-gateway/skills/?schema=<catalog>.<schema>
?schema の前に後続のスラッシュを維持します。複数のスキーマを含めるには、パラメーター：?schema=main.default&schema=ml.prodを繰り返します。これらのスキルは、コネクタを介してツールとしてClaudeに公開されます。
各コネクタについて、 Sign in & test を選択し、サインインを完了します。 「変更の適用」 を選択し、 「保存して再起動」 を選択します。Claudeに、接続されたツールまたはスキルをフルネームで使ってもらうように指示します。アクセス要件やその他のオプションについては、ツールとスキルの追加をご覧ください。
MCPツールをClaudeアカウントに接続する
system.ai.dbsql の場合は、まず Unity Gateway ベータ版を有効にしてください。
カスタムコネクタを使用して、ClaudeアカウントでWebまたはデスクトップのClaudeにDatabricks MCPツールを追加します。
-
Claudeで、 設定 > コネクタ > カスタムコネクタの追加 を開きます。
-
MCP URLを入力します。
Texthttps://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service>?o=<workspace-id> -
OAuthクライアントIDには、default ClaudeクライアントIDである
https://claude.ai/oauth/mcp-oauth-client-metadataを入力してください。 追加 を選択し、サインインを完了します。 -
会話の中でコネクタを有効にし、Claudeにそのツールの一つを呼び出すように頼みます。
system.ai.dbsqlについては、SELECT 1 AS resultを試してください。
独自のOAuthアプリを使用
アカウント管理者にOAuthクライアントを作成してもらう。MCPの場合は、ai-gatewayスコープを選択し、両方のリダイレクトURLを登録します。
https://claude.ai/api/mcp/auth_callbackhttps://claude.com/api/mcp/auth_callback
ステップ3で、そのクライアントIDを入力し、機密クライアントの場合はそのシークレットを入力します。
ワークスペースで受信IPが制限されている場合は、Claudeの送信IPを許可してください。権限、プロバイダーのログイン、トラブルシューティングについては、MCP認証を参照してください。
ローカルテスト用の個人用アクセストークンを使用
このオプションを使用するには、npxと個人用アクセストークンがインストールされたNode.jsが必要です。これはDatabricksが提供および登録したMCPと、ワークスペースMCP Endpointで機能します。Databricks AppsでホストされているサーバーにはOAuthが必要です。
このエントリを macOS では ~/Library/Application Support/Claude/claude_desktop_config.json の claude_desktop_config.json に、Windows では %APPDATA%\Claude\claude_desktop_config.json の に Merge します。
{
"mcpServers": {
"databricks-tools": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service>?o=<workspace-id>",
"--header",
"Authorization: Bearer <databricks-pat>"
]
}
}
}
プレースホルダーを置き換え、トークンをソース管理から除外して、Claudeデスクトップを再起動します。Claudeに読み取り専用ツールを呼び出させ、接続を確認します。
トラブルシューティング
-
サインインが失敗します： 手動設定の場合、クライアント ID、
/oidc発行者、およびai-gateway範囲を確認してください。登録されたリダイレクト URL は、コネクタのホストおよびポートと一致している必要があります：モデルおよび MCP の場合は53180、このガイドのスキルの場合は53280。OAuth アプリケーションの変更が有効になるまで最大 30 分かかる場合があります。 -
モデルが見つかりません: モデルの権限を確認し、
ug configure --agents claudeを再実行してデスクトップモデルリストを更新してください。手動セットアップの場合は、 [接続] > [モデル] > [モデルリスト] の下にモデルの完全なUnity Catalog名を追加します。明示的なリストは自動検出を置き換えるため、使用するモデルを含めてください。変更を適用し、再起動します。 -
MCPまたはスキルコネクタが失敗する: URLと権限を確認します。手動セットアップの場合、 認可サーバー フィールドには上記で示したJSON配列を含める必要があります。 サインイン & テスト を選択して、エラーを調査します。
-
ワークスペースのサインインは機能しますが、ツールがサインインを求めてきます： MCP が返したログインLinkを開き、外部プロバイダーにサインインしてから、呼び出しを再試行してください。ワークスペースとプロバイダーのサインインは別々のステップです。