← ClaudeAtlas

cb-analytics-mcp-setuplisted

Use this skill when the user is setting up cb-analytics-mcp from scratch or troubleshooting an existing install — generating secrets, configuring .env, running --check, picking single- vs multi-cluster mode, tuning rate limits, configuring audit rotation, or using the CLI. Trigger when the user mentions "install", "configure", "first run", "MCP_API_KEY", "GUI_PASSWORD", "clusters.json", "cb-analytics-mcp --check", "MAX_QUERY_ROWS", "RATE_LIMIT_", "AUDIT_ROTATE", "tools call", or "tools list".
celticht32/Couchbase-Skills-for-Claude.ai · ★ 1 · AI & Automation · score 75
Install: claude install-skill celticht32/Couchbase-Skills-for-Claude.ai
# cb-analytics-mcp setup You're helping the user bring up or tune a cb-analytics-mcp installation. This skill covers configuration, validation, and the operator CLI. ## Required env vars (server refuses to start without these) - `MCP_API_KEY` — bearer token for Claude. **Min 32 chars.** Generate: `python -c "import secrets; print(secrets.token_urlsafe(48))"` - At least one of: - **Single cluster**: `CB_ANALYTICS_HOST` and `CB_ANALYTICS_PASSWORD` - **Multi cluster**: `CB_ANALYTICS_CLUSTERS_FILE` pointing at a JSON array - If GUI is enabled (default): `GUI_SESSION_SECRET` (≥32 chars) and a non-default `GUI_PASSWORD`. ## Validation flow Always recommend `cb-analytics-mcp --check` before `make run`. It returns: - exit 0 + a `config_valid` log line on success - exit 2 + a list of human-readable errors on failure `--check` doesn't try to reach the cluster. To verify network reachability too, use the **dashboard's Test Connection button** after starting the server (or `cb-analytics-mcp tools call ping_cluster --offline`, see CLI section below). ## Single vs multi-cluster decision - **One Couchbase cluster.** Use env vars only. Simpler. - **More than one cluster** (prod, stage, dev), or **one cluster with separate credentials per tenant.** Use `CB_ANALYTICS_CLUSTERS_FILE`. The file is a JSON array; each entry has `name`, `host`, `username`, `password`, and optional `tls`, `mgmt_port`, `analytics_port`, `verify_ssl`, `timeout_seconds`, `max_retries`. See `co