Install on Linux Leave feedback

Install the GroupDocs.Editor MCP server on Linux with the setup bootstrapper — it installs PowerShell (pwsh) plus Docker, or the .NET 10 SDK and its native libraries — and then the guided installer:

git clone https://github.com/groupdocs/GroupDocs.Mcp.Installer.git
cd GroupDocs.Mcp.Installer
bash setup/linux.sh --channel docker
pwsh ./install-groupdocs-mcp.ps1 -Interactive

setup/linux.sh automates Debian/Ubuntu (apt + packages.microsoft.com), idempotently; add --check to report without installing. Other distros get the official documentation links printed instead of guessed package names.

• Always: PowerShell 7 (pwsh) — runs the installer scripts.
• Docker channel (recommended): docker engine (sudo apt-get install -y docker.io); the script adds you to the docker group — log out/in (or newgrp docker) before the first run.
• NuGet channel: .NET 10 SDK (sudo apt-get install -y dotnet-sdk-10.0) plus real fonts (only for PDF and XPS output) — the graphics code ships inside the package, so no libgdiplus is needed:

sudo apt-get install -y --no-install-recommends \
  libfontconfig1 ttf-mscorefonts-installer

Recommended — the installer:

pwsh ./install-groupdocs-mcp.ps1 -Channel docker \
  -Products editor -Clients claude-desktop -Verify

Manual alternatives:

# Docker channel - native deps bundled in the image (amd64 + arm64):
docker run --rm -i --user "$(id -u):$(id -g)" \
  -v $(pwd)/documents:/data \
  ghcr.io/groupdocs-editor/editor-net-mcp:latest

# NuGet channel (requires .NET 10 SDK + the native deps above):
dnx GroupDocs.Editor.Mcp --yes

The image runs as a non-root user (uid 1654), and a mounted folder keeps its host owner — --user "$(id -u):$(id -g)" runs the container as you, so it can write edited documents into your folder. MCP client configs are JSON and run no shell, so $(id -u) is not expanded there. Put the numbers in directly (id -u and id -g print them): "--user", "1000:1000" after "-i".

Client config locations on Linux: Claude Desktop ~/.config/Claude/claude_desktop_config.json, VS Code user-level ~/.config/Code/User/mcp.json — full list in Register in AI clients.

pwsh ./verify-groupdocs-mcp.ps1

A passing run completes the MCP handshake (eight tools listed) and — when a document sits in your storage folder — a real get_document_info call. Headless servers: the docker channel plus -EmitCompose gives you a docker-compose.yml for supervised operation.

• docker: permission denied — your user is not in the docker group yet; newgrp docker or re-login.
• Permission denied when the server saves into the mounted folder — the container runs as uid 1654; add --user "$(id -u):$(id -g)" (numbers in JSON configs).
• Fonts look wrong in edited documents — install ttf-mscorefonts-installer (the setup script pre-accepts its EULA via debconf).

Installing on a different OS? Windows · macOS