Claude Codeの接続

Unity Gatewayを通じて、モデル、MCPツール、スキルとともにClaude Codeを使用します。Unity Gateway CLI (ug) を使用してアクセスを設定するか、接続を手動で設定します。

既存のClaude Codeセットアップにツールを接続するには、MCPツールの追加に移動します。

前提条件

Databricks ワークスペースのURL、使用するモデルへのアクセス権、および最新の Claude Code が必要です。

管理者がすでにデバイスを構成している場合は、組織のサインインおよび起動手順に従ってください。

Unity Gateway CLIの使用（推奨）

ug をインストールし、プロジェクトディレクトリから次のコマンドを実行します：

Bash
ug claude

プロンプトに従ってワークスペースを選択し、サインインします。ugによって接続が構成され、ターミナルで Claude Code が起動します。すでに使用している同じプロンプトとコマンドを使用して作業を起動します。モデルを変更するには、/modelを入力します。

MCPツールの追加に進み、データとサービスを接続します。共有スキルをdownloadするには、ug skills addをランして、必要なスキルを選択します。その他のオプションについては、ツールとスキルの追加を参照してください。

Claude Codeを手動で構成する

Merge the following settings into ~/.claude/settings.json:

JSON
{
  "env": {
    "ANTHROPIC_MODEL": "<model-api-name>",
    "ANTHROPIC_BASE_URL": "https://<workspace-hostname>/ai-gateway/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "<databricks-personal-access-token>",
    "ANTHROPIC_CUSTOM_HEADERS": "x-databricks-use-coding-agent-mode: true",
    "CLAUDE_CODE_USE_GATEWAY": "1",
    "ENABLE_PROMPT_CACHING_1H": "1",
    "ENABLE_TOOL_SEARCH": "true"
  }
}

<workspace-hostname> を、https:// を除いたワークスペースのホスト名に置き換えます。アクセスできる Claude モデル API の完全な Unity Catalog 名に <model-api-name> を設定し、Databricks 個人用アクセストークンを指定します。

プロジェクトディレクトリから claude をランします。その他の設定については、Claude Code の設定を参照してください。

自動モード

自動モードでは、安全性分類器を使って提案されたツール呼び出しをチェックすることで、通常の権限確認プロンプトを減らします。

Unity Gatewayを使用したAnthropicモデルは、Anthropicネイティブのオートモードチェックを使用します。Databricksによってホストされ、関数呼び出しをサポートする非Anthropic基盤モデルの場合、Unity Gatewayが分類子を提供します。維持されているモデルリストおよびモデルごとの機能については、Databricksで使用可能なモデルを参照してください。

Claude Codeは、分類器を照会する前に明示的なpermissions.denyルールとコンテンツスコープのpermissions.askルールを評価します。一致する拒否ルールはアクションをブロックし、一致する要求ルールには権限プロンプトが必要です。自動モードでは、会話や分類ルールに基づいてアクションをブロックしたり、チェックで有効な判定が出せない場合にもブロックしたりできます。

ug で接続を設定したら、オートモードで Claude Code を起動します。

Bash
ug claude -- --permission-mode auto

手動接続の場合、claude --permission-mode autoを実行します。ugの引数転送については、ug CLIリファレンスを参照してください。

信頼されたインフラストラクチャの構成

autoMode.environment で組織の信頼できるリポジトリ、ドメイン、およびサービスを記述します。これらのエントリは、分類子がインフラストラクチャへの予期されるアクセスとブロックすべきアクションを区別するのに役立ちます。~/.claude/settings.json で autoMode ブロックをユーザー設定に Merge します。例：

JSON
{
  "autoMode": {
    "environment": [
      "$defaults",
      "Source control: github.example.com/example-org and its repositories",
      "Trusted internal services: builds.internal.example.com"
    ]
  }
}

例のエントリを組織のインフラストラクチャに置き換えます。エントリは自然言語の説明です。独自のエントリを追加する場合、組み込み環境のエントリを保持するために"$defaults"を保持してください。

分類子は、ユーザー設定、管理された設定、またはインラインの--settings設定からautoModeを読み取ります。プロジェクトの.claude/settings.jsonまたは.claude/settings.local.jsonからこのブロックを読み取ることはありません。管理者は、管理された設定を通じて共有設定を配布できます。

ルールのカスタマイズ、管理対象の設定、ブロックされたアクションの確認については、自動モードを構成するをご覧ください。

分類子の使用状況を追跡する

Unity Gateway のチェックは、提案されたツール引数と会話コンテキストを別の分類子モデルに送信します。分類子のリクエストには追加のモデル料金がかかる可能性があり、レイテンシが増加する可能性があります。

system.ai_gateway.usageでは、invocation_metadata.sourceがSAFEGUARD_CLASSIFIERに設定された分類器のリクエストが表示されます。この値を使用すると、安全性チェックのリクエストとそのトークン使用量およびレイテンシを、コーディングモデルのリクエストと区別できます。アクセス要件と使用状況テーブルのスキーマについては、使用状況の追跡をご覧ください。

MCPツールの追加

system.ai.dbsql、system.ai.sandbox、または system.ai.web_search を使用するには、アカウント管理者がアカウントコンソールの Previews ページから Unity Gateway ベータ版を有効にする必要があります。アカウントプレビューの管理を参照してください。

