← back to Cli Printing Press
fix(cli): README template recommends MCPB drag-and-drop and skill install (#498)
0a741d32fad4a930c52378cd2d1d1a111b51bcae · 2026-05-01 23:51:43 -0700 · Trevin Chow
The README's MCP-server section advertised the legacy claude_desktop_config.json
edit path. That path is broken for `go install` users because the install
section only documents the -pp-cli target, but the JSON config and `claude
mcp add` examples both reference -pp-mcp on PATH. The section also missed
the MCPB bundle generate has been emitting since v3.0.0 (Apr 27) and the
focused-skill install path that is the recommended Claude Code integration.
Restructure into host-oriented sections so users see the right path for
where they want to use the CLI:
- ## Use with Claude Code: focused skill via `npx skills add` is the
visible primary — the skill auto-installs the CLI on first invocation.
MCP-server registration with `claude mcp add` is collapsed under
<details> with the missing `go install ...cmd/<name>-pp-mcp@latest`
prerequisite added so it actually works.
- ## Use with Claude Desktop: MCPB double-click install is the visible
primary, with a brief link to the MCPB spec. Manual JSON config
collapsed under <details>, also with the `go install ...-pp-mcp`
prerequisite.
Updates the golden fixture to match. Existing per-CLI READMEs in the
public library will be updated in a follow-up PR for the five CLIs that
already have build/.mcpb committed.
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Files touched
M internal/generator/templates/readme.md.tmplM testdata/golden/expected/generate-golden-api/printing-press-golden/README.md
Diff
commit 0a741d32fad4a930c52378cd2d1d1a111b51bcae
Author: Trevin Chow <trevin@trevinchow.com>
Date: Fri May 1 23:51:43 2026 -0700
fix(cli): README template recommends MCPB drag-and-drop and skill install (#498)
The README's MCP-server section advertised the legacy claude_desktop_config.json
edit path. That path is broken for `go install` users because the install
section only documents the -pp-cli target, but the JSON config and `claude
mcp add` examples both reference -pp-mcp on PATH. The section also missed
the MCPB bundle generate has been emitting since v3.0.0 (Apr 27) and the
focused-skill install path that is the recommended Claude Code integration.
Restructure into host-oriented sections so users see the right path for
where they want to use the CLI:
- ## Use with Claude Code: focused skill via `npx skills add` is the
visible primary — the skill auto-installs the CLI on first invocation.
MCP-server registration with `claude mcp add` is collapsed under
<details> with the missing `go install ...cmd/<name>-pp-mcp@latest`
prerequisite added so it actually works.
- ## Use with Claude Desktop: MCPB double-click install is the visible
primary, with a brief link to the MCPB spec. Manual JSON config
collapsed under <details>, also with the `go install ...-pp-mcp`
prerequisite.
Updates the golden fixture to match. Existing per-CLI READMEs in the
public library will be updated in a follow-up PR for the five CLIs that
already have build/.mcpb committed.
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
internal/generator/templates/readme.md.tmpl | 70 ++++++++++++++++++++--
.../printing-press-golden/README.md | 46 ++++++++++++--
2 files changed, 108 insertions(+), 8 deletions(-)
diff --git a/internal/generator/templates/readme.md.tmpl b/internal/generator/templates/readme.md.tmpl
index deb97863..9ba128db 100644
--- a/internal/generator/templates/readme.md.tmpl
+++ b/internal/generator/templates/readme.md.tmpl
@@ -284,11 +284,26 @@ GraphQL path: `{{.GraphQLEndpointPath}}`
{{- end}}
{{- end}}
-## Use as MCP Server
+## Use with Claude Code
-This CLI ships a companion MCP server for use with Claude Desktop, Cursor, and other MCP-compatible tools.
+Install the focused skill — it auto-installs the CLI on first invocation:
-### Claude Code
+```bash
+npx skills add mvanhorn/printing-press-library/cli-skills/pp-{{.Name}} -g
+```
+
+Then invoke `/pp-{{.Name}} <query>` in Claude Code. The skill is the most efficient path — Claude Code drives the CLI directly without an MCP server in the middle.
+
+<details>
+<summary>Use as an MCP server in Claude Code (advanced)</summary>
+
+If you'd rather register this CLI as an MCP server in Claude Code, install the MCP binary first:
+
+```bash
+go install github.com/mvanhorn/printing-press-library/library/{{if .Category}}{{.Category}}{{else}}other{{end}}/{{.Name}}/cmd/{{.Name}}-pp-mcp@latest
+```
+
+Then register it:
{{- if and (eq .Auth.Type "api_key") .Auth.EnvVars}}
```bash
@@ -330,7 +345,52 @@ claude mcp add {{.Name}} {{.Name}}-pp-mcp
```
{{- end}}
-### Claude Desktop
+</details>
+
+## Use with Claude Desktop
+
+This CLI ships an [MCPB](https://github.com/modelcontextprotocol/mcpb) bundle — Claude Desktop's standard format for one-click MCP extension installs (no JSON config required).
+{{- if or (eq .Auth.Type "cookie") (eq .Auth.Type "composed")}}
+
+The bundle reuses your local browser session — set it up first if you haven't:
+
+```bash
+{{.Name}}-pp-cli auth login --chrome
+```
+{{- else if eq .Auth.Type "oauth2"}}
+
+The bundle reuses your local OAuth tokens — authenticate first if you haven't:
+
+```bash
+{{.Name}}-pp-cli auth login
+```
+{{- else if and (eq .Auth.Type "bearer_token") (not .Auth.EnvVars)}}
+
+Store your token first if you haven't:
+
+```bash
+{{.Name}}-pp-cli auth set-token YOUR_TOKEN_HERE
+```
+{{- end}}
+
+To install:
+
+1. Download [`{{.Name}}-pp-mcp-darwin-arm64.mcpb`](https://github.com/mvanhorn/printing-press-library/blob/main/library/{{if .Category}}{{.Category}}{{else}}other{{end}}/{{.Name}}/build/{{.Name}}-pp-mcp-darwin-arm64.mcpb) from the public library.
+2. Double-click the `.mcpb` file. Claude Desktop opens and walks you through the install.
+{{- if and .Auth.EnvVars (ne .Auth.Type "none") (ne .Auth.Type "cookie") (ne .Auth.Type "composed")}}
+3. Fill in `{{index .Auth.EnvVars 0}}` when Claude Desktop prompts you.
+{{- end}}
+
+Requires Claude Desktop 1.0.0 or later. Pre-built bundles ship for macOS Apple Silicon (`darwin-arm64`); for other platforms, build a bundle with `printing-press bundle <cli-dir> --platform <os>/<arch>` or use the manual config below.
+
+<details>
+<summary>Manual JSON config (advanced)</summary>
+
+If you can't use the MCPB bundle (older Claude Desktop, unsupported platform), install the MCP binary and configure it manually.
+
+```bash
+go install github.com/mvanhorn/printing-press-library/library/{{if .Category}}{{.Category}}{{else}}other{{end}}/{{.Name}}/cmd/{{.Name}}-pp-mcp@latest
+```
Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):
@@ -350,6 +410,8 @@ Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_
}
```
+</details>
+
## Health Check
```bash
diff --git a/testdata/golden/expected/generate-golden-api/printing-press-golden/README.md b/testdata/golden/expected/generate-golden-api/printing-press-golden/README.md
index 48ef7c8d..20d50c10 100644
--- a/testdata/golden/expected/generate-golden-api/printing-press-golden/README.md
+++ b/testdata/golden/expected/generate-golden-api/printing-press-golden/README.md
@@ -111,17 +111,53 @@ This CLI is designed for AI agent consumption:
Exit codes: `0` success, `2` usage error, `3` not found, `4` auth error, `5` API error, `7` rate limited, `10` config error.
-## Use as MCP Server
+## Use with Claude Code
-This CLI ships a companion MCP server for use with Claude Desktop, Cursor, and other MCP-compatible tools.
+Install the focused skill — it auto-installs the CLI on first invocation:
-### Claude Code
+```bash
+npx skills add mvanhorn/printing-press-library/cli-skills/pp-printing-press-golden -g
+```
+
+Then invoke `/pp-printing-press-golden <query>` in Claude Code. The skill is the most efficient path — Claude Code drives the CLI directly without an MCP server in the middle.
+
+<details>
+<summary>Use as an MCP server in Claude Code (advanced)</summary>
+
+If you'd rather register this CLI as an MCP server in Claude Code, install the MCP binary first:
+
+```bash
+go install github.com/mvanhorn/printing-press-library/library/other/printing-press-golden/cmd/printing-press-golden-pp-mcp@latest
+```
+
+Then register it:
```bash
claude mcp add printing-press-golden printing-press-golden-pp-mcp -e PRINTING_PRESS_GOLDEN_API_KEY_AUTH=<your-key>
```
-### Claude Desktop
+</details>
+
+## Use with Claude Desktop
+
+This CLI ships an [MCPB](https://github.com/modelcontextprotocol/mcpb) bundle — Claude Desktop's standard format for one-click MCP extension installs (no JSON config required).
+
+To install:
+
+1. Download [`printing-press-golden-pp-mcp-darwin-arm64.mcpb`](https://github.com/mvanhorn/printing-press-library/blob/main/library/other/printing-press-golden/build/printing-press-golden-pp-mcp-darwin-arm64.mcpb) from the public library.
+2. Double-click the `.mcpb` file. Claude Desktop opens and walks you through the install.
+3. Fill in `PRINTING_PRESS_GOLDEN_API_KEY_AUTH` when Claude Desktop prompts you.
+
+Requires Claude Desktop 1.0.0 or later. Pre-built bundles ship for macOS Apple Silicon (`darwin-arm64`); for other platforms, build a bundle with `printing-press bundle <cli-dir> --platform <os>/<arch>` or use the manual config below.
+
+<details>
+<summary>Manual JSON config (advanced)</summary>
+
+If you can't use the MCPB bundle (older Claude Desktop, unsupported platform), install the MCP binary and configure it manually.
+
+```bash
+go install github.com/mvanhorn/printing-press-library/library/other/printing-press-golden/cmd/printing-press-golden-pp-mcp@latest
+```
Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):
@@ -138,6 +174,8 @@ Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_
}
```
+</details>
+
## Health Check
```bash
← f84853b7 chore(main): release 3.4.2 (#497)
·
back to Cli Printing Press
·
chore(main): release 3.4.3 (#499) ec74c7a9 →