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+
- 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
git clone ssh://git@hotserv.tailc9b278.ts.net:2222/personal-projects/support-claude-mktplace.git
cd support-claude-mktplace
/plugin marketplace add https://gitea.hotserv.cloud/personal-projects/support-claude-mktplace.git
```
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
# Gitea MCP (for projman)
cd plugins/projman/mcp-servers/gitea
@@ -114,7 +146,9 @@ Comprehensive NetBox REST API integration for infrastructure management.
deactivate
```
3. **Configure system-level credentials:**
### Configure Credentials
**System-level credentials:**
```bash
mkdir -p ~/.config/claude
@@ -134,7 +168,7 @@ Comprehensive NetBox REST API integration for infrastructure management.
chmod 600 ~/.config/claude/*.env
```
4. **Configure project-level settings:**
**Project-level settings:**
```bash
# In your target project root
cat > .env << 'EOF'
@@ -142,15 +176,6 @@ Comprehensive NetBox REST API integration for infrastructure management.
EOF
```
5. **Add marketplace to Claude Code:**
Add to your project's `.claude/settings.json`:
```json
{
"pluginMarketplace": "/path/to/support-claude-mktplace"
}
```
## Repository Structure
```
@@ -217,4 +242,5 @@ MIT License
## Support
- **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`