Réseautage MCP
Vérifiez l'accès réseau dans les deux directions : entrant, depuis votre client MCP (Model Context Protocol) vers votre workspace, et sortant, depuis votre workspace vers des serveurs MCP externes. Pour la connexion et l’identité, consultez l’authentification MCP.
Client vers workspace (entrant)
Les requêtes MCP doivent être autorisées par les contrôles réseau entrants de votre workspace. Le tableau suivant indique ce qu'il faut autoriser pour chaque type de client et de contrôle entrant :
Entrée basée sur le contexte (recommandé) | Private Link front-end avec accès public désactivé | |
|---|---|---|
Le client MCP s’exécute dans un service hébergé, tel que ChatGPT ou un connecteur Claude | Ajoutez ChatGPT ou Claude en tant que plateforme partenaire. Databricks maintient les plages IP à jour. | Les clients hébergés ne peuvent pas se connecter. Gardez l'accès public activé et restreignez-le avec l'entrée basée sur le contexte. |
Le client MCP s’exécute sur votre informatique, tel que Claude Code, Codex CLI ou Cursor | Autorisez l’adresse IP publique sortante de votre réseau. | Connectez-vous via l'endpoint privé. |
Pour les clients hébergés, la connexion au navigateur provient de votre réseau, tandis que les appels MCP proviennent des serveurs du fournisseur. Les deux doivent être autorisés. Par exemple, une connexion réussie depuis votre VPN d’entreprise ne signifie pas que ChatGPT peut atteindre votre MCP.
Autoriser les clients avec une entrée basée sur le contexte (recommandé)
Pour sécuriser l’accès réseau entrant à votre workspace tout en permettant aux clients MCP de se connecter, Databricks recommande d’utiliser des contrôles d’entrée basés sur le contexte:
- Clients hébergés : Ajoutez ChatGPT ou Claude comme plateforme partenaire dans une politique d’entrée basée sur le contexte du workspace. Databricks synchronise les plages IP publiées du fournisseur, de sorte que vous n’avez pas à les gérer vous-même. Consultez Autoriser les plateformes partenaires dans les politiques d’accès entrant basées sur le contexte.
- Clients sur votre informatique : ajoutez une règle qui autorise l’adresse IP publique de sortie de votre réseau. Si le trafic passe par un VPN ou un proxy d’entreprise, utilisez l’adresse IP de sortie de ce réseau. Demandez-le à votre administrateur réseau.
En mode forcé, l'entrée basée sur le contexte bloque les demandes qui ne correspondent pas à une règle d'autorisation. Les demandes autorisées doivent toujours être authentifiées et elles s’exécutent avec les autorisations de l’utilisateur authentifié ou du Service Principal qui les a effectuées.
Private Link front-end
Si votre Workspace utilise un Private Link front-end avec l'accès public désactivé, les clients MCP sur votre informatique peuvent se connecter, mais les MCP dans les clients hébergés, tels que les connecteurs ChatGPT et Claude, sont bloqués.
Pour autoriser ces clients tout en limitant l’accès public, activez l’accès public et restreignez-le avec une politique d’entrée basée sur le contexte qui les autorise en tant que plateformes partenaires.
Listes d’accès IP des Workspace
Si votre workspace applique encore des listes d’accès IP de workspace, elles sont évaluées en même temps que l’entrée basée sur le contexte, et une requête doit être autorisée par les deux. Une règle de plateforme partenaire ne suffit pas tant qu’une liste d’accès IP bloque les IP du fournisseur. Migrez vos listes d’accès IP vers une entrée basée sur le contexte et désactivez leur application. Voir Migrer les listes d'accès IP de workspace vers une entrée basée sur le contexte.
Si vous ne pouvez pas encore effectuer la migration, ajoutez les plages IP publiées du fournisseur à votre liste d'accès IP. Consultez les IP sortantes de Claude et les IP sortantes de ChatGPT. Pour les clients sur votre informatique, ajoutez l'IP sortante publique de votre réseau. Les fournisseurs modifient leurs plages IP ; vous devez donc mettre à jour la liste lorsqu'ils le font.
Listes d’accès IP au compte
Les listes d’accès IP du compte s’appliquent à la console du compte et à l’accès à l’API du compte, par exemple lorsqu’un administrateur crée une application OAuth. Elles ne s’appliquent pas aux appels MCP vers votre workspace.
Workspace vers serveur MCP (sortant)
Les appels aux fournisseurs MCP externes via Unity Gateway utilisent le plan de compute Serverless du Workspace. Cela s’applique aux serveurs externes enregistrés et aux MCP fournis par Databricks pour les services externes. Le contrôle du trafic sortant serverless détermine les destinations que le compute serverless peut atteindre.
Serveurs MCP sur Internet public
Si le contrôle de sortie serverless pour votre workspace utilise un Accès restreint , ajoutez le nom de domaine complet (FQDN) du serveur aux Domaines autorisés . start avec l'hôte sur la connexion Unity Catalog du MCP. Consultez Gérer les stratégies réseau pour le contrôle de sortie serverless.
- Une connexion Unity Catalog n’autorise pas automatiquement sa destination.
- Avec un accès complet , le compute Serverless peut atteindre les destinations Internet default, mais les domaines explicitement bloqués restent refusés. Par exemple, le blocage de
mcp.example.comempêche les appels vers ce serveur MCP. Demandez à un administrateur de consulter les destinations bloquées. - Pour tester le trafic MCP en mode d'essai, sélectionnez Tous les produits . Les options Databricks SQL et Service de modèles IA ne placent pas le trafic MCP en mode d'essai.
Serveurs MCP dans votre réseau cloud
Pour atteindre un serveur MCP dans votre réseau cloud, choisissez comment le compute serverless Databricks s'y connecte :
- Endpoint privé : utilisez Private Link pour maintenir le trafic sur une connexion privée. Un administrateur de compte ajoute une règle d'endpoint privé pour le domaine du serveur à une configuration de connectivité réseau (NCC) attachée à votre workspace. Votre administrateur cloud approuve la connexion à l'endpoint. Voir Configurer une connectivité privée.
- Endpoint public avec pare-feu : configurez le pare-feu du serveur pour autoriser les adresses IP sortantes serverless de Databricks pour le cloud et la région de votre workspace. Ces adresses IP sont partagées entre les clients Databricks, veillez donc à conserver l’authentification activée sur le serveur. Consultez Configurer l’accès à d’autres ressources à l’aide d’adresses IP sortantes.
Le contrôle de sortie serverless autorise automatiquement les domaines dans les règles d'endpoint privé qui spécifient des noms de domaine, vous n'avez donc pas besoin de les ajouter aux domaines autorisés . Pour un endpoint public, suivez les serveurs MCP sur l'Internet public.
Dépanner les demandes bloquées
Utilisez les tables système d'accès réseau pour déterminer quelle règle a bloqué une requête :
- Entrant : query
system.access.inbound_networkpour les requêtes qu’une stratégie d’entrée a refusées. Consultez Événements d’accès réseau entrant. - Sortant : Query
system.access.outbound_networkpour les destinations que le contrôle de sortie serverless a bloquées. Consultez Événements d’accès réseau sortant.
Causes courantes :
- La connexion fonctionne, mais les appels MCP échouent depuis un client hébergé : les plages d’adresses IP du fournisseur ne sont pas autorisées. Ajoutez le fournisseur comme plateforme partenaire, ou ajoutez ses plages IP à votre liste d’accès IP.
- Une règle de plateforme partenaire est en place, mais les requêtes sont toujours bloquées : les listes d'accès IP du workspace sont toujours appliquées et ne comprennent pas les adresses IP du fournisseur. Consultez Listes d'accès IP du workspace.
- Un client hébergé ne peut pas accéder à un workspace avec un Private Link front-end : l'accès public est désactivé. Activez l'accès public et restreignez-le avec une entrée basée sur le contexte.
- Les appels à un serveur MCP externe échouent : le domaine du serveur ne figure pas dans les domaines autorisés ou il est explicitement bloqué.