• No chat do Claude, cole:

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

• Execute o comando. O Claude verifica e atualiza as dependências automaticamente.

Verificação de Instalação do Python

• No Terminal ou Linha de Comando, execute:

python3 --version

• Se aparecer uma mensagem com a versão 3.10 ou superior, prossiga para o próximo passo de instalação;
• Caso apareça uma mensagem de erro ou uma versão anterior à 3.10, siga estas instruções.

Método 1: Download Direto

• Acesse a página de download;
• Baixe o Python 3.10 ou mais recente para o seu sistema operacional;
• Execute o instalador e certifique-se de marcar "Add Python to PATH";
• Verifique a instalação com python --version.

Método 2: Instalação via Linha de Comando

No Terminal ou Linha de Comando, execute:

• Mac com Homebrew:

brew install python

• Windows:

winget install Python.Python.3.12

• Ubuntu/Debian:

sudo apt update && sudo apt install python3

Para usuários que buscam uma configuração rápida, Smithery oferece instalação automatizada.

• No Claude Desktop, abra um chat.
• Copie o prompt:

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

• Cole e execute o prompt;
• Abra o arquivo de configuração do Claude → confirme se um novo bloco para o Microsoft Word MCP foi adicionado;
• Saia completamente do Claude (Mac: Cmd + Q, Windows: Alt + F4). Reinicie o Claude;
• Se surgirem problemas, prossiga com a Instalação Básica.

1. Clonar o Repositório

• Copie o prompt e cole no Claude:

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

• Execute o prompt. O Claude irá clonar o repositório.

2. Instalar Requisitos

• Copie o prompt e cole no Claude:

Install requirements

• Execute. O Claude instalará as dependências necessárias.

3. Atualizar Configuração

• No Claude, copie e cole:

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

• Execute o prompt;
• Verifique o arquivo de configuração → bloco antigo removido, novo bloco adicionado.

4. Reiniciar o Claude

• Saia completamente do Claude (Mac: Cmd + Q, Windows: Alt + F4);
• Reinicie o Claude.

Para usuários que buscam uma configuração rápida, Smithery oferece instalação automatizada:

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

Reiniciar o Claude

• Saia completamente do Claude (Mac: Cmd + Q, Windows: Alt + F4);
• Reinicie o Claude.

Quando a instalação automática apresentar problemas ou para usuários que necessitam de controle total da configuração, a configuração manual garante uma implantação confiável.

Clonagem do Repositório

• No Terminal ou Linha de Comando, navegue até o diretório com os servidores MCP

cd Documents/projects

• Clone o repositório do GitHub com Office Word MCP Server

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

• Entre neste diretório

cd Office-Word-MCP-Server

• Instale todas as bibliotecas e dependências Python necessárias

pip install -r requirements.txt

• Inicie a configuração do agente

python3 setup_ai_agent.py

• Escolha o primeiro caminho de configuração sugerido quando solicitado. O sistema confirmará a integração bem-sucedida com o arquivo de configuração do Claude Desktop;
• Após a instalação, é necessário reiniciar completamente o Claude Desktop para o reconhecimento adequado do agente.

Se o agente não aparecer em Search & Tools:

• Acessar configuração: utilize Command+, (Mac) ou Ctrl+, (Windows) para abrir Settings;
• Painel de desenvolvedor: navegue até o painel Developer e selecione "Edit Config";
• Integração de parâmetros: copie os parâmetros de configuração:

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

• Configuração de caminho: utilize o comando pwd no Terminal para obter o caminho absoluto do diretório;
• Gerenciamento de arquivos: insira o caminho antes das chaves de fechamento da configuração e salve com Command+S ou Ctrl+S;
• É necessário reiniciar completamente o Claude Desktop para o reconhecimento adequado do agente;
• Verifique se o agente Word AI aparece em Search & Tools. Para testes ideais, desative temporariamente outros agentes como Desktop Commander para isolar a funcionalidade.