Connect Claude desktop

Utilisez Claude Desktop dans Code ou Cowork avec des modèles, des outils MCP et des compétences via Unity Gateway. Claude desktop prend également en charge la retransmission via l’abonnement Anthropic.

Prerequisites

Vous avez besoin de l’URL de votre espace de travail Azure Databricks, de l’accès aux modèles et outils que vous souhaitez utiliser, ainsi que de la dernière version de Claude Desktop.

Sous Windows, ouvrez Claude Desktop au moins une fois avant d’exécuter ug configure pour que l’application initialise ses données locales.

Si vous prévoyez d’utiliser un relais d’abonnement Anthropic, installez le Claude Code CLI.

Se connecter à l’aide de Unity Gateway CLI (recommandé)

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

ug configure --agents claude

Sélectionnez votre espace de travail et connectez-vous. Cette commande configure à la fois Claude Code et l’agent de travail Claude desktop installé pour le même espace de travail. ug crée et sélectionne un profil de bureau Claude avec les modèles, serveurs MCP, compétences et paramètres de rafraîchissement des identifiants disponibles via votre espace de travail.

Ouvrez ou redémarrez Claude Desktop, puis lancez une conversation dans Code ou Cowork. Utilisez le sélecteur de modèles pour changer de modèle.

Déployer avec MDM

Pour déployer Claude Desktop dans toute votre organisation avec la gestion des appareils mobiles (MDM), consultez le guide de déploiement MDM d'Anthropic.

Fonctionnalités et limitations prises en charge

Cette configuration utilise le mode d’inférence de fournisseur tiers de Claude Desktop.

Configuration manuelle

Utilisez cette configuration uniquement si vous ne pouvez pas utiliser ug. Il nécessite un identifiant client OAuth et un profil de bureau Claude configuré manuellement.

1. Obtenir un ID client OAuth

Utilisez l’identifiant client Claude par défaut, https://claude.ai/oauth/mcp-oauth-client-metadata. Un administrateur de compte n’a pas besoin de créer une application OAuth. Voir les identifiants clients OAuth par défaut.

2. Connectez-vous à la passerelle Unity

Depuis l’écran de connexion de Claude Desktop, sélectionnez Aide > Dépannage > Activer le mode développeur, puis Développeur > Configurer l’inférence tierce.

Sur la page Connexion , sélectionnez Passerelle et entrez :

Remplacez-le <workspace-hostname> par votre nom d’hôte Azure Databricks workspace. Laissez les autres réglages dans leurs paramètres par défaut. Voir la configuration de la passerelle d'Anthropic pour plus de détails sur les champs.

Sélectionnez Test connection et connectez-vous à Azure Databricks. Sélectionnez Appliquer des modifications, puis Sauvegarder et Redémarrer. Sur l’écran de connexion, choisissez la configuration tierce et lancez une conversation dans Code ou Cowork.

3. Ajouter des outils et compétences MCP

Développeurs > ouverts : configurez les connecteurs d’inférence > tiers. Sous Serveurs MCP gérés, ajoutez une entrée pour chaque MCP ou registre de compétences que vous souhaitez utiliser.

Utilisez ces réglages pour les deux types de connecteurs :

Pour un MCP, trouvez son nom en trois parties sous Unity Gateway > MCPs dans votre espace de travail. Attribuez un nom descriptif au connecteur, définissez le port Callback à 53180, et utilisez cette URL :

https://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service-name>?o=<workspace-id>

Pour les skills, nommer le connecteur databricks-skill-registry, définir Callback port sur 53280, et utiliser :

https://<workspace-hostname>/ai-gateway/skills/?schema=<catalog>.<schema>

Conservez la barre oblique finale avant ?schema. Pour inclure plusieurs schémas, répétez le paramètre : ?schema=main.default&schema=ml.prod. Ces compétences sont exposées à Claude comme outils via le connecteur.

Pour chaque connecteur, sélectionnez Se connecter et tester et terminez la procédure de connexion. Sélectionnez Appliquer des modifications, puis Sauvegarder et Redémarrer. Demandez à Claude d’utiliser un outil connecté ou une compétence en utilisant son nom complet. Voir Ajouter des outils et compétences pour les besoins d’accès et plus d’options.

Connectez les outils MCP à votre compte Claude

Pour system.ai.dbsql, activez d’abord la bêta de Unity Gateway.

Utilisez un connecteur personnalisé pour ajouter les outils MCP d’Azure Databricks à Claude sur le web ou sur ordinateur via votre compte Claude.

1. Dans Claude, ouvrez les Paramètres > Connecteurs > Ajouter un connecteur personnalisé.

2. Saisissez l’URL MCP :

   https://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service>?o=<workspace-id>
   

3. Pour l’identifiant client OAuth, entrez l’identifiant client Claude par défaut, https://claude.ai/oauth/mcp-oauth-client-metadata. Sélectionnez Ajouter et terminez la connexion.

4. Lors d’une conversation, activez le connecteur et demandez à Claude d’appeler l’un de ses outils. Pour system.ai.dbsql, essaie SELECT 1 AS result.

Si votre espace de travail limite les IP entrantes, autorisez les IP sortantes de Claude. Consultez l’authentification MCP pour les permissions, la connexion fournisseur et le dépannage.

{
  "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>"
      ]
    }
  }
}

Troubleshooting

• Échecs de connexion : Pour une configuration manuelle, vérifiez l’identifiant client, /oidc l’émetteur et ai-gateway le périmètre. L’URL de redirection enregistrée doit correspondre à l’hôte et au port du connecteur : 53180 pour les modèles et MCP, ou 53280 pour les compétences de ce guide. Les modifications d’application OAuth peuvent prendre jusqu’à 30 minutes pour prendre effet.

• Il manque un modèle : Vérifiez les autorisations de vos modèles et relancez ug configure --agents claude pour actualiser la liste des modèles de bureau. Pour une configuration manuelle, ajoutez le nom complet du catalogue Unity du modèle sous Connexion > Modèles > Liste des modèles. Une liste explicite remplace la découverte automatique, donc incluez les modèles que vous souhaitez utiliser. Appliquez les changements et recommencez.

• Un MCP ou un connecteur de compétence échoue : Vérifiez son URL et ses permissions. Pour une configuration manuelle, le champ serveur d’autorisation doit contenir le tableau JSON montré ci-dessus. Sélectionnez Se connecter et tester pour inspecter l’erreur.

• La connexion Workspace fonctionne, mais un outil vous demande de vous connecter : Ouvrez le lien de connexion envoyé par le MCP, connectez-vous au fournisseur externe, puis réessayez l’appel. La connexion à l’espace de travail et la connexion au fournisseur sont des étapes distinctes.

Étapes suivantes

• Connectez Claude Code
• Ajouter des outils et des compétences
• Référence CLI ug