Ajouter des outils et des compétences
Utilisez le CLI Unity Gateway (ug) pour ajouter des serveurs MCP et des compétences partagées à votre agent de codage. Les outils MCP fournissent un accès aux données et aux services ; les compétences fournissent des instructions pour les tâches et les workflows de votre équipe.
Pour une configuration manuelle, consultez le guide de votre agent de codage sous Agents de codage pris en charge.
Prérequis
Installer et configurer ug. Vous devez avoir accès aux serveurs MCP ou aux compétences que vous souhaitez utiliser, y compris à l’ensemble des données et services sous-jacents.
You need an installed, configured MCP-capable agent, including for skill downloads. MCP connections apply to all your configured agents that support MCP.
Pour les compétences, votre administrateur doit activer la fonctionnalité bêta. Consultez Gérer les compétences.
Après avoir modifié votre configuration, redémarrez votre agent avec sa commande ug habituelle.
Ajouter des outils MCP
Pour utiliser system.ai.dbsql, system.ai.sandbox ou system.ai.web_search, un administrateur de compte doit activer la version bêta de Unity Gateway depuis la page Previews de la console du compte. Consultez Gérer les aperçus du compte.
Choisir les serveurs MCP
ug mcp add
Connectez-vous si vous y êtes invité, puis choisissez des serveurs dans le sélecteur. Tapez pour filtrer, appuyez sur Space pour sélectionner, et sur Enter pour confirmer.
Les connexions existantes sont conservées. Dans votre agent, demandez-lui d’utiliser un outil en décrivant la tâche.
Choisir les serveurs MCP par nom
Pour ajouter des serveurs MCP par leur nom, utilisez leurs noms Unity Catalog complets (<catalog>.<schema>.<server-name>) :
ug mcp add --names system.ai.github,system.ai.slack
Pour ajouter tous les serveurs MCP d'un schéma :
ug mcp add --location "<catalog>.<schema>"
Ajouter d'autres serveurs MCP Databricks
Pour les ressources en dehors du sélecteur de serveur MCP, utilisez un sélecteur avec --names:
Ressource | Sélecteur |
|---|---|
Index de recherche IA dans un schéma (hérité) |
|
Fonctions Unity Catalog dans un schéma (hérité) |
|
Genie Agent (hérité) |
|
Serveur MCP hébergé dans une application Databricks |
|
L'IA Search, les fonctions Unity Catalog et les sélecteurs Genie Agent se connectent aux Endpoint MCP de Workspace hérités. Pour les nouvelles intégrations, consultez les approches recommandées.
Par exemple, connectez un Genie Agent existant :
ug mcp add --names "genie-space:<space-id>"
Remplacez <space-id> par l’ID de Genie space.
Vérifier et supprimer les connexions
Répertorier les serveurs MCP configurés par ug:
ug mcp list
Pour supprimer les connexions que vous avez ajoutées :
ug mcp remove
Sélectionnez les serveurs à supprimer et appuyez sur Enter . Chaque connexion sélectionnée est supprimée de tous les agents où vous l’avez ajoutée. Le serveur MCP lui-même reste disponible dans le workspace.
Autres clients MCP
Pour system.ai.dbsql, activez d'abord la version bêta de Unity Gateway.
Pour Claude Code, Codex ou Cursor, consultez le guide de l'agent. Pour Claude sur le Web ou sur le bureau, suivez les connecteurs Claude.
Pour les clients ci-dessous, choisissez un MCP sous Unity Gateway > MCPs et utilisez cette URL :
https://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service>
Replace the hostname and MCP name. For example, use system.ai.genie_one_mcp for Genie One or system.ai.dbsql for Databricks SQL. You need MCP permissions and provider sign-in.
- ChatGPT
- Windsurf
- Replit
- Activez le Mode développeur dans ChatGPT. La disponibilité dépend de votre compte et de la politique Workspace.
- Suivez les instructions ChatGPT liées pour ajouter une connexion MCP avec votre URL MCP et choisissez OAuth .
- Copiez l'URL de redirection OAuth exacte affichée par ChatGPT. Demandez à un administrateur de compte de créer un client OAuth Databricks avec cette URL et le champ d'application
ai-gateway. Consultez URL de redirection OAuth de ChatGPT pour obtenir des détails sur les rappels. - Saisissez l’ID et le secret du client, le cas échéant, dans ChatGPT. Enregistrez la connexion et terminez la connexion.
- Sélectionnez la connexion MCP dans une conversation et demandez-lui d’utiliser un outil en lecture seule.
Si les listes d’accès IP sont activées, autorisez les adresses IP sortantes de ChatGPT.
Utilisez la configuration OAuth manuelle pour Cursor et enregistrez le JSON dans ~/.codeium/windsurf/mcp_config.json. Cette option utilise mcp-remote avec votre ID client OAuth enregistré.
Redémarrez Windsurf, terminez la connexion dans le navigateur et demandez à l'agent d'appeler un outil en lecture seule. Consultez la configuration MCP de Windsurf.
Pour les tests locaux avec un jeton d’accès personnel:
- Dans votre workspace Replit, cliquez sur Add MCP Server et saisissez l'URL du MCP.
- Ajoutez l’en-tête personnalisé
Authorizationavec la valeurBearer <databricks-pat>. - Enregistrez et demandez à l’agent d’appeler un outil en lecture seule.
Gardez le jeton hors du contrôle de code source. Pour connaître les options d'authentification actuelles, consultez la documentation Replit MCP.
Confirmez que le client effectue un appel d'outil et renvoie son résultat. Pour system.ai.dbsql, essayez SELECT 1 AS result. Si la connexion échoue, consultez l’authentification et la mise en réseau MCP.
Ajouter des compétences
Vous pouvez utiliser des compétences de deux manières :
- download skills: Votre agent découvre et utilise des fichiers de compétences locaux via son flux de travail de compétences natif.
- Utilisez des compétences via MCP : votre agent récupère les instructions à partir du registre de compétences publié lorsqu’il utilise une compétence, sans aucun fichier local à gérer.
Download les compétences
ug skills add
Sélectionnez les compétences à download dans le sélecteur.
ug télécharge chaque dossier de compétence complet, y compris SKILL.md et les fichiers de support, dans ~/.claude/skills/ et ~/.agents/skills/. Demandez à votre agent d’utiliser la compétence par son nom. Consultez le guide de l’agent pour connaître ses commandes de compétences.
Pour download des compétences spécifiques, utilisez leurs noms complets Unity Catalog :
ug skills add --names "<catalog>.<schema>.<skill-name>"
Pour download toutes les compétences d'un schéma :
ug skills add --location "<catalog>.<schema>"
Les deux options acceptent des noms séparés par des virgules. Utilisez --names ou --location dans une commande, mais pas les deux. Réexécutez la même commande pour récupérer les mises à jour ; ug invite à confirmer avant d’écraser les dossiers de compétences existants.
download permet également d'activer les outils de découverte et de chargement du registre de compétences, sans modifier les schémas déjà connectés via MCP.
download skills into a project
Depuis le répertoire de votre projet, exécutez :
ug skills add --path "$PWD"
Choisissez vos compétences. ug les écrit dans les répertoires .claude/skills/ et .agents/skills/ du projet. Vous pouvez également combiner --path avec --names ou --location.
--path doit pointer vers un répertoire de projet absolu et existant. Utilisez les téléchargements de projet avec ug gemini, qui utilise un répertoire d’accueil distinct pour les paramètres de l’agent.
Connectez-vous aux compétences publiées via MCP
Pour choisir les schémas dont les compétences peuvent être utilisées par votre agent via MCP :
ug skills add --via mcp
Sélectionnez les schémas dans le sélecteur. Pour spécifier un schéma directement :
ug skills add --location "<catalog>.<schema>" --via mcp
ug ajoute ces schémas à la connexion du registre de compétences, en conservant ceux qui sont déjà connectés. Vous ne pouvez pas combiner --via mcp avec --path ou --names.
Dans votre agent, demandez-lui d'utiliser une compétence publiée :
Use <catalog>.<schema>.<skill-name> to review this query.
Vous pouvez également demander à l’agent de lister les compétences dans un schéma. Les compétences chargées via MCP peuvent ne pas apparaître dans le menu des compétences natives de l’agent.
List skills
ug skills list
Supprimer les compétences
Pour sélectionner les compétences téléchargées à supprimer :
ug skills remove
To remove a particular skill from your current project:
ug skills remove --names "<catalog>.<schema>.<skill-name>" --path "$PWD"
Utilisez --location "<catalog>.<schema>" au lieu de --names pour supprimer tous les téléchargements d’un schéma. Sans --path, la suppression inclut les copies téléchargées par ug dans vos répertoires utilisateur et de projet. Les compétences publiées restent dans Unity Catalog.
Pour supprimer un schéma de la connexion MCP en direct :
ug skills remove --location "<catalog>.<schema>" --via mcp
Omettez --location pour choisir des schémas dans un sélecteur. La suppression d’un schéma laisse les fichiers téléchargés et les outils de découverte du registre en place.