Aller au contenu principal
Dernière mise à jour le

Serveurs MCP externes

Register a self-hosted or third-party MCP server so your team can use it through Unity Gateway. Create its connection as part of registration.

Pour un serveur que Databricks fournit déjà, choisissez un MCP fourni par Databricks. Pour une configuration automatique, consultez la référence de l’API et du SDK.

Avant de commencer​

Vous avez besoin de :

  • Un workspace compatible avec Unity Catalog et le droit d'accès Workspace access . Les utilisateurs disposant de l'accès Consumer access ne peuvent pas enregistrer de MCP.
  • Un serveur MCP qui prend en charge Streamable HTTP, son URL et ses détails d’authentification.
  • USE CATALOG et USE SCHEMA sur le catalogue et le schéma parents, ainsi que CREATE SERVICE sur le schéma.
  • CREATE CONNECTION sur le schéma pour créer une connexion, ou USE CONNECTION sur une connexion existante.
  • Accès réseau du Workspace vers le serveur. Consultez l’authentification et la mise en réseau MCP.

The workspace must be in a region that supports Model Serving.

Étape 1 : enregistrez le serveur​

  1. Dans votre workspace, ouvrez Unity Gateway , sélectionnez MCPs , puis cliquez sur + MCP .

  2. Choisissez Connect an existing MCP server .

  3. Choisissez un catalogue et un schéma, et saisissez un nom MCP. Le nom ne peut pas être changé après la création.

  4. Sélectionnez une connexion HTTP existante ou cliquez sur : Create new connection

    • Saisissez l'URL du serveur MCP.
    • Choisissez la méthode d’authentification et saisissez les identifiants du fournisseur. Pour les fournisseurs pris en charge, utilisez l’ OAuth géré.
    • Si vous utilisez OAuth avec votre propre application OAuth, ajoutez https://<workspace-hostname>/login/oauth/http.html aux URL de redirection autorisées de l'application. Certains fournisseurs rejettent la connexion sans cette option. Pour les champs de chaque méthode d'authentification, consultez Créer une connexion au service externe.
    • Cliquez sur Créer & charger les outils pour enregistrer la connexion et découvrir ses outils.

  5. Sous Tools , cliquez sur Login si vous y êtes invité, puis connectez-vous au fournisseur. Choisissez ensuite les outils à exposer. Consultez Sélection d’outils pour connaître les options de filtrage.

  6. Cliquez sur Create MCP Service .

Use a schema-level connection for new MCPs. If you already have a metastore-level connection, click Use a metastore-level connection to select it. For a server from marketplace, follow Install an MCP server.

Étape 2 : Tester un outil​

Tester avec AI Playground :

  1. Ouvrir AI Playground et choisir un modèle avec les outils activés .
  2. Ouvrez Outils , cliquez sur + Ajouter un outil , puis sélectionnez Serveurs MCP .
  3. Sélectionnez Serveurs MCP externes , puis votre MCP.
  4. Demandez au modèle d’utiliser un outil en lecture seule. Confirmez qu’il effectue un appel d’outil et renvoie le résultat attendu.

Pour les tests en ligne de commande, utilisez les exemples sous Get start sur la page de détails du MCP. Si un appel échoue, consultez l'authentification et la mise en réseau du MCP.

Étape 3 : Connectez votre agent​

Utilisez le nom complet du MCP, <catalog>.<schema>.<service>, dans la configuration de votre agent :

Les clients qui requièrent une URL de serveur utilisent :

Text
https://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service>

Limitations​

  • Vous pouvez enregistrer des serveurs MCP externes. L'enregistrement de sources d'entités Genie, Databricks Apps ou Unity Catalog en tant que votre propre MCP n'est pas pris en charge. Utilisez un MCP fourni par Databricks ou connectez-vous directement à votre serveur sur Databricks Apps.
  • Les commandes SQL telles que CREATE MCP SERVICE ne sont pas prises en charge.
  • La recherche globale Unity Catalog ne renvoie pas de MCP. Retrouvez-les sur la page MCPs .

Étapes suivantes​

Sur cette page