ワークスペースで Unity Gateway > MCPs を開いてください。組み込み MCPまたは外部 MCP サーバーを登録するを選択してください。
system.ai.githubや<catalog>.<schema>.<service>など、MCPのフルネームをコピーします。
MCP へのアクセス権があることを確認します。
ugをインストールした後、MCPをClaude Codeに追加します：
Bash
```
ug mcp add --agents claude --names <catalog>.<schema>.<service>
```
コピーした名前でプレースホルダーを置き換えます。たとえば、GitHubには--names system.ai.githubを使用します。サービスを対話形式で選択するには、--namesを省略します。

初回セットアップ時は、プロンプトに従ってワークスペースを選択し、サインインして、モデルを選択します。ugはモデルとMCPへのアクセスを設定し、認証情報を更新します。ug claudeを使用してClaude Codeを再起動し、その後ツールをテストします。

MCPツールを手動で追加

以下のdefault Claude CodeクライアントIDを使用するか、独自のOAuthアプリを構成してください。defaultクライアントIDを使用してMCPを追加するには、次を実行します：

Bash
claude mcp add --transport http --scope user \
  --client-id https://claude.ai/oauth/claude-code-client-metadata --callback-port 3118 \
  databricks-tools \
  "https://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service-name>?o=<workspace-id>"

ホスト名、ワークスペースID、MCP名を置き換えます。Claude Codeを開き、/mcpを入力して、Databricksアカウントでサーバーにサインインします。追加する各MCPに対して異なるサーバー名で繰り返してから、ツールをテストします。

独自の OAuth アプリを使用する

アカウント管理者に依頼して、アカウントコンソールで Settings > App connections > Add connection を開いてもらいます。
claude-code-mcp などの名前を入力し、パブリッククライアントの場合は Generate a client secret の選択を解除し、リダイレクト URL を http://localhost:8080/callback に設定して、ai-gateway スコープを選択します。 Client ID を保存してコピーします。Create an OAuth app を参照してください。

そのクライアント ID と一致するコールバックポートを使用して MCP を登録します:

Bash
claude mcp add --transport http --scope user \
  --client-id <client-id> --callback-port 8080 \
  databricks-tools \
  "https://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service>?o=<workspace-id>"

Claude Codeを開き、/mcpを入力してサインインします。組織で機密クライアントが必要な場合は、コマンドに--client-secretを追加し、プロンプトが表示されたらシークレットを入力します。

MCP ツールのテスト

Claude Codeで、/mcpを入力し、サーバーが接続されていることを確認します。
Claudeにそのサーバーのツールを一覧表示するよう依頼し、読み取り操作をリクエストします。GitHubについては、アクセスできるリポジトリ内の問題を見つけるように依頼してください。カスタムサーバーの場合は、登録時にテストしたツールと入力を使用します。
ツール呼び出しによってサインインを求められた場合は、MCP が返したログインLinkを開き、プロバイダーの同意を完了してから、呼び出しを再試行してください。
Check that Claude makes a tool call and returns its result.A text answer alone doesn't verify the connection.

Databricks のデータを使用するには、ビジネス上の質問には system.ai.genie_one_mcp を接続し、SQL には system.ai.dbsql を接続します。たとえば、SQL MCP に SELECT 1 AS result をランするように依頼します。

権限、ポリシー、および使用量については、MCP の管理をご覧ください。

スキルを手動で接続する

公開された Unity Gateway スキルをツールとして公開するには、スキルレジストリを HTTP MCP サーバーとして登録します。

Bash
claude mcp add --transport http --scope user \
  --header "Authorization: Bearer <databricks-personal-access-token>" \
  databricks-skill-registry \
  "https://<workspace-hostname>/ai-gateway/skills/?schema=<catalog>.<schema>"

プレースホルダーをワークスペース、トークン、スキルスキーマに置き換えます。?schema の前にある末尾のスラッシュを保持します。複数のスキーマを含めるには、パラメーターを繰り返します: ?schema=main.default&schema=ml.prod。

Claude Codeを再起動し、/mcpで接続を確認します。ClaudeにUse <catalog>.<schema>.<skill-name> to review this query.などのフルネームでスキルを使用するよう依頼します。この接続ではスキルがMCPツールとして公開されます。一方、ug skills addはネイティブ検出のためにスキルをdownloadします。

トラブルシューティング

Claude Codeが接続されない： ugを使用している場合は、ug doctorを実行します。手動でセットアップするには、ワークスペースのホスト名、トークン、モデル名、およびモデルの権限を確認します。
Claude Code OAuthでリダイレクトの不一致が報告される場合や、接続がタイムアウトする場合： カスタムOAuthアプリの場合は、リダイレクトURLをコールバックホストおよびポートに一致させ、ネットワークアクセスを確認してください。OAuthアプリの変更が有効になるまでに、最大30分かかる場合があります。

前提条件​

Unity Gateway CLIの使用（推奨）​

Claude Codeを手動で構成する​

自動モード​

信頼されたインフラストラクチャの構成​

分類子の使用状況を追跡する​

MCPツールの追加​

MCPツールを手動で追加​

MCP ツールのテスト​

スキルを手動で接続する​

トラブルシューティング​

次のステップ​