docs-mcp-server: Skill for Claude Code

Add New Tenant Workflow

Add documentation sources as searchable tenants. Supports three source types:

• git — GitHub/GitLab repos with sparse checkout
• online — Documentation websites crawled via sitemap or entry URLs
• filesystem — Pre-existing local Markdown/HTML directories

Step 0: Backup deployment.json

ALWAYS back up before any changes. deployment.json is untracked (git-ignored).

mkdir -p tmp/backups && cp deployment.json "tmp/backups/deployment.json.$(date +%Y%m%d-%H%M%S)"

Step 1: Study existing tenants of the same type

Before adding anything, sample 2-3 existing tenants of the same source_type to match conventions.

python3 -c "
import json
with open('deployment.json') as f:
    config = json.load(f)
for t in config['tenants']:
    if t['source_type'] == '<TYPE>':  # git | online | filesystem
        print(json.dumps(t, indent=2))
        print()
" | head -80

Also list all codenames to check for duplicates:

python3 -c "import json; d=json.load(open('deployment.json')); print(json.dumps(sorted([t['codename'] for t in d['tenants']])))"

Step 2: Determine tenant configuration

For git tenants (GitHub repos)

Identify from the URL:

• git_branch: Usually main or master — check the repo's default branch
• git_subpaths: The subdirectory containing docs (e.g., ["docs"], ["cheatsheets"])
• git_strip_prefix: Usually matches git_subpaths[0] to flatten the directory structure
• search.analyzer_profile: Use "code-friendly" for code-heavy repos, "default" otherwise

Required fields:

{
  "source_type": "git",
  "codename": "<lowercase-hyphen-name>",
  "docs_name": "<Human Readable Name>",
  "git_repo_url": "https://github.com/<org>/<repo>.git",
  "git_branch": "main",
  "git_subpaths": ["<subpath>"],
  "git_strip_prefix": "<subpath>",
  "docs_root_dir": "./mcp-data/<codename>",
  "refresh_schedule": "<M> <H> <cron-tail>"
}

Optional fields:

• git_auth_token_env: Env var name for private repo PAT (e.g., "GITHUB_TOKEN")
• git_sync_interval_minutes: Override sync cadence (5-1440 min)
• search.analyzer_profile: "default" | "aggressive-stem" | "code-friendly"