Authentification MCP et réseau

Pour une configuration étape par étape, utilisez le guide de votre agent de programmation ou le quickstart Python. Utilisez cette page pour vérifier les exigences d’authentification partagée et l’accès au réseau.

Sign in to Azure Databricks

Utilisez votre compte utilisateur Azure Databricks pour le travail interactif, ou un principal de service pour un agent qui s’exécute sans surveillance. Suivez la configuration pour votre agent :

Cas d’utilisation	Configuration recommandée
Agents de codage	Utilisez la interface de commande Unity Gateway. Il gère la connexion et actualise les identifiants.
Développement local de Python	Utilisez la connexion CLI de Databricks.
Autres clients MCP interactifs	Configurez OAuth avec un identifiant client enregistré.
Agents non surveillés	Utilisez un principe de service avec OAuth machine-to-machine (M2M). Pour les agents sur Databricks Apps, voir Authentification des agents.

L’utilisateur ou le principal de service a besoin d’une autorisation pour appeler le MCP. Si un outil vous demande de vous connecter à un fournisseur externe, suivez la section Configuration des services externes.

Pour les tests locaux, les MCP fournis et enregistrés par Databricks, ainsi que les points de terminaison d’espace de travail hérités, acceptent un jeton d’accès personnel dans l’en-tête Authorization: Bearer <token> . Gardez les jetons hors du contrôle source. Les serveurs hébergés sur Databricks Apps nécessitent OAuth et n’acceptent pas les jetons d’accès personnels.

Configurez un client OAuth personnalisé

Utilisez-le lorsque votre client a besoin de sa propre application OAuth. Les guides Claude Code et Codex incluent leurs paramètres spécifiques au client.

1. Obtenez l’URL exacte de redirection de votre client, y compris son hôte, son port et son chemin.

2. Faites ouvrir les paramètres par un administrateur de compte dans la console de compte, sélectionnez connexions à l’application, puis cliquez sur Ajouter connexion.

3. Saisissez un nom, ajoutez l’URL de redirection, et sélectionnez les scopes pour votre serveur :

   Serveur	URL	Scope
   MCP fourni ou enregistré	https://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service>	ai-gateway
   Serveur sur Databricks Apps	https://<app-url>/mcp	Incluez les portées d’autorisation utilisateur de l’application. Vous devez aussi POUVOIR UTILISER sur l’application.
   Endpoint MCP de l’espace de travail (hérité)	L’URL sur la page du serveur	Utilisez les lunettes listées pour ce serveur.

4. Choisissez de générer un secret client :

   • Client de bureau ou CLI (client public) : Clear Générer un secret client.
   • Client côté serveur qui stocke de manière sécurisée les secrets (client confidentiel) : Laisser Générer un secret client sélectionné.

5. Sauvegardez la connexion et copiez l’identifiant client. Si vous avez généré un secret client, copiez aussi cette valeur.

6. Saisissez l’URL du serveur et les identifiants du client dans votre client MCP. Utilisez HTTP streamable, demandez la portée du serveur et offline_access les jetons de rafraîchissement, puis connectez-vous.

Voir Créer une application OAuth pour les options d’interface utilisateur et de CLI. Les changements peuvent prendre jusqu’à 30 minutes pour faire effet. Les terminaux MCP d'Azure Databricks ne prennent pas en charge l'enregistrement dynamique du client, donc utilisez un client qui accepte un identifiant client préconfiguré.

Accès réseau

Vérifiez l’accès du client à l’espace de travail et de l’espace de travail au serveur externe.

Du client vers l’espace de travail

Les requêtes MCP doivent être autorisées par les contrôles réseau entrants de votre espace de travail. Si les listes d’accès IP de l’espace de travail sont activées, demandez à un administrateur d’autoriser les adresses IP publiques d’origine des requêtes :

Où s’exécute le client MCP	Adresses à autoriser
Sur votre ordinateur, comme Claude Code, Codex CLI ou Cursor	L’IP publique sortante de votre réseau. Si le trafic passe par un VPN ou un proxy d’entreprise, utilisez l’IP sortante de ce réseau. Votre administrateur réseau peut le fournir.
Dans un service hébergé, tel qu’un connecteur Claude ou ChatGPT	Les plages d’IP sortantes publiées par le fournisseur. Voir les IP sortantes de Claude et les IP sortantes de ChatGPT.

Pour les clients hébergés, la connexion au navigateur se fait depuis votre réseau, tandis que les appels MCP proviennent des serveurs du fournisseur. Les deux doivent être autorisés. Par exemple, se connecter correctement depuis votre VPN d’entreprise ne signifie pas que ChatGPT peut atteindre votre MCP.

Si votre organisation utilise également des contrôles d’entrée contextuels, les requêtes doivent également satisfaire à ces politiques. Les listes d’accès IP des comptes s’appliquent à l’accès à la console de compte et à l’API de compte, comme un administrateur créant une application OAuth.

Workspace vers serveur MCP externe

Les appels vers des fournisseurs MCP externes via Unity Gateway utilisent le plan de calcul serverless de l’espace de travail. Cela s’applique aux serveurs externes enregistrés et aux MCP fournis par Databricks pour les services externes.

Si votre politique réseau sans serveur utilise l’accès restreint, ajoutez le nom de domaine entièrement qualifié (FQDN) du serveur à Domaines autorisés. Commencez par l’hôte sur la connexion Unity Catalog du MCP. Vérifiez system.access.outbound_network la présence d’autres destinations bloquées. Voir Gérer les politiques réseau et les journaux réseau sortants.

• Une connexion Unity Catalog n’autorise pas automatiquement sa destination.
• L’accès complet est le mode de la politique réseau sans serveur permettant par défaut les connexions internet sortantes. Les domaines explicitement bloqués restent refusés. Par exemple, une politique qui bloque mcp.example.com empêche les appels vers ce serveur MCP. Demandez à un administrateur de vérifier les destinations bloquées dans la politique.
• Pour tester le trafic MCP en mode test à blanc, sélectionnez Tous les produits. Les options de service des modèlesSQL et IA de Databricks ne mettent pas le trafic MCP en échec à blanc.

Connectivité privée

Pour atteindre un serveur MCP dans votre réseau cloud, choisissez comment le calcul serverless Azure Databricks s’y connecte :

• Point de terminaison privé : Utilisez Private Link pour conserver le trafic sur une connexion privée. Un administrateur de compte ajoute une règle de terminaison privée pour le domaine du serveur à une configuration de connectivité réseau (NCC) attachée à votre espace de travail. Votre administrateur cloud approuve la connexion de terminaison. Voir Configurer la connectivité privée.
• Endpoint public avec pare-feu : Configurez le pare-feu du serveur pour permettre à Azure Databricks d'obtenir des IP sortantes serverless pour le cloud et la région de votre espace de travail. Ces IP sont partagées entre les clients Azure Databricks, il faut donc maintenir l’authentification activée sur le serveur. Voir Trouver les IP sortantes et configurer votre pare-feu.

Les domaines ajoutés aux règles de points de terminaison privés sont automatiquement autorisés par les politiques réseau, donc vous n’avez pas besoin de les ajouter séparément aux domaines autorisés. Pour un point de terminaison public, suivez la configuration de la politique réseau ci-dessus.