Connectez les clients IA au serveur MCP AI Data Engine
Connectez Claude Code, Claude Desktop, Cursor ou OpenCode au serveur Model Context Protocol (MCP) pour AI Data Engine (AIDE) afin de pouvoir rechercher des métadonnées de fichiers et étiqueter les fichiers dans les collections auxquelles vous avez accès.
Avant de commencer
-
Un administrateur a terminé la configuration dans "Configurer Microsoft Entra ID pour l’accès gouverné à l’IA" et "Connectez AI Data Engine à Microsoft Entra ID", y compris les éléments suivants :
-
Nous vous attribuons le
AIDE Power Usersrôle de l’application. -
Configurer une collection pour MCP avec une portée qui vous inclut. Consultez "Configurer une collection pour MCP".
-
Activation de Enable connection to MCP dans MCP settings. Si la connexion est désactivée, les clients IA ne peuvent se connecter à aucune collection.
-
Ajoutez l'URI de redirection de votre client IA à l'application AI Data Engine et autorisez les flux de clients publics. Le client IA se connecte en tant que client public, vous n'avez donc pas besoin d'un secret client.
-
-
Vous disposez de la configuration du client MCP fournie par votre administrateur. L’administrateur la génère dans NetApp Console en configurant la collection pour MCP, copie l’URL du serveur MCP ou l’extrait spécifique au client depuis l’étape Generate MCP code snippet, puis vous le partage. Elle comprend les éléments suivants :
-
L'URL du serveur MCP, au format
https://<mcp-server-host>/mcp/tools. -
L’ID du locataire Microsoft Entra ID.
-
L'ID client, qui est l'ID d'application (client) de l'application AI Data Engine dans Entra ID.
-
Les portées demandées par votre client IA :
-
https://<mcp-server-host>/mcp/tools/power_users, qui est l'URI de l'identifiant de l'application plus/power_users. -
offline_access, afin que le client puisse actualiser les jetons sans vous demander de vous reconnecter.
-
-
L'identifiant de la collection avec laquelle vous souhaitez travailler.
-
-
Votre appareil peut accéder au serveur MCP via HTTPS sur le port 443. Le serveur MCP s'exécute dans votre réseau ; connectez-vous donc depuis votre réseau d'entreprise ou via un VPN. Votre appareil doit également être capable d'effectuer les opérations suivantes :
-
Résolvez le nom de l'hôte du cluster AIDE via DNS.
-
Faites confiance au certificat présenté par l'hôte. S'il s'agit d'un certificat auto-signé, installez-le comme certificat de confiance sur votre appareil.
-
Accédez à la page de connexion Microsoft Entra ID (
login.microsoftonline.com).
-
-
Vous disposez d'une version prise en charge du client IA.
Clients IA validés
Les instructions de cette page couvrent les clients d’IA que NetApp a validés : Claude Code, Claude Desktop, Cursor et OpenCode. Pour plus de détails, reportez-vous à "Clients IA validés".
Les clients d'IA qui se connectent à votre réseau depuis le service d'un fournisseur de cloud ne sont pas pris en charge. Par exemple, les connecteurs personnalisés intégrés à un client d'IA et appelés depuis le cloud du fournisseur ne peuvent pas atteindre le serveur MCP de votre réseau. Suivez plutôt la procédure de configuration décrite sur cette page.
Vérifiez votre configuration avant de la coller
Avant de coller un extrait dans votre client d'IA, vérifiez les points suivants :
-
L'hôte est le nom de l'hôte de votre cluster AIDE, et non une adresse IP de cluster ou de service.
-
L'URL se termine par
/mcp/toolset inclut le nomcollection_idde la collection avec laquelle vous souhaitez travailler. -
La portée est
https://<mcp-server-host>/mcp/tools/power_users, ce qui correspond à l'URI de l'ID d'application plus/power_users. -
L'identifiant client est l'identifiant de l'application (client) de l'application AI Data Engine dans Entra ID.
Connectez Claude Desktop
|
|
La génération des informations de connexion dans NetApp Console ne permet pas de connecter ni de valider votre client AI. Effectuez ces tâches dans le client AI. |
Claude Desktop se connecte au serveur MCP AI Data Engine via mcp-remote, un petit utilitaire qui s'exécute sur votre ordinateur.
Installez Node.js sur votre ordinateur. L' `mcp-remote`utilitaire fonctionne avec Node.js.
-
Dans Claude Desktop, ouvrez le fichier de configuration
claude_desktop_config.json. Par défaut, le fichier se trouve à l’un des emplacements suivants :-
macOS :
~/Library/Application Support/Claude/claude_desktop_config.json -
Windows :
%APPDATA%\Claude\claude_desktop_config.json
-
-
Ajoutez le serveur MCP AI Data Engine sous
mcpServers. Remplacez les espaces réservés par les valeurs fournies par votre administrateur :{ "mcpServers": { "netapp-ai-data-engine": { "command": "npx", "args": [ "-y", "mcp-remote@<tested version>", "https://<mcp-server-host>/mcp/tools?collection_id=<collection-id>", "--static-oauth-client-info", "{\"client_id\": \"<application-client-id>\"}", "--static-oauth-client-metadata", "{\"scope\": \"https://<mcp-server-host>/mcp/tools/power_users offline_access\"}", "--disable-resource-parameter" ] } } }Conservez l' --disable-resource-parameter`argument. Sans lui, Microsoft Entra ID rejette la demande de connexion avec l'erreur `AADSTS9010010. -
Enregistrez le fichier et redémarrez Claude Desktop.
-
Lorsque le navigateur s'ouvre, connectez-vous avec votre compte Microsoft Entra ID et acceptez l'invite de consentement si elle apparaît.
-
Dans Claude Desktop, ouvrez Connectors et vérifiez que le serveur AI Data Engine est bien répertorié avec ses outils.
Connecter Claude Code
Claude Code se connecte directement au serveur MCP AI Data Engine.
-
Ajoutez le serveur MCP AI Data Engine. Remplacez les espaces réservés par les valeurs fournies par votre administrateur :
claude mcp add --transport http \ --client-id <application-client-id> \ --callback-port 8080 \ --scope user \ netapp-ai-data-engine "https://<mcp-server-host>/mcp/tools?collection_id=<collection-id>"Ne transmettez pas --client-secret. L'application cliente est un client public. -
Pour demander les portées AI Data Engine, ouvrez le fichier de configuration Claude Code et modifiez l'entrée
netapp-ai-data-engine. Les entrées de portée utilisateur se trouvent dans~/.claude.json. Les entrées de portée projet se trouvent dans.mcp.json.{ "mcpServers": { "netapp-ai-data-engine": { "type": "http", "url": "https://<mcp-server-host>/mcp/tools?collection_id=<collection-id>", "oauth": { "clientId": "<application-client-id>", "callbackPort": 8080, "scopes": "https://<mcp-server-host>/mcp/tools/power_users offline_access", "authServerMetadataUrl": "https://login.microsoftonline.com/<tenant-id>/v2.0/.well-known/openid-configuration" } } } } -
Dans Claude Code, exécutez
/mcpet connectez-vous avec votre compte Microsoft Entra ID. Ou, depuis un shell, exécutezclaude mcp login netapp-ai-data-engine. -
Exécutez
claude mcp listet confirmez que le serveur AI Data Engine s’affiche comme connecté.
Connecter le curseur
Cursor se connecte directement au serveur MCP de AI Data Engine.
-
Dans Cursor, ouvrez le fichier de configuration MCP
mcp.json. Pour utiliser le serveur dans tous vos projets, ouvrez~/.cursor/mcp.json. Pour l’utiliser uniquement dans le projet actuel, ouvrez.cursor/mcp.json. -
Ajoutez le serveur MCP AI Data Engine. Remplacez les espaces réservés par les valeurs fournies par votre administrateur :
{ "mcpServers": { "netapp-ai-data-engine": { "url": "https://<mcp-server-host>/mcp/tools?collection_id=<collection-id>", "auth": { "CLIENT_ID": "<application-client-id>", "scopes": [ "https://<mcp-server-host>/mcp/tools/power_users", "offline_access" ] } } } }Ne collez pas de bearer token dans ce fichier. Cursor utilise l’identifiant client pour vous connecter. -
Enregistrez le fichier, puis rechargez Cursor.
-
Dans Cursor Settings > MCP, sélectionnez Connect pour le serveur AI Data Engine.
-
Lorsque le navigateur s'ouvre, connectez-vous avec votre compte Microsoft Entra ID et acceptez l'invite de consentement si elle apparaît.
-
Dans Cursor Settings > MCP, vérifiez que le serveur AI Data Engine est activé et que ses outils sont répertoriés. Si ce n'est pas le cas, consultez Output > MCP Logs.
Connecter OpenCode
OpenCode se connecte directement au serveur MCP de AI Data Engine.
-
Ajoutez le serveur MCP AI Data Engine. Remplacez les espaces réservés par les valeurs fournies par votre administrateur :
opencode mcp add netapp-ai-data-engine --global --url "https://<mcp-server-host>/mcp/tools?collection_id=<collection-id>" -
Pour ajouter votre application cliente, ouvrez
~/.config/opencode/opencode.json, ou le fichieropencode.jsondans votre projet, et modifiez l’entréenetapp-ai-data-engine:{ "$schema": "https://opencode.ai/config.json", "mcp": { "servers": { "netapp-ai-data-engine": { "type": "remote", "url": "https://<mcp-server-host>/mcp/tools?collection_id=<collection-id>", "oauth": { "client_id": "<application-client-id>", "scope": "https://<mcp-server-host>/mcp/tools/power_users offline_access" } } } } }Ne définissez pas oauthsurfalseet n'ajoutez pas de secret client à ce fichier. -
Dans OpenCode, exécutez
/mcps, sélectionnez le serveur AI Data Engine, et connectez-vous avec votre compte Microsoft Entra ID lorsque le navigateur s'ouvre. -
Exécutez
opencode mcp listet confirmez que le serveur AI Data Engine s'affiche comme connecté.Le statut
needs authenticationsignifie que OpenCode a enregistré la configuration, mais vous n'avez pas terminé la connexion.
Ce que vous pouvez faire
Après la connexion, votre client AI peut utiliser cinq outils : get_collection, search, list_tags, create_tag et tag_document. La connexion est limitée à la collection dans l’URL du serveur MCP. Pour utiliser une autre collection, utilisez les détails de connexion de cette collection. Consultez "Outils MCP pour l'accès à l'IA régi par AI Data Engine" pour savoir à quoi sert chaque outil.
Ces outils sont disponibles dans une session d’utilisateur avancé, qui nécessite le AIDEPowerUsers rôle d’application et le power_users scope.
|
|
Pour effectuer une recherche dans tous les systèmes et volumes numérisés, utilisez les informations de connexion de la collection Tous les fichiers. |
Votre client IA ne peut pas récupérer le contenu des fichiers, ajouter, supprimer ou modifier des fichiers, changer les sources de données ou créer des collections.
Les étiquettes s'appliquent à l'ensemble de AI Data Engine, et pas seulement à une seule collection. Une erreur d'orthographe dans le nom d'une étiquette en crée une nouvelle, et les noms d'étiquettes sont sensibles à la casse. Par exemple, Finance et finance sont des étiquettes différentes. Vous ne pouvez pas renommer une étiquette après l'avoir créée. Pour connaître les limitations relatives aux noms d'étiquettes, reportez-vous à "Limitations connues".
Exemples de consignes
Remplacez les espaces réservés par des valeurs provenant de votre environnement.
Métadonnées de recherche
-
"Énumérez les collectes de données que je peux rechercher."
-
"Dans la <collection name> collection, trouvez tous les fichiers PDF."
-
"Dans la <collection name> collection, trouvez les fichiers dont le nom commence par
<prefix>." -
"Dans la <collection name>collection, listez les fichiers appartenant à <owner>."
-
« Combien <file type> de fichiers contient la <collection name> collection ? »
-
"Afficher le chemin d'accès, la taille et la date de dernière modification des fichiers nommés
<prefix>dans la collection <collection name>."
|
|
Filtres de recherche sur le préfixe du nom de fichier, le type de fichier et le propriétaire. Si vous recherchez des fichiers par taille, date ou dossier, le client AI devra parcourir de nombreux résultats, et la réponse risque d'être incomplète. |
Fichiers de balises
-
"Indiquez les balises utilisées et le nombre de fichiers possédant chaque balise."
-
"Créez l'étiquette <tag name> et appliquez-la à <file name>."
-
"Appliquez l'étiquette <tag name> aux fichiers de ma dernière recherche."
-
"Supprimez la balise <tag name> de <file name> dans la collection <collection name>."
Résoudre les problèmes de connexion
| Problème | Résolution |
|---|---|
La connexion via le navigateur échoue avec une erreur `AADSTS50011`ou une autre erreur d'URI de redirection. |
Demandez à votre administrateur d’ajouter l’URI de redirection exacte indiquée dans l’erreur aux paramètres Authentication, sous Mobile and desktop applications, de l’application AI Data Engine dans Entra ID. Le port de votre configuration client doit correspondre à l’URI enregistrée. |
La connexion échoue avec l'erreur |
Le consentement n'a pas été accordé, ou le client n'est pas autorisé. Demandez à votre administrateur d'accorder le consentement, ou d'ajouter l'Application (client) ID en tant qu'application cliente autorisée pour le `power_users`périmètre. |
La connexion échoue avec l'erreur |
La chaîne de portée ne correspond pas. Utilisez l’URI de l’ID d’application plus |
Claude Code ou OpenCode affiche |
Connectez-vous. Dans Claude Code, exécutez |
La connexion à Claude Desktop échoue avec l’erreur |
Assurez-vous que les |
Le client IA reçoit |
Il est possible qu'Entra ID ait émis un jeton v1, ou que l'ID du locataire ou l'ID du client ne corresponde pas. Demandez à votre administrateur de vérifier que |
Le client IA reçoit |
Veuillez vous reconnecter pour obtenir un nouveau jeton. Si l'erreur persiste, demandez à votre administrateur de confirmer que le client AI demande le `power_users`scope et que l'audience du jeton est l'Application (client) ID de l'application AI Data Engine. |
Le client AI ne répertorie aucun outil, ou le balisage est refusé. |
Demandez à votre administrateur de confirmer que vous détenez le rôle d’application |
Le client IA signale une erreur TLS ou de connexion. |
Vérifiez que votre appareil résout le nom de l'hôte du cluster AIDE et qu'il fait confiance au certificat présenté par l'hôte. Si le certificat est auto-signé, installez-le comme certificat de confiance sur votre appareil. Consultez "Rendre l'hôte accessible depuis les machines clientes". |