Authentification MCP
Les clients du protocole de contexte de modèle (MCP) s’authentifient auprès de Databricks pour appeler des outils. Lorsqu’un outil accède à un service externe, un identifiant distinct détermine le compte de fournisseur qu’il utilise.
Cette page explique les méthodes d'authentification prises en charge pour Unity Gateway et les serveurs MCP sur Databricks Apps. Utilisez les guides de configuration pour configurer l'authentification pour votre client, agent ou serveur MCP. Pour les listes d'accès IP, les stratégies réseau et la connectivité privée, voir Mise en réseau MCP.
Le diagramme suivant montre les deux étapes d’authentification pour un MCP externe accessible via Unity Gateway.
- Authentification entrante : Le client envoie un jeton Databricks qui identifie un utilisateur ou un Service Principal Databricks.
- Authentification sortante : Unity Gateway envoie le jeton du fournisseur externe au MCP. La méthode d’authentification configurée dans la connexion Unity Catalog détermine si elle utilise le compte fournisseur de chaque utilisateur ou un compte partagé.
Trouvez votre guide de configuration
Choisissez un guide pour les prérequis, les étapes de configuration et le code correspondant à votre cas d’utilisation.
GUIDE | Ce qu'il couvre |
|---|---|
Ajoutez des MCP, autorisez l’accès des fournisseurs et appelez des outils. Start avec le guide de démarrage de l’agent de codage si votre agent n’est pas encore connecté à Databricks. | |
Configurez un client OAuth et ajoutez le connecteur MCP. Pour un autre client professionnel, consultez Autres clients MCP. | |
Votre application sert plusieurs utilisateurs. Utilisez le jeton de chaque utilisateur, vérifiez sa connexion au fournisseur et appelez des outils avec ses autorisations. | |
Générez ou testez un agent localement. Connectez-vous avec la CLI, chargez les outils MCP et exécutez l’agent avec le framework de votre choix. | |
Déployez un serveur MCP sur Databricks Apps, activez l’autorisation utilisateur et configurez une connexion HTTP à votre API. | |
Authentifiez un agent sans surveillance avec un service principal | Configurez les informations d'identification M2M OAuth, puis utilisez-les avec le client Python MCP. |
Enregistrez le serveur, choisissez sa méthode d’authentification et testez un outil. |
Utiliser des outils MCP avec l’accès consommateur
Les utilisateurs peuvent appeler les outils MCP via Unity Gateway à partir d'agents de codage, d'applications personnalisées et de clients professionnels avec le droit Accès des consommateurs . Ils n’ont pas besoin du droit Accès au workspace , qui accorde l’accès aux outils de création de workspace tels que les notebooks et les jobs.
Un administrateur accorde l’ accès au consommateur et la permission d’appeler le MCP. Pour les MCP qui utilisent OAuth par utilisateur, les utilisateurs autorisent leur compte de fournisseur via la page de connexion MCP.
L'accès des consommateurs prend en charge l'utilisation des outils MCP. La gestion des MCP dans l'interface utilisateur de Unity Gateway nécessite un accès Workspace . Voir les capacités d'accès des consommateurs.
Authentification entrante prise en charge
Le client envoie un jeton Databricks lorsqu'il appelle un MCP via Unity Gateway ou sur Databricks Apps. Ce jeton identifie l'utilisateur Databricks ou le Service Principal Databricks effectuant la demande.
Votre cas d'utilisation | Authentification pour l'utilisation |
|---|---|
Une personne se connecte à partir d’un agent de codage ou d’un client professionnel. | OAuth utilisateur-à-machine (U2M) appelle le MCP en tant qu'utilisateur connecté. |
Un agent ou un service sans surveillance s’exécute sans utilisateur. | Les appels OAuth machine-to-machine (M2M) appellent le MCP en tant que service principal. |
Votre application ou votre charge de travail possède déjà un jeton provenant d’un fournisseur d’identité. | La fédération de jetons OAuth échange ce jeton contre un jeton OAuth Databricks pour l'utilisateur ou le Service Principal mappé. |
Une intégration existante utilise un jeton d’accès personnel. | Le jeton d’accès personnel (PAT) appelle le MCP en tant que propriétaire du jeton. Pris en charge via Unity Gateway. Non pris en charge pour les serveurs MCP sur Databricks Apps. |
Authentification sortante prise en charge
L'authentification sortante détermine les identifiants reçus par un MCP externe ou un backend. Unity Gateway gère les identifiants par le biais de connexions Unity Catalog. Un serveur MCP sur Databricks Apps peut utiliser une connexion ou implémenter sa propre authentification backend.
Via les connexions Unity Catalog
Unity Gateway s’authentifie auprès du MCP externe avec le jeton du fournisseur configuré ou obtenu via sa connexion au Unity Catalog.
Unity Gateway prend en charge les cinq méthodes d’authentification disponibles pour les connexions HTTP Unity Catalog. Le MCP externe doit prendre en charge la méthode sélectionnée :
Méthode prise en charge | Quand l’utiliser | Identité au MCP externe |
|---|---|---|
Tous les appelants partagent un jeton pour accéder au MCP. | Le compte représenté par le jeton partagé. | |
Le MCP prend en charge les identifiants client OAuth pour une identité de service partagée. | L'identité de service configurée dans la connexion. | |
Le MCP nécessite une connexion utilisateur, et tous les appelants doivent utiliser un compte de fournisseur partagé. | Le compte de fournisseur autorisé pour la connexion. | |
Le MCP prend en charge l'inscription automatique des clients OAuth et la connexion par utilisateur. | Le compte de fournisseur que l’appelant a autorisé. | |
Chaque utilisateur a besoin d'un accès via son propre compte de fournisseur, à l'aide d'un client OAuth configuré. | Le compte de fournisseur que l’appelant a autorisé. |
MCP fournis par Databricks
Pour les MCP de données tels que Databricks SQL, l’identité Databricks de l’appelant détermine l’accès aux données sous-jacentes. Les MCP pour les services externes, tels que GitHub, utilisent l’authentification du fournisseur comme décrit dans Via les connexions Unity Catalog. Consultez MCP fournis par Databricks pour connaître les exigences de chaque serveur.
Agents et serveurs MCP sur Databricks Apps
Un agent ou un serveur MCP sur Databricks Apps peut appeler Databricks en utilisant l'autorisation d'application en tant que service principal de l'application, ou l'autorisation d'utilisateur en tant qu'utilisateur actuel.
La destination détermine comment authentifier l'appel sortant :
- APIs Databricks ou autres MCP via Unity Gateway : utilisez l’autorisation d’application pour appeler en tant qu’application, ou l’autorisation utilisateur pour appeler en tant qu’utilisateur actuel.
- APIs REST externes via le proxy de connexion HTTP: Le proxy s’authentifie auprès de l’API externe à l’aide de la méthode de connexion sélectionnée. Pour appeler en tant que chaque utilisateur, combinez l’autorisation utilisateur des applications avec OAuth par utilisateur sur la connexion.
- APIs externes ou MCPs appelés directement : implémentez le flux d'authentification pris en charge par ce service dans votre serveur.
Pour la configuration, les étendues requises et le code, consultez Configurer l’authentification de l’agent et Exposer une API REST en tant qu’outils MCP.