Skip to content

docs(claude): fix Docker install commands for claude mcp add - #3045

Draft
syf2211 wants to merge 1 commit into
github:mainfrom
syf2211:docs/fix-claude-docker-install-commands
Draft

docs(claude): fix Docker install commands for claude mcp add#3045
syf2211 wants to merge 1 commit into
github:mainfrom
syf2211:docs/fix-claude-docker-install-commands

Conversation

@syf2211

@syf2211 syf2211 commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

Summary

Fix incorrect claude mcp add Docker install examples that pass -e flags to the Claude CLI, which fails with error: unknown option '-e'. Environment variables are now passed through docker run after --.

Motivation

Fixes #3032. Users following the Claude Docker setup docs hit CLI errors because claude mcp add does not accept -e; only docker run should receive environment flags for containerized servers.

Changes

  • docs/installation-guides/install-claude.md
    • OAuth example: remove -e from claude mcp add; set GITHUB_OAUTH_CALLBACK_PORT=8085 on docker run
    • PAT example: pass GITHUB_PERSONAL_ACCESS_TOKEN=YOUR_GITHUB_PAT via docker run -e
    • Env-var example: export token first, then use docker run -e GITHUB_PERSONAL_ACCESS_TOKEN pass-through
  • README.md
    • Align CLI example with the same pattern and map GITHUB_PATGITHUB_PERSONAL_ACCESS_TOKEN before running Docker

Tests

Documentation-only change. Verified:

  • No remaining claude mcp add ... -e patterns in modified files
  • OAuth command matches docs/oauth-login.md port/env conventions

Notes

Claude Desktop JSON configs in the same guide already pass env vars via docker run args and were left unchanged.

Fixes #3032

Remove unsupported -e flags from claude mcp add and pass environment
variables through docker run instead. Fixes incorrect CLI usage that
produced 'error: unknown option -e'.

Fixes github#3032
@syf2211 syf2211 changed the title test docs(claude): fix Docker install commands for claude mcp add Aug 10, 2026

@alirezainanlosalehi7-lgtm alirezainanlosalehi7-lgtm left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

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

2 participants