• Nella chat di Claude, incollare:

Install the latest stable Python version, uvx, and pip packages.

• Eseguire il comando. Claude verifica e aggiorna automaticamente le dipendenze.

Verifica della presenza di Python

• Nel Terminale o nella riga di comando, eseguire:

python3 --version

• Se viene visualizzato un messaggio con la versione 3.10 o successiva, procedere al passaggio successivo;
• Se invece compare un messaggio di errore o una versione precedente alla 3.10, seguire queste istruzioni.

Metodo 1: Download diretto

• Visitare la pagina di download;
• Scaricare Python 3.10 o versione successiva per il proprio sistema operativo;
• Avviare l’installatore e assicurarsi che "Add Python to PATH" sia selezionato;
• Verificare l’installazione con python --version.

Metodo 2: Installazione da riga di comando

Nel Terminale o nella riga di comando, eseguire:

• Mac con Homebrew:

brew install python

• Windows:

winget install Python.Python.3.12

• Ubuntu/Debian:

sudo apt update && sudo apt install python3

Per utenti che desiderano una configurazione rapida, Smithery offre l'installazione automatica.

• In Claude Desktop, aprire una chat.
• Copiare il prompt:

run npx -y @smithery/cli install @GongRzhe/Office-Word-MCP-Server --client claude

• Incollare ed eseguire il prompt;
• Aprire il file di configurazione di Claude → confermare che sia stato aggiunto un nuovo blocco per Microsoft Word MCP;
• Uscire completamente da Claude (Mac: Cmd + Q, Windows: Alt + F4). Riavviare Claude;
• In caso di problemi, procedere con Installazione Base.

1. Clonare il repository

• Copiare il prompt e incollarlo in Claude:

Clone https://github.com/GongRzhe/Office-Word-MCP-Server.git
into the Documents/projects

• Eseguire il prompt. Claude clona il repository.

2. Installare i requisiti

• Copiare il prompt e incollarlo in Claude:

Install requirements

• Eseguire. Claude installa le dipendenze necessarie.

3. Aggiornare la configurazione

• In Claude, copiare e incollare:

Remove the previous Office Word MCP block and put this instead
{
  "mcpServers": {
    "word-document-server": {
      "command": "python3",
      "args": ["/path/to/word_mcp_server.py"]
    }
  }
}

• Eseguire il prompt;
• Verificare il file di configurazione → blocco precedente rimosso, nuovo blocco aggiunto.

4. Riavviare Claude

• Uscire completamente da Claude (Mac: Cmd + Q, Windows: Alt + F4);
• Riavviare Claude.

Per utenti che desiderano una configurazione rapida, Smithery offre l'installazione automatica:

npx -y @smithery/cli install @GongRzhe/Office-Word-MCP-Server --client claude

Riavviare Claude

• Uscire completamente da Claude (Mac: Cmd + Q, Windows: Alt + F4);
• Riavviare Claude.

Quando l'installazione automatica presenta problemi o per utenti che richiedono il pieno controllo della configurazione, la configurazione manuale garantisce un'implementazione affidabile.

Clonazione del repository

• In Terminale o Command line, navigare nella directory con i server MCP

cd Documents/projects

• Clonare il repository GitHub con Office Word MCP Server

git clone https://github.com/GongRzhe/Office-Word-MCP-Server.git

• Entrare in questa directory

cd Office-Word-MCP-Server

• Installare tutte le librerie Python richieste e le dipendenze

pip install -r requirements.txt

• Avviare una configurazione dell'agente

python3 setup_ai_agent.py

• Scegliere il primo percorso di configurazione suggerito quando richiesto. Il sistema confermerà l'integrazione avvenuta con successo nel file di configurazione di Claude Desktop;
• Dopo l'installazione, è richiesto un riavvio completo di Claude Desktop per il corretto riconoscimento dell'agente.

Se l'agente non compare in Search & Tools:

• Accesso alla configurazione: utilizzare Command+, (Mac) o Ctrl+, (Windows) per aprire Settings;
• Pannello sviluppatore: accedere al pannello Sviluppatore e selezionare "Modifica Config";
• Integrazione parametri: copiare i parametri di configurazione:

    "word-document-server": {
      "command": "python3",
      "args": ["/path/to/word_mcp_server.py"]
    }

• Configurazione percorso: utilizzare il comando pwd nel Terminale per ottenere il percorso assoluto della directory;
• Gestione file: inserire il percorso prima delle parentesi graffe di chiusura della configurazione e salvare con Command+S o Ctrl+S;
• È richiesto un riavvio completo di Claude Desktop per il corretto riconoscimento dell'agente;
• Verificare che l'agente Word AI compaia in Search & Tools. Per test ottimali, disabilitare temporaneamente altri agenti come Desktop Commander per isolare la funzionalità.