ChatGPT デスクトップに接続する
Unity Gatewayを介してモデル、MCPツール、スキルを使用するChatGPTデスクトップのCodexエージェントを使用します。ChatGPTサブスクリプションは、Unity Gatewayを介してサポートされていません。
前提条件
Databricks ワークスペースのURL、使用するモデルとツールへのアクセス権、および ChatGPT デスクトップ の最新バージョンが必要です。
管理者がすでにデバイスを構成している場合は、組織の起動手順に従ってください。
UnityゲートウェイCLIで接続する（推奨）
ug をインストールし、対話型ターミナルで次のコマンドを実行します。
ug configure --agents codex
ワークスペースを選択し、サインインします。このコマンドは、同じワークスペースに対してCodex CLIとインストール済みのChatGPTデスクトップワークエージェントの両方を設定します。プロンプトが表示されたら、デバイスのパスワードを使用してシステム構成のアップデートを承認してください。ugは、Unity Gateway接続とOAuthトークンの更新を設定します。
Windowsでは、管理者権限でターミナルを開き、そこからコマンドをランしてください。Windows上のChatGPTデスクトップで設定を適用するには、Codex 0.156.0以降が必要です。
ChatGPTデスクトップを開くか再起動し、Codexの会話を開始します。モデルピッカーを使用して、モデルを変更します。
MCP Tools と Skills の追加
ugを使用して、ワークスペースで利用可能なMCPサーバーとスキルを追加します：
ug mcp add --agents codex
ug skills add
設定後にChatGPTデスクトップを開くか、再起動します。MCP接続を確認するには、/mcpと入力します。スキルは~/.agents/skills/から利用可能です。
手動モデル、MCP、スキルの設定については、Codexを接続するを参照してください。これらの設定は、Codex CLIとChatGPTデスクトップの両方に適用されます。
制限
このセットアップにより、Codex CLIとChatGPTデスクトップの両方が構成されます。構成は両方のすべての会話に適用され、その推論は Unity Gateway を経由します。
ChatGPTデスクトップは、Unity Gatewayを介したオープンモデルをサポートしています。スマートルーティングはChatGPTデスクトップではサポートされていません。
トラブルシューティング
-
ChatGPTデスクトップでOpenAIのサインインが求められた場合：
ug configure --agents codexを対話的に再実行し、システム構成の更新を完了してください。Windowsでは、管理者として実行しているターミナルからランしてください。CLIプロファイルだけでは、ChatGPTデスクトップは構成されません。手動でセットアップする場合、model_providerがトップレベルにあること、およびrequires_openai_auth = falseがプロバイダー テーブル内にあることを確認してください。OAuthトークンの更新にauthテーブルを使用するプロバイダーにそのフラグを追加しないでください。 -
モデルがありません: モデルの権限を確認してください。有効な構成で
modelを完全な Unity Catalog 名に設定し、新しい会話を起動します。 -
MCP またはスキル接続が失敗する： URL、権限、およびコネクタのエラーを確認してください。手動接続の場合は、トークンの有効期限も確認してください。
ugのセットアップに問題がある場合は、ug doctorをランしてください。 -
ワークスペースのサインインは機能しますが、ツールからログインを求められる場合: MCP によって返されたログイン Link を開き、外部プロバイダーにサインインしてから、呼び出しを再試行してください。ワークスペースとプロバイダーのサインインは別々のステップです。