Skip to content

feat(sdlc-pipeline): add Postman MCP, auto-select Newman, update onbo… - #12

Open
codeartstest wants to merge 1 commit into
CodeArtsAgent:mainfrom
codeartstest:main
Open

feat(sdlc-pipeline): add Postman MCP, auto-select Newman, update onbo…#12
codeartstest wants to merge 1 commit into
CodeArtsAgent:mainfrom
codeartstest:main

Conversation

@codeartstest

@codeartstest codeartstest commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

…arding

  • mcp-settings.json: add Postman HTTP MCP entry (https://mcp.postman.com/mcp)
  • config-reference.md: add Postman + terraform to MCP table
  • service-onboarding.md: update Postman MCP config note, expand table with Postman install and Newman cloud collection steps
  • multi-tool-selection-plan.md: add Postman->Newman auto-select rule (post-processing), update Q3 option descriptions, remove soft warning

Summary by CodeRabbit

  • Documentation
    • Documented Postman MCP configuration, installation, authentication, and API collection testing setup.
    • Added Terraform and Postman to the list of conditionally required tools.
    • Clarified that Newman is automatically selected when Postman is chosen for testing.
    • Updated the MCP configuration template with Postman server settings.

…arding

- mcp-settings.json: add Postman HTTP MCP entry (https://mcp.postman.com/mcp)
- config-reference.md: add Postman + terraform to MCP table
- service-onboarding.md: update Postman MCP config note, expand table
  with Postman install and Newman cloud collection steps
- multi-tool-selection-plan.md: add Postman->Newman auto-select rule
  (post-processing), update Q3 option descriptions, remove soft warning
@coderabbitai

coderabbitai Bot commented Jul 29, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

Postman is added to MCP selection and HTTP server configuration. Tool-selection documentation now auto-selects Newman when Postman is chosen. Onboarding documentation adds Postman installation, API-key configuration, smoke testing, and Newman collection execution instructions.

Changes

Postman MCP setup

Layer / File(s) Summary
Postman and Newman selection behavior
skills/sdlc-agentic-pipeline/references/setup/multi-tool-selection-plan.md
TDD options identify Newman as auto-selected with Postman, and post-selection processing documents the resulting tool-selections.json entry and summary.
MCP selection and server registration
skills/sdlc-agentic-pipeline/references/templates/mcp-settings.json, skills/sdlc-agentic-pipeline/references/config-reference.md
Postman is added to conditional generation and configured as an HTTP MCP server; the required-server table also documents Postman and Terraform.
Postman and Newman onboarding
skills/sdlc-agentic-pipeline/references/setup/service-onboarding.md
Adds Postman skill installation, MCP authorization settings, smoke testing, and Newman cloud collection commands using POSTMAN_API_KEY.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

Suggested reviewers: agentman3334

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly summarizes the main changes: Postman MCP support, Newman auto-selection, and onboarding updates.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@skills/sdlc-agentic-pipeline/references/setup/service-onboarding.md`:
- Line 144: Update the Postman row in the smoke-test table to replace the
invalid `postman MCP list workspaces` command with the documented `postman
search workspaces` CLI command, unless the row specifically requires an MCP
invocation format.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 3f28fcaa-3f87-4551-a6b7-ea167580e1f1

📥 Commits

Reviewing files that changed from the base of the PR and between 4e315a0 and 39aad9a.

📒 Files selected for processing (4)
  • skills/sdlc-agentic-pipeline/references/config-reference.md
  • skills/sdlc-agentic-pipeline/references/setup/multi-tool-selection-plan.md
  • skills/sdlc-agentic-pipeline/references/setup/service-onboarding.md
  • skills/sdlc-agentic-pipeline/references/templates/mcp-settings.json

| SDD Toolkit | N/A (built-in) | N/A | N/A |
| OpenSpec | `openspec --version` | `npm install -g @fission-ai/openspec@latest` | `openspec list` |
| Postman | N/A (MCP) | N/A | `postman MCP list workspaces` |
| Postman | N/A (MCP) | Copy `references/templates/SKILL.md` to `.codeartsdoer/skills/postman/SKILL.md` | `postman MCP list workspaces` |

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟠 Major | ⚡ Quick win

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
postman search workspaces --help
postman MCP list workspaces --help

Repository: CodeArtsAgent/CodeArtsSkills

Length of output: 252


🌐 Web query:

Postman CLI search workspaces command documentation

💡 Result:

The Postman CLI includes a dedicated command to search for workspaces, which is part of its broader search functionality. The command to search for workspaces is: postman search workspaces This command allows you to search for workspaces by name or keyword [1][2]. In addition to searching, the Postman CLI provides separate workspace management commands for CI/CD pipelines, such as postman workspace prepare (to validate local elements) and postman workspace push (to synchronize local elements with the Postman cloud) [3][4][5]. Note that these workspace management commands are distinct from the search commands [2]. For a complete reference of all available Postman CLI commands, you can consult the official Postman CLI documentation [1][6].

Citations:


🌐 Web query:

Postman CLI MCP list workspaces command documentation

💡 Result:

There is no specific "Postman CLI" command for listing workspaces within the Model Context Protocol (MCP). The Postman CLI and the Postman MCP Server are distinct tools with different purposes [1][2][3]. The Postman CLI is a standalone terminal application used for tasks such as running collections, monitoring APIs, and synchronizing local files with Postman cloud [3]. It does not natively implement MCP [3]. The Postman MCP Server is a separate integration that allows AI agents and IDEs (such as Cursor, Claude, or VS Code) to interact with Postman resources [1][2][4]. Within the Postman MCP Server, the tool to list workspaces is defined as list_workspaces [5][6]. To use the list_workspaces tool: 1. Ensure you have the Postman MCP Server configured [1][4]. 2. The tool is typically invoked by an AI agent through the Model Context Protocol interface rather than via a direct terminal command [2][7]. 3. If you are interacting with the tool programmatically (e.g., via an MCP SDK), you would call the tool list_workspaces [5][6]. The tool accepts optional parameters such as type and createdBy to filter the results [5]. It is recommended to use the official Postman MCP Server to ensure compatibility with your AI agents, as documented in the official Postman learning resources [2][8][9]. Prompts to AI agents should explicitly mention using the Postman MCP server to avoid confusion with CLI commands [7].

Citations:


Replace the invalid shell command in the Postman smoke-test row.

postman MCP list workspaces is not a documented Postman CLI command; the documented CLI workspace search command is postman search workspaces. Use the valid CLI command here, or if this row is meant to describe an MCP tool invocation, rewrite it as the actual MCP tool call format instead of a shell command.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@skills/sdlc-agentic-pipeline/references/setup/service-onboarding.md` at line
144, Update the Postman row in the smoke-test table to replace the invalid
`postman MCP list workspaces` command with the documented `postman search
workspaces` CLI command, unless the row specifically requires an MCP invocation
format.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants