Configuration

Configure the GroupDocs.Conversion MCP server through one config file: the documents folder, output folder, license path, delivery channel (Docker or NuGet), and target clients — set once, applied everywhere. This is the installer’s groupdocs-mcp.config.json:

{
  "channel":     "docker",
  "registry":    "ghcr",
  "clients":     ["claude-desktop", "vscode"],
  "version":     "latest",
  "storagePath": "D:/Storage/Documents",
  "outputPath":  "D:/Storage/Output",
  "licensePath": "D:/Storage/Licenses/GroupDocs.Total.lic",
  "products":    ["conversion"]
}
  • channeldocker (self-contained, recommended) or nuget (dnx, needs the .NET 10 SDK).
  • storagePath — where the server reads input documents (created if missing).
  • outputPath — optional separate folder for converted files; empty = same as storage.
  • licensePath — empty string = evaluation mode (safe, no error); see Licensing.
  • version"latest" or a pin such as "26.7.2". Pinning is recommended for shared/committed configs.
  • Any CLI switch overrides the file: -Channel, -Products, -Clients, -Version.

Environment variables (manual installs)

When you register the server manually, the same settings travel as environment variables:

VariableDescriptionDefault
GROUPDOCS_MCP_STORAGE_PATHBase folder for input and output filescurrent directory
GROUPDOCS_MCP_OUTPUT_PATHOptional separate folder for output filessame as storage
GROUPDOCS_LICENSE_PATHPath to a GroupDocs license fileempty = evaluation mode

Docker volume mapping

On the docker channel, host folders map into the container:

  • storagePath/data (with GROUPDOCS_MCP_STORAGE_PATH=/data)
  • outputPath/data/output (when set)
  • license folder → /license:ro with GROUPDOCS_LICENSE_PATH=/license/<file>.lic
docker run --rm -i \
  -v /path/to/documents:/data \
  -v /path/to/license-folder:/license:ro \
  -e GROUPDOCS_LICENSE_PATH=/license/GroupDocs.Total.lic \
  ghcr.io/groupdocs-conversion/conversion-net-mcp:latest

Compose-only setups

For container fleets without client registration, generate a docker-compose.yml:

./install-groupdocs-mcp.ps1 -EmitCompose -Clients @()