1. Accedere a Google Cloud Console tramite interfaccia browser;
2. Fare clic sul nome del progetto attuale per accedere al selettore di progetti;
3. Selezionare "Nuovo progetto" e fornire un nome descrittivo (ad esempio, "docs mcp");
4. Attendere la creazione del progetto e passare al nuovo progetto.

1. Google Docs API: navigare su API e servizi → Libreria, cercare "Google Docs API" e abilitare;
2. Google Drive API: abilitare allo stesso modo Google Drive API per le funzionalità di gestione dei file.

Queste API forniscono accesso completo all'ecosistema documentale di Google, consentendo operazioni di lettura, scrittura, creazione, modifica ed eliminazione sia su Docs che su Drive.

1. Accedere alla scheda "Credenziali";
2. Se richiesto, fare clic su "Configura schermata di consenso";
3. Fare clic su "Inizia";
4. Inserire il nome dell'applicazione (ad esempio, "gmail agent");
5. Inserire il proprio indirizzo email;
6. Selezionare "Pubblico" come tipo di utente, se si utilizza un account Gmail generico;
7. Reinserire l'indirizzo email quando richiesto;
8. Accettare la politica sui dati utente;
9. Fare clic su Continua e Crea.

• Fare clic su "Crea client OAuth";
• Selezionare "Desktop App" per agenti AI locali e script;
• Accettare il nome suggerito o personalizzare secondo necessità;
• Scaricare il file JSON e salvarlo come credentials.json nella directory del progetto;
• Ora è necessario spostare il file delle credenziali nella cartella dell'agente AI (/MCP-Google-Doc). È possibile farlo manualmente trascinando l'icona del file nella cartella aperta nell'esplora file. Oppure utilizzare il Terminale/Prompt dei comandi e copiare il file con il comando cp path/to/file_name ., ad esempio:

cp ~/Desktop/credentials.json .

Il punto (.) alla fine specifica la directory corrente come destinazione;

• Confermare l'avvenuto trasferimento del file e rimuoverlo dalla posizione originale.

• Nella chat di Claude, incolla:

Clone this repo to the Documents/projects
https://github.com/ophydami/MCP-Google-Doc.git

• Esegui il comando. Il repository viene clonato nella stessa cartella degli altri server MCP.

• Nella chat di Claude, incolla:

run npm install

• Esegui il comando. Claude installa tutti i pacchetti richiesti.

• In Claude, incolla:

Move Desktop/credentials.json into project directory.

• Esegui il comando. Claude posiziona automaticamente il file OAuth all'interno del repository clonato.

• In Claude, incolla:

run npm run build and npm start

• Esegui. Claude esegue i comandi in modo coerente.

• Il browser si apre → autenticati con il tuo account Google:

  • Seleziona la stessa email utilizzata nella Google Cloud Console → clicca su Consenti;
  • Chiudi la scheda dopo aver visualizzato "Autenticazione riuscita".

• In Claude, incolla:

Add this block to the Claude config file
{
  "mcpServers": {
    "googledocs": {
      "command": "node",
      "args": ["/absolute/path/to/build/server.js"]
    }
  }
}

• Esegui il prompt.

• Apri le Impostazioni di Claude (Mac: Cmd + ,; Windows: Ctrl + ,);
• Vai su Sviluppatore → Modifica Configurazione;
• Conferma che il nuovo blocco sia stato aggiunto (sia dopo un altro server Google MCP che alla fine). Entrambe le opzioni sono corrette.

• Esci completamente da Claude Desktop. (Mac: Cmd + Q; Windows: Alt + F4);
• Riapri Claude per completare l'avvio dell'MCP.

• Navigare nella directory designata per l'archiviazione degli agenti AI

cd Documents/projects

• Scaricare ed entrare nel repository Google Docs MCP

git clone https://github.com/ophydami/MCP-Google-Doc.git
cd MCP-Google-Doc

• Scaricare tutti i pacchetti e le dipendenze richieste

npm install

Ottimizzazione del codice, minimizzazione dei file e creazione dei bundle pronti per la produzione

npm run build

Avvio del server di autenticazione e inizio del flusso OAuth

npm start

Accesso alle Impostazioni

• Aprire le impostazioni di Claude Desktop (Cmd+, o Ctrl+,);
• Navigare alla scheda Sviluppatore;
• Selezionare "Modifica Configurazione" per accedere al file di configurazione.

Integrazione della Configurazione

• Aggiungere una virgola dopo i blocchi di configurazione esistenti;
• Inserire il blocco di configurazione Google Docs MCP

    "googledocs": {
      "command": "node",
      "args": [
        "/path/to/build/server.js"
      ]
    }

• Aggiornare le informazioni sul percorso utilizzando l'output del comando pwd nel Terminale/Prompt dei comandi;
• Salvare il file di configurazione e riavviare Claude Desktop.