From 9f55730df1fc352829be97350531212f63ef6ac1 Mon Sep 17 00:00:00 2001
From: Makabeez <155258247+Makabeez@users.noreply.github.com>
Date: Thu, 6 Aug 2026 10:30:07 +0200
Subject: [PATCH] docs: document SSH prerequisite and MCP fallback for /plugin
 marketplace add
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The marketplace add command clones via SSH; users without GitHub SSH keys
configured see "Permission denied (publickey)" with no explanation. This
blocks the entire documented setup path — /keeperhub:login and
/keeperhub:status never become available.

Adds a callout above the setup steps with:
- explanation of why SSH is required
- link to GitHub's SSH key setup guide
- direct MCP alternative (claude mcp add --transport http) that works
  without SSH keys at all

Found during a fresh Linux/WSL2 onboarding run (2026-08-06).
---
 README.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/README.md b/README.md
index b67920f..9205401 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,14 @@ Claude Code plugin marketplace by KeeperHub.
 
 ## Setup
 
+> **Prerequisite:** Claude Code's `/plugin marketplace add` clones this repository over SSH.
+> You need a GitHub SSH key configured before running the commands below.
+> If you see `Permission denied (publickey)`, see [GitHub's SSH setup guide](https://docs.github.com/en/authentication/connecting-to-github-with-ssh).
+> Alternatively, configure the MCP server directly without the plugin system:
+> ```
+> claude mcp add --transport http --scope user keeperhub https://app.keeperhub.com/mcp
+> ```
+
 ```
 /plugin marketplace add KeeperHub/claude-plugins
 /plugin install keeperhub@keeperhub-plugins