Commit d8881d6
committed
docs: add troubleshooting for Claude Code plugin HTTPS clone failures
When installing chrome-devtools-mcp as a Claude Code plugin, the
installation process clones the repository via HTTPS from GitHub.
In environments with restricted outbound HTTPS connectivity (corporate
firewalls, proxy configurations, or servers with port 443 blocked),
this clone operation fails with a timeout error:
fatal: unable to access
'https://github.com/ChromeDevTools/chrome-devtools-mcp.git/':
Failed to connect to github.com port 443
This commit adds documentation for two workarounds:
1. Redirecting GitHub HTTPS URLs to SSH via git config, which allows
users with SSH key authentication to bypass HTTPS restrictions
entirely using: git config --global url."git@github.com:".insteadOf
"https://github.com/"
2. Installing chrome-devtools-mcp via the Claude Code CLI as an MCP
server directly (claude mcp add), which uses npm/npx instead of git
clone and avoids the HTTPS requirement altogether, though without
the bundled skills that the plugin marketplace provides.
The troubleshooting section is added to docs/troubleshooting.md under
"Specific problems", and a cross-reference TIP callout is added to the
Claude Code plugin installation section in README.md to guide users
who encounter this error to the workarounds.1 parent e6b7a09 commit d8881d6
2 files changed
Lines changed: 44 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
156 | 156 | | |
157 | 157 | | |
158 | 158 | | |
| 159 | + | |
| 160 | + | |
| 161 | + | |
159 | 162 | | |
160 | 163 | | |
161 | 164 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
126 | 126 | | |
127 | 127 | | |
128 | 128 | | |
| 129 | + | |
| 130 | + | |
| 131 | + | |
| 132 | + | |
| 133 | + | |
| 134 | + | |
| 135 | + | |
| 136 | + | |
| 137 | + | |
| 138 | + | |
| 139 | + | |
| 140 | + | |
| 141 | + | |
| 142 | + | |
| 143 | + | |
| 144 | + | |
| 145 | + | |
| 146 | + | |
| 147 | + | |
| 148 | + | |
| 149 | + | |
| 150 | + | |
| 151 | + | |
| 152 | + | |
| 153 | + | |
| 154 | + | |
| 155 | + | |
| 156 | + | |
| 157 | + | |
| 158 | + | |
| 159 | + | |
| 160 | + | |
| 161 | + | |
| 162 | + | |
| 163 | + | |
| 164 | + | |
| 165 | + | |
| 166 | + | |
| 167 | + | |
| 168 | + | |
| 169 | + | |
129 | 170 | | |
130 | 171 | | |
131 | 172 | | |
| |||
0 commit comments