Recommend marketplace install; keep .mcp.json version in sync - #19
Open
christosgkoros wants to merge 3 commits into
Open
Recommend marketplace install; keep .mcp.json version in sync#19christosgkoros wants to merge 3 commits into
christosgkoros wants to merge 3 commits into
Conversation
- README: make /plugin install postman@claude-plugins-official the primary install method; move GitHub and local-clone installs to collapsible alternatives - .mcp.json: bump X-Plugin-Version and User-Agent to match plugin.json (were 1.2.0) - release.yml: fail the release if .mcp.json version headers drift from plugin.json - CLAUDE.md: document updating .mcp.json headers alongside plugin.json on release - Bump plugin.json to 1.3.1 and add CHANGELOG entry Co-Authored-By: Claude <noreply@anthropic.com>
christosgkoros
requested review from
buildwithtalia,
garciasdos and
quintonwall
August 2, 2026 14:45
Catch .mcp.json vs plugin.json version drift on every PR and push to main, not just at release/tag time. Co-Authored-By: Claude <noreply@anthropic.com>
Auto-requests review from the postman-api group members when a PR is ready for review. Listed as individuals because the @postman-eng/postman-api team is cross-org and cannot be referenced in a Postman-Devrel CODEOWNERS file. Co-Authored-By: Claude <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.
Summary
/plugin install postman@claude-plugins-official(and theclaude plugin install postman@claude-plugins-officialterminal variant) the primary install method. Moves thegithub:install and local-clone flow into collapsible "Alternative" sections. Re-applies the intent of the previously closed Update README: install via official plugin marketplace #15 on top of the current README..mcp.json: theX-Plugin-VersionandUser-Agentheaders had drifted to1.2.0— bumped to matchplugin.json.release.ymlnow fails the release (onv*tags) if.mcp.json's version headers don't matchplugin.json, mirroring the existing tag-vs-plugin.jsoncheck.CLAUDE.mdrelease process now instructs updating.mcp.jsonheaders alongsideplugin.json.plugin.jsonto1.3.1(user-facing README change) with a matchingCHANGELOG.mdentry.Test plan
release.ymlis valid YAML;.mcp.json+plugin.jsonare valid JSON1.3.1)Note
Version-sync is enforced at release/tag time (matching the existing tag check), not on every PR. Happy to add a
pull_request-triggered validation job if you'd prefer it run earlier.Generated with Claude Code