Aller au contenu principal
Dernière mise à jour le

Connectez les MCP aux assistants d'IA et aux agents de codage

remarque

Les MCP Databricks auxquels vous pouvez vous connecter se trouvent à différentes phases de publication. Consultez les serveurs MCP gérés, les services MCP et les serveurs MCP hébergés par Databricks pour l’état actuel de chaque fonctionnalité.

Connectez les clients, les assistants IA et les IDEs qui prennent en charge le Model Context Protocol (MCP) aux MCPs Databricks. Cela donne accès aux données et outils Databricks directement dans votre environnement de développement.

En connectant les clients aux MCP Databricks, vous pouvez :

  • Accédez aux fonctions, aux tables et aux index vectoriels de Unity Catalog depuis votre IDE ou assistant IA
  • Interrogez les données Databricks directement depuis Claude, Claude Code, Cursor, Replit, ou d'autres outils compatibles MCP

Comment cela fonctionne​

Chaque client se connecte aux MCP Databricks de la même manière : ajoutez l'URL du serveur à la configuration MCP du client, authentifiez-vous avec OAuth ou un jeton d'accès personnel, et le client appelle les outils via HTTP Streamable. L'URL détermine le MCP que vous atteignez : un serveur MCP géré pour les données et outils Unity Catalog, un service MCP pour les outils externes, ou votre propre serveur MCP hébergé par Databricks:

Un client MCP, tel que Claude, Claude Code, Cursor ou ChatGPT, est configuré avec une URL de serveur MCP Databricks, s'authentifie avec OAuth ou un jeton d'accès personnel, et appelle des outils via HTTP en continu sur l'un des trois types d'Endpoint : des données et du code Databricks via des serveurs MCP gérés ; des outils tiers comme GitHub et Slack via les services MCP ; ou votre propre serveur MCP hébergé sur Databricks Apps.

Prérequis​

  • Server URLs : Obtenez les URL de serveur appropriées pour le serveur MCP Databricks que vous souhaitez utiliser :

  • Accès aux ressources : vérifiez que vous avez accès aux serveurs MCP que vous souhaitez utiliser et à toutes les Ressources sous-jacentes. Par exemple, si vous utilisez le serveur MCP géré par Genie, vous avez besoin d'un accès au Genie Agent sous-jacent.

  • Accès réseau : Si votre Workspace Databricks dispose de restrictions d'accès IP, ajoutez les adresses IP sortantes de votre client à la liste d'autorisations pour lui permettre de se connecter à votre Workspace :

    • Consultez la documentation pour les listes d'accès IP du Workspace et les listes d'accès IP de compte afin de vérifier si des restrictions sont en place
    • Si les listes d'accès IP sont activées, identifiez les adresses IP sortantes de votre client. Ces informations sont généralement disponibles dans la documentation client ; par exemple, Claude documente ses adresses IP sortantes ici.
    • Assurez-vous que les IP sortantes de votre client sont ajoutées à la liste.

Méthodes d'authentification​

Choisissez la méthode d'authentification qui correspond le mieux à vos exigences de sécurité :

Méthode

Serveurs MCP gérés et services MCP

Serveur MCP hébergé par Databricks

Niveau de sécurité

Idéal pour

OAuth (recommandé)

Pris en charge

Pris en charge

Élevé : autorisations à portée limitée, automatic token refresh

Utilisation en production, environnements d'équipe, accès à long terme

Jetons d’accès personnels

Pris en charge

Non pris en charge

Moyen - accès basé sur des jetons avec expiration

Développement individuel, tests, accès à court terme

Méthode

Serveurs MCP gérés et services MCP

Serveur MCP hébergé par Databricks

Niveau de sécurité

Idéal pour

OAuth (recommandé)

Pris en charge

Pris en charge

Élevé : autorisations à portée limitée, automatic token refresh

Utilisation en production, environnements d'équipe, accès à long terme

Jetons d’accès personnels

Pris en charge

Non pris en charge

Moyen - accès basé sur des jetons avec expiration

Développement individuel, tests, accès à court terme

Connectez les clients à l'aide de l'authentification OAuth​

OAuth offre une authentification sécurisée avec des autorisations à portée limitée et un automatic token refresh.

remarque

Les serveurs MCP Databricks prennent en charge les deux types de clients, conformément à la spécification d'autorisation MCP:

  • Clients publics : Aucun secret client requis
  • Clients confidentiels : Inclure le secret client

Obtenez l'URL de redirection OAuth de votre client​

