Inizia a utilizzare il server MCP di docs.netapp.com
Collega il tuo ambiente di sviluppo AI al server Model Context Protocol (MCP) di docs.netapp.com. Dopo aver configurato il server MCP, puoi usarlo per ottenere risposte basate sulla documentazione tecnica del prodotto pubblicata su docs.netapp.com.
Prerequisiti
Prima di configurare il server MCP docs.netapp.com, verifica quanto segue:
-
Hai esaminato i requisiti e le limitazioni in "Scopri il server MCP di docs.netapp.com".
-
Hai accesso a un client compatibile con MCP supportato, come Visual Studio Code con GitHub Copilot, Claude Desktop, Cursor o framework per agenti basati su Python.
-
Devi avere una chiave di sottoscrizione valida. Se non fornisci una chiave, le richieste MCP non vanno a buon fine e restituiscono un errore di accesso. Per richiedere una chiave di sottoscrizione, contatta ng-docs-mcp@netapp.com con una breve descrizione del tuo caso d'uso.
-
Hai accesso di rete all'endpoint MCP docs.netapp.com:
https://docs.netapp.com/mcp.
Configura il tuo ambiente di sviluppo
Scegli l'opzione di configurazione per il tuo ambiente.
Configurazione di Visual Studio Code
Puoi connetterti al server MCP da Visual Studio Code usando GitHub Copilot configurando un mcp.json file.
-
Questo task richiede Visual Studio Code con l'estensione GitHub Copilot abilitata.
-
Dalla tua area di lavoro del progetto in Visual Studio Code, completa quanto segue:
-
Crea una cartella denominata
.vscode -
Crea un file all'interno della cartella chiamato
mcp.json
-
-
Configura il file
mcp.json.{ "servers": { "netapp-docs-mcp": { "type": "http", "url": "https://docs.netapp.com/mcp", "headers": { "Ocp-Apim-Subscription-Key": "${input:Ocp-Apim-Subscription-Key}" } } }, "inputs": [ { "type": "promptString", "id": "Ocp-Apim-Subscription-Key", "description": "Enter your access key", "password": true } ] } -
Salva il file.
-
Facoltativamente, puoi configurare l'accesso globale.
Per configurare il server MCP docs.netapp.com in tutti i progetti e gli spazi di lavoro di Visual Studio Code, aggiungi la configurazione alla directory delle impostazioni utente globali.
-
Windows:
C:\Users\<your_username>\AppData\Roaming\Code\User\mcp.json -
macOS:
~/Library/Application Support/Code/User/mcp.jsonAggiungi la definizione del server:
{ "servers": { "netapp-docs-mcp": { "type": "http", "url": "https://docs.netapp.com/mcp", "headers": { "Ocp-Apim-Subscription-Key": "${input:Ocp-Apim-Subscription-Key}" } } }, "inputs": [ { "type": "promptString", "id": "Ocp-Apim-Subscription-Key", "description": "Enter your access key", "password": true } ] }+
Dopo aver modificato il file globale mcp.json, riavvia Visual Studio Code per applicare la configurazione. -
-
Verifica la configurazione.
-
Apri Visual Studio Code nella tua area di lavoro.
-
Conferma che il
.vscode/mcp.jsonfile sia presente. -
Fai una domanda usando Copilot.
EsempioQuali sono le differenze tra ONTAP e Cloud Volumes ONTAP?
-
Configurazione desktop di Claude
Per registrare il server MCP docs.netapp.com con Claude Desktop, aggiorna il file di configurazione:
-
macOS:
~/Library/Application Support/Claude/claude_desktop_config.json -
Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"netapp-docs-mcp": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://docs.netapp.com/mcp",
"--header",
"Ocp-Apim-Subscription-Key:${NETAPP_MCP_KEY}"
],
"env": {
"NETAPP_MCP_KEY": "paste-your-subscription-key-here"
}
}
}
}
Configurazione del cursore
Per registrare il server MCP docs.netapp.com con Cursor, aggiorna il file di configurazione.
Per applicare la configurazione a livello globale, usa i seguenti percorsi:
-
Mac OS:
~/.cursor/mcp.json -
Windows:
%USERPROFILE%\.cursor\mcp.json
Per applicare la configurazione a un singolo progetto, usa .cursor/mcp.json nella directory principale del progetto.
|
|
Se il file contiene già altri server MCP configurati, aggiungi netapp-docs-mcp all'interno dell'oggetto mcpServers esistente (assicurati di aggiungere una virgola dopo la voce precedente). Se non è presente la chiave mcpServers, aggiungila al livello superiore accanto a qualsiasi altra impostazione.
|
{
"mcpServers": {
"netapp-docs-mcp": {
"url": "https://docs.netapp.com/mcp",
"headers": {
"Ocp-Apim-Subscription-Key": "paste-your-subscription-key-here"
}
}
}
}
Integrazione di agenti AI in Python
Utilizza questa opzione se stai creando applicazioni o agenti di intelligenza artificiale che richiamano direttamente il server MCP.
Il tuo client si connette all'endpoint MCP e richiama gli strumenti.
client = MCPClient("https://docs.netapp.com/mcp",
headers={
"Ocp-Apim-Subscription-Key": "<YOUR_API_KEY>"
}
)
response = client.call_tool("netapp_docs_ask", {
"question": "What are ONTAP upgrade steps?"
})
Usa il server MCP docs.netapp.com
Dopo aver configurato il server MCP, puoi interagire con la documentazione tecnica di NetApp direttamente all'interno dell'interfaccia client che preferisci.
-
Il client AI sceglie uno strumento appropriato per fornire risultati in base alla tua query.
-
Usa domande chiare e complete invece di richieste brevi o vaghe.
-
Le risposte sono sempre tratte dalla documentazione ufficiale di NetApp.
-
Apri la chat sul client compatibile con MCP che preferisci.
-
Richiama il server MCP configurato e poni una domanda chiara sui prodotti NetApp o sulle procedure.
-
Esamina la risposta.