Rubrik MCP: collegare a Microsoft Copilot

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Rubrik Security Cloud, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Rubrik Security Cloud + Microsoft Copilot

Fai controllare alla tua AI i backup Rubrik: stato e capacità dei cluster, SLA Domain, oggetti protetti e conformità SLA, snapshot, job falliti e report dei task, risultati del rilevamento anomalie e dei threat hunt. GraphQL in sola lettura con un service account.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

RUBRIK_ACCOUNT, RUBRIK_CLIENT_ID, RUBRIK_CLIENT_SECRET

Step 1 — Ottieni le credenziali

La configurazione richiede circa 5 minuti. Ti servono un account Rubrik Security Cloud (RSC) e l'accesso a Settings, Users and Access in RSC per creare un service account.

1. In RSC apri Settings, Users and Access, Service Accounts e aggiungi un service account. Assegnagli un ruolo che possa vedere ciò che l'AI deve vedere: basta un ruolo personalizzato in sola lettura con permessi di visualizzazione su cluster, SLA Domain, oggetti, eventi e threat analytics.
2. Scarica il JSON del service account. Contiene client_id (inizia con client|), client_secret e access_token_uri (https://<account>.my.rubrik.com/api/client_token).
3. Imposta RUBRIK_ACCOUNT sul nome del tuo account: la parte prima di .my.rubrik.com nel tuo indirizzo RSC e in access_token_uri, in minuscolo e senza https://, per esempio acme per acme.my.rubrik.com.
4. Copia client_id in RUBRIK_CLIENT_ID e client_secret in RUBRIK_CLIENT_SECRET.
5. Installa il connettore e verifica la connessione con rubrik_get_account: restituisce l'id dell'account e la versione del deployment RSC.

Cloud e self-hosting funzionano allo stesso modo: il connettore chiama la GraphQL API del tuo account su https://<account>.my.rubrik.com/api/graphql con lo stesso service account; non c'è nessun redirect URL da registrare.

I token si rinnovano da soli: il connettore scambia client id e secret su https://<account>.my.rubrik.com/api/client_token (grant client credentials) con un token di accesso e lo invia come Authorization: Bearer. Il token dura 12 ore per impostazione predefinita (fino a 24 ore nelle impostazioni di sessione di RSC) e si rinnova prima della scadenza e dopo un 401.

Conserva il secret: RSC mostra client_secret una sola volta. Se lo perdi, crea un nuovo service account e inserisci i suoi valori.

Il ruolo decide cosa vede l'AI: l'AI vede solo ciò che il ruolo del service account può visualizzare. Un permesso di visualizzazione mancante si presenta come un 403.

Id, orari e paginazione: i cluster sono UUID. Un oggetto protetto ha un id, che usa rubrik_list_snapshots, e un fid, che usano i filtri di eventi e anomalie. Gli orari sono ISO 8601 in UTC. Le liste accettano first (predefinito 25, al massimo 200) e after: richiama con after uguale a pageInfo.endCursor finché pageInfo.hasNextPage è true; count è il totale.

Tool GraphQL generici: rubrik_graphql_schema_url restituisce l'indirizzo dello schema, rubrik_graphql_schema legge una porzione dello schema pubblico di RSC che Rubrik pubblica nel repository del suo PowerShell SDK, e rubrik_graphql_query esegue qualsiasi altra query di lettura. Lo schema pubblicato può essere qualche giorno più recente o più vecchio del deployment del tuo account (rubrik_get_account ne mostra la versione).

Errori frequenti: un 400 sulla richiesta del token vuol dire che RUBRIK_CLIENT_ID non è il client_id del JSON (inizia con client|) oppure che il secret appartiene a un altro service account. Un 401 vuol dire che RSC ha rifiutato il service account: copia di nuovo entrambi i valori, o crea un nuovo service account se il secret è andato perso o è stato ruotato. Un 403 vuol dire che il service account ha effettuato l'accesso ma il suo ruolo non può leggere quei dati. Nessuna risposta vuol dire che RUBRIK_ACCOUNT è sbagliato: prendi il nome dal tuo indirizzo RSC o da access_token_uri.

Cosa legge: id dell'account e versione del deployment; cluster con stato di connessione, salute, versione, capacità in byte, runway stimata e data di fine supporto; SLA Domain con pianificazione degli snapshot, retention, retention lock e numero di oggetti protetti; oggetti protetti (VM, database, fileset, oggetti cloud e SaaS) con stato di protezione e di conformità SLA, ultimo snapshot, snapshot mancati e dimensioni; conteggi di conformità per stato, tipo di oggetto, cluster o SLA Domain; gli snapshot di un oggetto con data di scadenza e indicatori di anomalia, quarantena e retention lock; attività (backup, archiviazione, replica, ripristini) con stato, causa dell'errore e rimedio, e la cronologia di una singola serie; il report Task Details con durate e byte trasferiti; risultati del rilevamento anomalie per snapshot con i file creati, modificati, eliminati e segnalati come sospetti; threat hunt e i loro risultati per oggetto, con l'ultimo snapshot pulito.

Disattivati all'installazione: rubrik_graphql_mutation e rubrik_graphql_subscription. Eseguono qualsiasi mutation o subscription GraphQL; una mutation può avviare backup e ripristini o eliminare dati, quindi attivala solo di proposito. Attiva nella pagina del connettore solo quelli che ti servono; l'AI ti chiede conferma prima di ogni modifica. Tutti gli altri tool sono in sola lettura.

Limiti: i tool di lettura non eseguono backup, non avviano ripristini, non assegnano SLA Domain e non mettono nulla in quarantena; non c'è una ricerca di file dentro gli snapshot, e le REST API dei cluster Rubrik CDM non sono coperte.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Microsoft Copilot

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.

1. In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
2. Inserisci un Server name (per esempio AnythingMCP), una Server description che dica cosa fa il connettore e il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server.
3. Come autenticazione scegli API key, imposta Type su Header e come nome dell'header X-API-Key, poi seleziona Create.
4. In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
5. Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di Rubrik Security Cloud.
6. Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.

Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.

Tool disponibili

Esempi di prompt

• "Tutti i miei cluster Rubrik sono connessi e in salute? Quanta capacità e runway resta a ciascuno?"
• "Quanti oggetti sono fuori conformità SLA, e quali sono?"
• "Quali job di backup sono falliti nelle ultime 24 ore, e qual è stata la causa di ciascuno?"
• "Quali punti di ripristino ha la VM sql-prod-01 negli ultimi 7 giorni?"
• "Il rilevamento anomalie ha segnalato snapshot questa settimana, e quali threat hunt hanno trovato corrispondenze?"

FAQ

Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.

Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.

L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.

Prossimi passi

• Landing del connettore
• Collegare a Claude