Chaque client MCP nécessite des URL de redirection OAuth spécifiques pour les rappels d'authentification. Les modèles courants d'URL de redirection incluent :

  • Clients web : https://<domain>/oauth/callback ou https://<domain>/api/mcp/auth_callback
  • Outils de développement locaux : http://localhost:<port>/oauth/callback

Veuillez consulter la documentation de votre client afin de trouver les URL de redirection exactes requises.

Créer l'application Databricks OAuth​

Demandez à un administrateur de compte de créer une application Databricks OAuth. Récupérez son ID client et, si votre client l'exige, le secret client.

Créez une application Databricks OAuth à l'aide de la console de compte:

  1. Dans la console du compte Databricks, accédez à Paramètres > Connexions aux applications > Ajouter une connexion .
  2. Configurez les paramètres de l'application :
    • **Nom** : Saisissez un nom descriptif pour votre application OAuth (par exemple,,)claude-mcp-client``mcp-inspector
    • URL de redirection : ajoutez les URL de redirection requises par votre client externe.
    • Type de client : Pour les clients publics (basés sur un navigateur, mobiles), décochez Générer un secret client . Pour les clients confidentiels (côté serveur), laissez cette option cochée.
    • Champs d’application : configurez les champs d’application de l’API (consultez la référence des champs d’application OAuth Databricks pour les champs d’application disponibles)
    • Expiration du jeton : définissez les heures d'accès et de refresh du jeton appropriées

Configurez l'accès réseau (facultatif)​

Si votre workspace Databricks a des restrictions d'accès IP, ajoutez les adresses IP sortantes de votre client à la liste d'autorisation du workspace. Dans le cas contraire, le Workspace bloque les requêtes d'authentification de votre client. Voir Gérer les listes d'accès IP.

Configurez votre client​

Après avoir créé l'application OAuth dans Databricks, configurez votre client MCP spécifique avec les identifiants OAuth. Chaque client a sa propre méthode de configuration. Voir les exemples spécifiques à la plateforme suivants pour des instructions détaillées concernant les clients MCP populaires.

Exemples OAuth​

Les exemples suivants montrent comment configurer des clients MCP spécifiques avec l'authentification OAuth. Suivez d’abord les étapes génériques de configuration d’OAuth dans la section précédente, puis utilisez ces exemples pour configurer votre client spécifique.

Le MCP Inspector est un outil de développement pour le test et le debugging des serveurs MCP.

MCP Inspecteur

Suivez la configuration de l’authentification OAuth ci-dessus avec les paramètres spécifiques à Inspector :

  • URL de redirection :

    • http://localhost:6274/oauth/callback
    • http://localhost:6274/oauth/callback/debug

  • Type de client : Public (décochez Générer un secret client )

Configurer MCP Inspector :

  1. Exécutez l'inspecteur : npx @modelcontextprotocol/inspector.
  2. Définissez Streamable HTTP le **type de transport** sur.
  3. Saisissez l'URL de votre serveur MCP Databricks.
  4. Dans la section Authentification , ajoutez votre ID client OAuth.
  5. Cliquez sur Ouvrir les paramètres d'authentification et choisissez le flux Guidé ou Rapide .
  6. Après une authentification réussie, collez le jeton d'accès dans Jeton porteur sous la section Authentification par jeton API .
  7. Cliquez sur Connecter .

Flux d&#39;authentification de l&#39;inspecteur MCP

Connecter les clients à l'aide de l'authentification par jeton d'accès personnel (PAT)​

Les jetons d'accès personnels offrent une méthode d'authentification plus simple, adaptée au développement individuel, aux tests et à l'accès à court terme aux serveurs MCP Databricks.

remarque

Les jetons d’accès personnels ne sont pris en charge que pour les serveurs MCP gérés et les services MCP. Les serveurs MCP hébergés par Databricks nécessitent une authentification OAuth.

Pour les services MCP, générez un jeton depuis la page de détails du service :

  1. Dans votre workspace, ouvrez le service MCP dans l'Explorateur de catalogues, ou accédez à AI Gateway > MCPs et sélectionnez le service.
  2. Dans Mise en route , cliquez sur Générer un jeton d'accès .
  3. Copiez la commande export DATABRICKS_TOKEN=... générée dans votre terminal. Le jeton est également ajouté aux exemples de requête sur la page.

