Incorrect install documentation leads to error "error: unknown option '-e'"

Open Beginner friendly

#3,032 opened on Aug 6, 2026 0 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty: 2/5
Estimated time: 1-3 hours
Newbie friendliness: 72/100

Issue type: Documentation
Clarity: Mostly clear
Activity status: Quiet
Tech stack: docker
Domain: documentation

Research direction

Open docs/installation-guides/install-claude.md at the “With Docker” section and review the documented claude mcp add commands, starting with the command that places -e before the separator. Correct the Docker command syntax and check the other commands below it for the same argument-placement issue; done means the examples match valid Claude CLI and Docker invocation order.

Written by the indexing model from the issue text.

Description

bug

Describe the bug

The documentation for setting up docker with claude has an incorrect command
claude mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=YOUR_GITHUB_PAT -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server

The correct command would be
claude mcp add github -- docker run -i --rm -p 127.0.0.1:8085:8085 -e GITHUB_OAUTH_CALLBACK_PORT -e GITHUB_OAUTH_CALLBACK_PORT=8085 ghcr.io/github/github-mcp-server

Affected version

The documentation here https://github.com/github/github-mcp-server/blob/main/docs/installation-guides/install-claude.md#with-docker

Steps to reproduce the behavior

Run this command and it will fail as -e is not valid as an arg to the claude cli claude mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=YOUR_GITHUB_PAT -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server

Expected vs actual behavior

Command corrected to claude mcp add github -- docker run -i --rm -p 127.0.0.1:8085:8085 -e GITHUB_OAUTH_CALLBACK_PORT -e GITHUB_OAUTH_CALLBACK_PORT=8085 ghcr.io/github/github-mcp-server

It seems like other commands are incorrect in the docs below the command I posted. Many have -e args in the wrong spot.

Logs

No logs

Dominant language: Go
Stars: 33.1k
Forks: 5k
Avg merge: 2d 1h
Merged PRs (30d): 25

Contributor guide

Open the contributing guide

First steps

Read the whole issue, then the project's contributing guide.
Comment on the issue to say you are picking it up — it saves two people doing the same work.
Fork the repository and make your change on a branch.
Open a pull request that references the issue number.

Similar issues

Remove PSPs from Helm chart Open

feature-request helm

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

gravitational/teleport#69785 · Opened Sep 22, 2026
fix(client): convertValue drops fractional seconds from every time value Open

bug

Difficulty 1/5 Under an hour Newbie friendliness 92/100

txn2/mcp-trino#92 · Opened Sep 22, 2026
cloudflare_snippet: Read panics with a nil pointer dereference at snippet/resource.go:207 Open

Difficulty 2/5 1-3 hours Newbie friendliness 84/100

cloudflare/terraform-provider-cloudflare#7378 · Opened Sep 22, 2026
Usage controller writes the in-use label on every reconcile even though it is already set Open

Difficulty 2/5 1-3 hours Newbie friendliness 88/100

crossplane/crossplane#7859 · Opened Sep 22, 2026
Add Easypanel as a Docker deployment option Open

Difficulty 1/5 Under an hour Newbie friendliness 90/100

sentriz/gonic#729 · Opened Sep 22, 2026

More Go issues