fix(docs): correct MCP server npx invocation (-p package, not bare bin)#101
Merged
Conversation
#99 documented the MCP server as `npx -y nativeapptemplate-agent-mcp`, but there is no npm package by that name — it's a *bin* of the `nativeapptemplate-agent` package, so the bare form 404s. Use the package-scoped form: `npx -y -p nativeapptemplate-agent nativeapptemplate-agent-mcp`. Verified against published 0.2.1 from a clean dir with a real MCP initialize handshake (returns serverInfo nativeapptemplate-agent 0.2.1). Fixes the runnable references in README, CLAUDE.md, and ROADMAP; SPEC's bin-name mention and the ROADMAP prose identifier are left as-is (not commands). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Bug
#99 documented the MCP server distribution surface as:
But there is no npm package named
nativeapptemplate-agent-mcp— it's a bin of thenativeapptemplate-agentpackage (two bins:nativeapptemplate-agentandnativeapptemplate-agent-mcp).npm view nativeapptemplate-agent-mcp→ 404, so the barenpxform fails for every user who copies it.Fix
Package-scoped invocation, which resolves the bin from the package:
Verified against published 0.2.1 from a clean
/tmpdir with a real MCPinitializehandshake:Corrected the three runnable references (
README.md,CLAUDE.md,ROADMAP.md).docs/SPEC.md's bin-name mention andROADMAP.md:89's prose identifier are left as-is — they name the bin, they aren't commands. CLAUDE.md keeps a one-line note on why-pis needed so the mistake isn't reintroduced.Note
The same corrected form is used in the new plugin's
.mcp.json(#100, onepic/claude-code-plugin). If we'd rather the barenpx -y nativeapptemplate-agent-mcp"just work" as originally written, the alternative is publishing a thinnativeapptemplate-agent-mcpshim package — flagged for a separate decision; not done here.🤖 Generated with Claude Code