Utilisez ce jeton pour les tests locaux et choisissez la durée de vie la plus courte qui corresponde à votre flux de travail. Ne commit pas les jetons dans le contrôle de code source et ne les partagez pas dans les fichiers de configuration client. Pour les connexions client en production ou à l'échelle de l'équipe, utilisez OAuth au lieu d'un PAT.

  1. Générez un jeton d'accès personnel dans votre workspace Databricks. Consultez S'authentifier avec les jetons d'accès personnels Databricks (hérité).

  2. Configurez l'accès réseau (facultatif).

    Si votre Workspace Databricks est soumis à des restrictions d'accès IP, ajoutez les adresses IP sortantes de votre client à la liste d'autorisation. Consultez la documentation de votre client ou la configuration réseau de votre environnement de déploiement pour obtenir les adresses IP requises.

  3. Configurez votre client.

    Après avoir généré le PAT, configurez votre client MCP pour l'utiliser pour l'authentification. Chaque client a sa propre méthode de configuration. Consultez les exemples spécifiques à la plateforme ci-dessous pour des instructions détaillées sur les clients MCP populaires.

    Lorsqu’un client demande des en-têtes personnalisés, transmettez le jeton en tant que jeton porteur dans l’en-tête Authorization : Authorization: Bearer <YOUR_TOKEN>.

Exemples de PAT​

Les exemples suivants montrent comment configurer des clients MCP spécifiques avec l'authentification par jeton d'accès personnel. Suivez d'abord la configuration d'authentification PAT ci-dessus, puis utilisez ces exemples pour configurer votre client spécifique.

Cursor prend en charge le MCP via sa configuration des paramètres.

  1. Ouvrez les paramètres de votre Curseur.

  2. Ajoutez la configuration suivante (adaptez l’URL à votre serveur MCP choisi) :

    JSON
    {
      "mcpServers": {
        "uc-function-mcp": {
          "type": "streamable-http",
          "url": "https://<your-workspace-hostname>/api/2.0/mcp/functions/{catalog_name}/{schema_name}",
          "headers": {
            "Authorization": "Bearer <YOUR_TOKEN>"
          },
          "note": "Databricks UC function"
        }
      }
    }

  3. Remplacez <your-workspace-hostname> par le hostname de votre Databricks Workspace.

  4. Remplacez <YOUR_TOKEN> par votre jeton d'accès personnel.

Résoudre les problèmes de connexion​

Suivez ces étapes de dépannage pour diagnostiquer et résoudre les problèmes de connexion courants.

Valider l'authentification​

Vérifiez que vos identifiants d'authentification sont configurés correctement avant de tester la connexion.

Pour l’authentification OAuth utilisateur-machine (U2M), testez la connexion avec l’inspecteur MCP. Le flux OAuth valide les informations d'identification pendant le processus de connexion.

Vérifier la configuration réseau​

Les restrictions réseau peuvent empêcher les clients externes de se connecter à votre workspace Databricks. Assurez-vous que toute politique de liste d'accès IP Databricks est configurée pour permettre à votre client de se connecter à votre compte Databricks et à votre workspace. Voir Prérequis.

Identifier les problèmes de connexion spécifiques au client​

Veuillez essayer de vous connecter avec un autre client MCP afin de vérifier si le problème persiste. Databricks vous recommande d'effectuer des tests avec le MCP Inspector. Si votre connexion fonctionne avec l'inspecteur MCP mais échoue avec votre client, le problème est probablement lié à la configuration de votre client. Contactez le fournisseur client pour plus d'assistance.

Signaler les problèmes au support Databricks​

Si vous continuez à rencontrer des problèmes de connexion après avoir terminé ces étapes de dépannage :

  1. Veuillez consulter les Logs de votre client MCP, tels que Claude, Cursor ou MCP Inspecteur, pour les messages d'erreur et les traces de pile.

  2. Collectez les informations de diagnostic suivantes :

    • Méthode d’authentification utilisée (OAuth ou PAT)
    • URL du serveur MCP
    • Messages d'erreur du client
    • Détails de la configuration réseau (restrictions IP, règles de pare-feu)

  3. Contactez le support et partagez les informations de diagnostic pour résoudre le problème.

Limitations​

  • Enregistrement dynamique du client : Databricks ne prend pas en charge les flux d’enregistrement dynamique du client OAuth pour les serveurs MCP gérés, les services MCP ou les serveurs MCP hébergés par Databricks. Les clients externes et les IDEs qui exigent l'enregistrement dynamique du client ne sont pas pris en charge avec l'authentification OAuth.
  • Prise en charge des jetons d'accès personnels pour les serveurs MCP hébergés par Databricks : les serveurs MCP que vous hébergez sur Databricks Apps ne prennent pas en charge les jetons d'accès personnels pour l'authentification.

Ressources supplémentaires​

Sur cette page