Aller au contenu principal

Connecter ChatGPT pour ordinateur de bureau

Utilisez l’agent Codex dans ChatGPT desktop avec des modèles, des outils MCP et des compétences via Unity Gateway. Les abonnements ChatGPT ne sont pas pris en charge via Unity Gateway.

Prérequis​

Vous avez besoin de votre URL de workspace Databricks, d'un accès aux modèles et aux outils que vous souhaitez utiliser, ainsi que de la dernière version de ChatGPT desktop.

Si votre administrateur a déjà configuré votre appareil, suivez les instructions de lancement de votre organisation.

Se connecter avec Unity Gateway CLI (recommandé)​

Installez ug, puis exécutez cette commande dans un terminal interactif :

Bash
ug configure --agents codex

Sélectionnez votre workspace et connectez-vous. Cette commande configure à la fois le Codex CLI et l'agent de travail ChatGPT desktop installé pour le même workspace. Si vous y êtes invité, approuvez la mise à jour de la configuration système avec le mot de passe de votre appareil. ug configure la connexion à Unity Gateway et le refresh du jeton OAuth.

Sur Windows, exécutez la commande à partir d’un terminal élevé. ChatGPT desktop sur Windows requiert Codex 0.156.0 ou une version ultérieure pour appliquer la configuration.

Ouvrez ou redémarrez le bureau ChatGPT, puis start une conversation Codex. Utilisez le sélecteur de modèle pour changer de modèle.

Ajouter des outils et compétences MCP​

Utilisez ug pour ajouter les serveurs MCP et les compétences disponibles dans votre workspace :

Bash
ug mcp add --agents codex
ug skills add

Ouvrez ou redémarrez ChatGPT desktop après la configuration. Saisissez /mcp pour vérifier les connexions MCP. Les compétences sont disponibles à partir de ~/.agents/skills/.

Pour la configuration manuelle du modèle, du MCP et des compétences, voir Connecter Codex. Ces paramètres s’appliquent aussi bien à la CLI de Codex qu’à ChatGPT desktop.

Limitations​

Cette configuration paramètre aussi bien la CLI de Codex que ChatGPT pour ordinateur de bureau. La configuration s’applique à toutes les conversations dans les deux cas, et leurs inférences passent par Unity Gateway.

ChatGPT desktop prend en charge les modèles ouverts via Unity Gateway. Smart Routing n’est pas pris en charge dans ChatGPT desktop.

Dépannage​

  • ChatGPT desktop demande une connexion à OpenAI : relancez ug configure --agents codex de façon interactive et terminez la mise à jour de la configuration du système. Sur Windows, exécutez-la à partir d'un terminal élevé. Le profil CLI ne configure pas ChatGPT desktop. Pour une configuration manuelle, vérifiez que model_provider est au niveau supérieur et que requires_openai_auth = false est dans la table du fournisseur. N’ajoutez pas cet indicateur à un fournisseur qui utilise une table auth pour le refresh du jeton OAuth.

  • Il manque un modèle : Vérifiez les autorisations de vos modèles. Définissez model sur son nom complet dans Unity Catalog dans la configuration active et start une nouvelle conversation.

  • Une connexion MCP ou de compétence échoue : vérifiez l’URL, les autorisations et l’erreur du connecteur. Pour les connexions manuelles, vérifiez également l’expiration du jeton. Pour les problèmes de configuration de ug, exécutez ug doctor.

  • La connexion au Workspace fonctionne, mais un outil vous demande de vous connecter : ouvrez le link de connexion renvoyé par le MCP, connectez-vous au fournisseur externe, puis réessayez l’appel. La connexion au Workspace et au fournisseur sont des étapes distinctes.

Étapes suivantes​