Come collegare Egnyte a Gemini via MCP

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

Egnyte + Gemini

Fai lavorare la tua AI con i tuoi file Egnyte: sfoglia le cartelle, leggi dettagli, versioni e piccoli file di testo, cerca per nome e contenuto, elenca i link di condivisione e creane di nuovi dopo la tua conferma, leggi i permessi delle cartelle e le attività recenti sui file. Chiave API interna dal tuo amministratore Egnyte.

Prerequisiti

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

EGNYTE_DOMAIN, EGNYTE_CLIENT_ID, EGNYTE_CLIENT_SECRET, EGNYTE_USERNAME, EGNYTE_PASSWORD

Step 1 — Ottieni le credenziali

Ti serve un piano Egnyte con accesso API (non una prova, né un piano Team o un vecchio piano Office) e un amministratore Egnyte che crei la chiave API. Egnyte esamina ogni nuova chiave prima che funzioni, e può volerci qualche giorno: conviene partire subito con il passo 1.

1. Come amministratore Egnyte apri Settings → Apps & Integrations e fai clic sul riquadro Create API Key (oppure registrati su developers.egnyte.com). Crea una chiave di tipo Internal Application per la tua azienda e lascia vuoto il redirect URI.
2. Copia la Key in EGNYTE_CLIENT_ID e il Secret in EGNYTE_CLIENT_SECRET.
3. Inserisci il tuo dominio Egnyte in EGNYTE_DOMAIN: la prima parte del tuo indirizzo, quindi acme per https://acme.egnyte.com.
4. Inserisci nome utente e password dell'utente Egnyte per conto del quale lavora il connettore in EGNYTE_USERNAME e EGNYTE_PASSWORD. La password viene inviata solo al tuo dominio Egnyte per ottenere un token di accesso.
5. Attendi che la chiave risulti Active, installa il connettore ed esegui egnyte_get_user_info: mostra con quale utente lavora l'AI.

Usa un utente dedicato: l'AI vede esattamente ciò che vede questo utente in Egnyte, niente di più. La scelta più sicura è un utente che ha solo le cartelle che servono all'AI. Se la tua azienda accede a Egnyte solo tramite single sign-on, scegli un utente che abbia anche una password Egnyte. AnythingMCP ottiene un token con queste credenziali e ne chiede uno nuovo quando scade, dopo 30 giorni.

Cosa legge: le cartelle aziendali sotto /Shared e quelle private sotto /Private; i dettagli di file e cartelle come dimensione, ultima modifica, autore del caricamento e stato di blocco; la cronologia delle versioni di un file; la ricerca per nome, contenuto o commenti; l'inizio dei file di testo come txt, csv, md, json, xml o html (fino a circa 100 KB, anche delle versioni precedenti); i link di condivisione; chi ha quale permesso su una cartella e il permesso effettivo di una persona tenendo conto di gruppi ed ereditarietà; e le attività recenti sui file del dominio (creazioni, eliminazioni, spostamenti, copie, modifiche ai permessi), che Egnyte conserva per 30 giorni.

PDF e file Office: il connettore legge solo testo semplice. Un PDF, un file Word o Excel l'AI lo trova, te lo descrive e ti dà un link di condivisione, ma non ne legge il contenuto.

I link di condivisione chiedono prima: prima che egnyte_create_link crei un link, l'AI ti mostra il file o la cartella, chi potrà aprirlo (chiunque abbia il link, con password, gli utenti collegati al tuo Egnyte o solo destinatari indicati) e la scadenza, e aspetta il tuo sì. Se le chiedi di inviare il link per e-mail, ti indica anche i destinatari.

Disattivato all'installazione: egnyte_delete_item. Un amministratore lo attiva consapevolmente; gli elementi eliminati finiscono poi nel cestino di Egnyte, e l'AI elimina solo dopo che hai confermato il percorso. Nessun altro tool modifica o elimina file.

Percorsi: percorsi completi che iniziano con /Shared o /Private, con distinzione tra maiuscole e minuscole. I termini di ricerca richiedono da 3 a 100 caratteri e i risultati arrivano 20 alla volta.

Limiti di richieste: a seconda del piano, 2 richieste al secondo e da 1.000 a 4.000 al giorno per chiave. Oltre il limite Egnyte risponde 403 o 429 (Developer Over Rate); aspetta e riprova più tardi.

Errori comuni: un accesso rifiutato indica nome utente, password, chiave o secret errati, oppure una chiave ancora in attesa di approvazione. 401 Invalid Access Token: il token è stato revocato, per esempio dopo un cambio di password. 403: nessun permesso su quel percorso, oppure il limite è esaurito. 404: il percorso non esiste; controlla maiuscole e minuscole di ogni nome.

Il connettore non carica né modifica file, non crea né sposta cartelle, non blocca file, non scrive commenti o metadati, non gestisce utenti e gruppi e non avvia workflow Egnyte né Egnyte AI.

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 Gemini

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.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di Egnyte.

Tool disponibili

Esempi di prompt

• "Trova il listino prezzi più recente nel nostro Egnyte e dimmi chi l'ha caricato e quando."
• "Cosa è cambiato questa settimana in /Shared/Projects/Acme, e chi ha fatto le modifiche?"
• "Chi ha accesso a /Shared/Finance, e Anna ha i permessi di Editor lì?"
• "Mostrami le versioni precedenti del CSV con il budget del terzo trimestre e riassumi cosa è cambiato nell'ultima."
• "Crea un link di condivisione a /Shared/Marketing/Brochure 2026.pdf che possano aprire solo le persone della nostra azienda, valido 14 giorni. Mostrami prima le impostazioni."

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT