docs: fix installation instructions for official methods

- Replace pluginMarketplace with extraKnownMarketplaces
- Add CLI command method (recommended)
- Add settings.json method for team distribution
- Add local development option
- Prioritize public HTTPS URL over Tailscale SSH URL
- Reorganize installation sections for clarity

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
2026-01-20 09:56:41 -05:00
parent 1adb434c58
commit 72941c1fe1

View File

@@ -89,15 +89,47 @@ Comprehensive NetBox REST API integration for infrastructure management.
- Python 3.10+ - Python 3.10+
- Access to target services (Gitea, NetBox as needed) - Access to target services (Gitea, NetBox as needed)
### Quick Start ### Add Marketplace to Claude Code
1. **Clone the repository:** **Option 1 - CLI command (recommended):**
```bash ```bash
git clone ssh://git@hotserv.tailc9b278.ts.net:2222/personal-projects/support-claude-mktplace.git /plugin marketplace add https://gitea.hotserv.cloud/personal-projects/support-claude-mktplace.git
cd support-claude-mktplace
``` ```
2. **Install MCP server dependencies:** **Option 2 - Settings file (for team distribution):**
Add to `.claude/settings.json` in your target project:
```json
{
"extraKnownMarketplaces": {
"support-claude-mktplace": {
"source": {
"source": "git",
"url": "https://gitea.hotserv.cloud/personal-projects/support-claude-mktplace.git"
}
}
}
}
```
**Option 3 - Local development:**
```bash
# Clone the repository first
git clone https://gitea.hotserv.cloud/personal-projects/support-claude-mktplace.git
# Then add from local path
/plugin marketplace add /path/to/support-claude-mktplace
```
**Alternative SSH URL (for authenticated access):**
```
ssh://git@hotserv.tailc9b278.ts.net:2222/personal-projects/support-claude-mktplace.git
```
### Configure MCP Server Dependencies
If using plugins with MCP servers (projman, cmdb-assistant), install dependencies:
```bash ```bash
# Gitea MCP (for projman) # Gitea MCP (for projman)
cd plugins/projman/mcp-servers/gitea cd plugins/projman/mcp-servers/gitea
@@ -114,7 +146,9 @@ Comprehensive NetBox REST API integration for infrastructure management.
deactivate deactivate
``` ```
3. **Configure system-level credentials:** ### Configure Credentials
**System-level credentials:**
```bash ```bash
mkdir -p ~/.config/claude mkdir -p ~/.config/claude
@@ -134,7 +168,7 @@ Comprehensive NetBox REST API integration for infrastructure management.
chmod 600 ~/.config/claude/*.env chmod 600 ~/.config/claude/*.env
``` ```
4. **Configure project-level settings:** **Project-level settings:**
```bash ```bash
# In your target project root # In your target project root
cat > .env << 'EOF' cat > .env << 'EOF'
@@ -142,15 +176,6 @@ Comprehensive NetBox REST API integration for infrastructure management.
EOF EOF
``` ```
5. **Add marketplace to Claude Code:**
Add to your project's `.claude/settings.json`:
```json
{
"pluginMarketplace": "/path/to/support-claude-mktplace"
}
```
## Repository Structure ## Repository Structure
``` ```
@@ -217,4 +242,5 @@ MIT License
## Support ## Support
- **Issues**: Contact repository maintainer - **Issues**: Contact repository maintainer
- **Repository**: `ssh://git@hotserv.tailc9b278.ts.net:2222/personal-projects/support-claude-mktplace.git` - **Repository**: `https://gitea.hotserv.cloud/personal-projects/support-claude-mktplace.git`
- **SSH URL**: `ssh://git@hotserv.tailc9b278.ts.net:2222/personal-projects/support-claude-mktplace.git`