Verbindung von KI-Clients mit dem AI Data Engine MCP Server
Die Verbindung von Claude Code, Claude Desktop, Cursor oder OpenCode mit dem Model Context Protocol (MCP)-Server für AI Data Engine (AIDE) ermöglicht es Ihnen, Dateimetadaten zu durchsuchen und Dateien in den Sammlungen, auf die Sie Zugriff haben, zu taggen.
Bevor Sie beginnen
-
Ein Administrator hat die Einrichtung in "Konfiguration von Microsoft Entra ID für den kontrollierten KI-Zugriff" und "AI Data Engine mit Microsoft Entra ID verbinden" abgeschlossen, einschließlich folgender Punkte:
-
Zuweisung der
AIDE Power UsersApp-Rolle an Sie. -
Konfigurieren einer Sammlung für MCP mit einem Bereich, der Sie umfasst. Informationen finden Sie unter "Konfiguration einer Sammlung für MCP".
-
Das Einschalten von Verbindung zu MCP aktivieren in den MCP-Einstellungen. Wenn die Verbindung deaktiviert ist, können KI-Clients keine Verbindung zu irgendeiner Sammlung herstellen.
-
Das Hinzufügen der Umleitungs-URI für Ihren AI Client zur AI Data Engine Applikation und das Zulassen öffentlicher Client-Flows. Der AI Client meldet sich als öffentlicher Client an, daher benötigen Sie kein Client-Geheimnis.
-
-
Sie haben die MCP Clientkonfiguration von Ihrem Administrator erhalten. Der Administrator generiert sie in NetApp Console, indem er die Sammlung für MCP konfiguriert, die MCP Server URL oder das clientspezifische Snippet aus dem Schritt Generate MCP code snippet kopiert und es mit Ihnen teilt. Sie umfasst Folgendes:
-
Die MCP Server-URL im Format
https://<mcp-server-host>/mcp/tools. -
Die Mandanten-ID von Microsoft Entra ID.
-
Die Client-ID, also die Anwendungs-ID (Client-ID) der AI Data Engine Applikation in Entra ID.
-
Die vom KI-Client angeforderten Berechtigungen:
-
https://<mcp-server-host>/mcp/tools/power_users, also die Applikations-ID-URI plus/power_users. -
offline_access, damit der Client die Token aktualisieren kann, ohne dass Sie sich erneut anmelden müssen.
-
-
Die ID der Sammlung, mit der Sie arbeiten möchten.
-
-
Ihr Gerät kann den MCP-Server über HTTPS auf Port 443 erreichen. Da sich der MCP-Server in Ihrem Netzwerk befindet, sollte die Verbindung über Ihr Firmennetzwerk oder über VPN erfolgen. Ihr Gerät muss außerdem Folgendes können:
-
Die DNS-Auflösung des AIDE Cluster-Hostnamens ist erforderlich.
-
Dem vom Host vorgelegten Zertifikat ist zu vertrauen. Handelt es sich um ein selbstsigniertes Zertifikat, ist dessen Installation als vertrauenswürdiges Zertifikat auf Ihrem Gerät erforderlich.
-
Auf die Microsoft Entra ID-Anmeldung zugreifen (
login.microsoftonline.com).
-
-
Sie verwenden eine unterstützte Version des KI-Clients.
Validierte KI-Clients
Die Anweisungen auf dieser Seite beziehen sich auf die KI-Clients, die NetApp validiert hat: Claude Code, Claude Desktop, Cursor und OpenCode. Einzelheiten sind unter "Validierte KI-Clients" zu finden.
KI-Clients, die sich über den Dienst eines Cloud-Anbieters mit Ihrem Netzwerk verbinden, werden nicht unterstützt. Beispielsweise können benutzerdefinierte Konnektoren, die in einen KI-Client integriert und von der Cloud des Anbieters aufgerufen werden, den MCP-Server in Ihrem Netzwerk nicht erreichen. Stattdessen erfolgt die Konfiguration über die Schritte auf dieser Seite.
Vor dem Einfügen sollten Sie Ihre Konfiguration überprüfen
Vor dem Einfügen eines Codeausschnitts in Ihren KI-Client sollte Folgendes bestätigt sein:
-
Der Host ist der Hostname Ihres AIDE Clusters, nicht die IP-Adresse eines Clusters oder Dienstes.
-
Die URL endet auf
/mcp/toolsund enthält diecollection_idder Sammlung, mit der Sie arbeiten möchten. -
Der Gültigkeitsbereich ist
https://<mcp-server-host>/mcp/tools/power_users, also die Application ID URI plus/power_users. -
Die Client-ID ist die Anwendungs-ID (Client-ID) der AI Data Engine Applikation in Entra ID.
Verbindung mit Claude Desktop
|
|
Das Generieren von Verbindungsdetails in der NetApp Console verbindet Ihren AI Client nicht und validiert ihn auch nicht. Die Durchführung dieser Aufgaben erfolgt im AI Client. |
Claude Desktop stellt über mcp-remote, ein kleines Hilfsprogramm, das auf Ihrem Computer läuft, eine Verbindung zum AI Data Engine MCP-Server her.
Die Installation von Node.js auf Ihrem Computer ist erforderlich. Das mcp-remote Hilfsprogramm läuft mit Node.js.
-
In Claude Desktop ist die Konfigurationsdatei
claude_desktop_config.jsonzu öffnen. Standardmäßig befindet sich die Datei an einem der folgenden Speicherorte:-
macOS:
~/Library/Application Support/Claude/claude_desktop_config.json -
Windows:
%APPDATA%\Claude\claude_desktop_config.json
-
-
Sie können den AI Data Engine MCP Server unter
mcpServershinzufügen. Die Platzhalter werden durch die Werte Ihrer Administratorin bzw. Ihres Administrators ersetzt:{ "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" ] } } }Das --disable-resource-parameterArgument bleibt erhalten. Ohne dieses lehnt Microsoft Entra ID die Anmeldeanfrage mit dem FehlerAADSTS9010010ab. -
Die Datei sollte gespeichert und Claude Desktop neu gestartet werden.
-
Nach dem Öffnen des Browsers erfolgt die Anmeldung mit Ihrem Microsoft Entra ID-Konto, und eine gegebenenfalls angezeigte Zustimmungsaufforderung ist zu bestätigen.
-
In Claude Desktop kann unter Connectors bestätigt werden, dass der AI Data Engine Server mit seinen Tools aufgeführt ist.
Claude Code verbinden
Claude Code stellt eine direkte Verbindung zum AI Data Engine MCP Server her.
-
Der AI Data Engine MCP server wird hinzugefügt. Die Platzhalter werden durch die Werte Ihres Administrators ersetzt:
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>"Es wird nicht übergeben --client-secret. Die Client Applikation ist ein öffentlicher Client. -
Zum Anfordern der AI Data Engine Bereiche wird die Claude Code Konfigurationsdatei geöffnet und der
netapp-ai-data-engine`Eintrag bearbeitet. Benutzerbezogene Einträge befinden sich in `~/.claude.json. Projektbezogene Einträge befinden sich in.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" } } } } -
In Claude Code können Sie
/mcpausführen und sich mit Ihrem Microsoft Entra ID Konto anmelden. Alternativ können Sieclaude mcp login netapp-ai-data-enginein einer Shell ausführen. -
Nach dem Ausführen
claude mcp listwird der AI Data Engine Server als verbunden angezeigt.
Cursor verbinden
Cursor stellt direkt eine Verbindung zum AI Data Engine MCP server her.
-
In Cursor die MCP Konfigurationsdatei
mcp.jsonöffnen. Für die Verwendung des Servers in allen Ihren Projekten~/.cursor/mcp.jsonöffnen. Für die Verwendung nur im aktuellen Projekt.cursor/mcp.jsonöffnen. -
Der AI Data Engine MCP server wird hinzugefügt. Die Platzhalter werden durch die Werte Ihres Administrators ersetzt:
{ "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" ] } } } }In diese Datei gehört kein Bearer-Token. Cursor verwendet die Client-ID für die Anmeldung. -
Die Datei wird gespeichert, anschließend wird Cursor neu geladen.
-
Unter Cursor Settings > MCP erfolgt für den AI Data Engine Server die Auswahl von Connect.
-
Nach dem Öffnen des Browsers erfolgt die Anmeldung mit Ihrem Microsoft Entra ID-Konto, und eine gegebenenfalls angezeigte Zustimmungsaufforderung ist zu bestätigen.
-
Unter Cursor Settings > MCP sollte bestätigt werden, dass der AI Data Engine Server aktiviert ist und dass seine Tools aufgelistet sind. Ist dies nicht der Fall, empfiehlt sich eine Prüfung von Output > MCP Logs.
Verbindung mit OpenCode
OpenCode stellt direkt eine Verbindung zum AI Data Engine MCP server her.
-
Der AI Data Engine MCP server wird hinzugefügt. Die Platzhalter werden durch die Werte Ihres Administrators ersetzt:
opencode mcp add netapp-ai-data-engine --global --url "https://<mcp-server-host>/mcp/tools?collection_id=<collection-id>" -
Zum Hinzufügen Ihrer Client-Applikation können Sie in Ihrem Projekt
~/.config/opencode/opencode.jsonoder die Dateiopencode.jsonöffnen und den Eintragnetapp-ai-data-enginebearbeiten:{ "$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" } } } } }Der Wert darf nicht oauthauffalsegesetzt werden, und dieser Datei darf kein Client-Secret hinzugefügt werden. -
In OpenCode wird
/mcpsder AI Data Engine Server ausgewählt, und nach dem Öffnen des Browsers erfolgt die Anmeldung mit Ihrem Microsoft Entra ID-Konto. -
Nach dem Ausführen
opencode mcp listsollte der AI Data Engine Server als verbunden angezeigt werden.Der Status
needs authenticationbedeutet, dass OpenCode die Konfiguration gespeichert hat, Sie die Anmeldung jedoch noch nicht abgeschlossen haben.
Was Sie tun können
Nach der Verbindung kann Ihr AI Client fünf Tools verwenden: get_collection, search, list_tags, create_tag und tag_document. Eine Verbindung ist auf die Sammlung in der MCP server URL beschränkt. Für die Arbeit mit einer anderen Sammlung verwenden Sie die Verbindungsdetails für diese Sammlung. Informationen zur Funktion der einzelnen Tools finden Sie unter "MCP tools für den von AI Data Engine gesteuerten KI-Zugriff".
Die Tools sind in einer Power-User-Sitzung verfügbar, für die die AIDEPowerUsers App-Rolle und der power_users Scope erforderlich sind.
|
|
Für die Suche in allen gescannten Systemen und Volumes dienen die Verbindungsdetails der Sammlung Alle Dateien. |
Ihr KI-Client kann keine Dateiinhalte abrufen, Dateien hinzufügen, löschen oder ändern, Datenquellen ändern oder Sammlungen erstellen.
Tags gelten für die gesamte AI Data Engine, nicht nur für eine einzelne Sammlung. Ein falsch geschriebener Tag-Name erzeugt einen neuen Tag, und bei Tag-Namen wird zwischen Groß- und Kleinschreibung unterschieden. Beispielsweise sind Finance und finance unterschiedliche Tags. Ein Tag lässt sich nach der Erstellung nicht umbenennen. Einschränkungen für Tag-Namen sind in "Bekannte Einschränkungen" beschrieben.
Beispiel-Eingabeaufforderungen
Für die Platzhalter sind Werte aus Ihrer Umgebung einzusetzen.
Metadaten durchsuchen
-
"Die Datensammlungen auflisten, die ich durchsuchen kann."
-
"In der <collection name> Sammlung alle PDF-Dateien suchen."
-
"In der <collection name> Sammlung lassen sich Dateien finden, deren Namen mit
<prefix>beginnen." -
"In der <collection name> Sammlung werden Dateien aufgelistet, die <owner> gehören."
-
„Wie viele <file type> Dateien sind in der <collection name> Sammlung?“
-
"Der Pfad, die Größe und das Datum der letzten Änderung der Dateien mit dem Namen
<prefix>in der Sammlung <collection name>."
|
|
Suchfilter für Dateinamenpräfix, Dateityp und Eigentümer. Wenn Dateien nach Größe, Datum oder Ordner angefordert werden, muss der AI Client viele Ergebnisse seitenweise durchlaufen, und die Antwort ist möglicherweise unvollständig. |
Tag-Dateien
-
„Die verwendeten Tags und die Anzahl der Dateien mit jedem Tag auflisten.“
-
"Das Tag <tag name> erstellen und auf <file name> anwenden."
-
"Das Tag <tag name> auf die Dateien aus meiner letzten Suche anwenden."
-
"Tag <tag name> aus <file name> in der <collection name> Sammlung entfernen."
Behebung von Verbindungsproblemen
| Problem | Auflösung |
|---|---|
Die Browseranmeldung schlägt mit dem Fehler |
Ihr Administrator muss die im Fehler angegebene genaue Umleitungs-URI in den Einstellungen für Authentication unter Mobile and desktop applications der AI Data Engine Applikation in Entra ID hinzufügen. Der Port in Ihrer Client Konfiguration muss mit der registrierten URI übereinstimmen. |
Die Anmeldung schlägt mit dem Fehler |
Die Zustimmung wurde nicht erteilt, oder der Client ist nicht autorisiert. Der Administrator muss die Zustimmung erteilen oder die Application (client) ID als autorisierte Client-Applikation für den `power_users`Bereich hinzufügen. |
Die Anmeldung schlägt mit dem Fehler |
Die Bereichszeichenfolge stimmt nicht überein. Erforderlich ist exakt die Application ID URI plus |
Claude Code oder OpenCode zeigt |
Nach der Anmeldung wird in Claude Code |
Die Anmeldung bei Claude Desktop schlägt mit dem Fehler |
Stellen Sie sicher, dass die |
Der AI Client empfängt |
Entra ID hat möglicherweise ein v1-Token ausgestellt, oder die Mandanten-ID bzw. Client-ID stimmt nicht überein. Ihr Administrator sollte bestätigen, dass |
Der AI Client empfängt |
Für ein neues Token ist eine erneute Anmeldung erforderlich. Falls der Fehler weiterhin auftritt, sollte Ihr Administrator bestätigen, dass der AI Client den `power_users`Scope anfordert und dass die Token-Zielgruppe die Applikations-ID (Client-ID) der AI Data Engine Applikation ist. |
Der AI Client listet keine Tools auf, oder das Tagging wird verweigert. |
Ihr Administrator sollte bestätigen, dass Sie über die |
Der AI Client meldet einen TLS- oder Verbindungsfehler. |
Ihr Gerät muss den AIDE Cluster-Hostnamen auflösen und dem Zertifikat vertrauen, das der Host vorlegt. Ein selbstsigniertes Zertifikat ist auf Ihrem Gerät als vertrauenswürdiges Zertifikat zu installieren. Weitere Informationen enthält "Sicherstellen, dass der Host von Client-Rechnern aus erreichbar ist". |