Postman (MCP)

The SQAI Suite MCP (Model Context Protocol) server acts as a centralized intelligence layer for your development environment. By integrating it into Postman, you can directly interact with your code context, user stories, and test management tools using Postman's built-in MCP request capabilities.

Added Value: A Context-Aware Bridge

Using the SQAI MCP within Postman allows you to bridge your API development workspace with your broader project data:

• Unified Intelligence: Connects your API collections and environments to external user stories and documentation for better alignment.
• Automated Traceability: Use SQAI tools to verify that your API requests match the requirements defined in your project management tools.
• Interactive Evaluation: Experiment with SQAI's tools (like get-test-case or get-work-item) in a familiar interface before deploying them in autonomous agents.

1. Generate Your API Key

You need an authentication key to securely connect Postman to the SQAI Platform.

1. Log in to the SQAI Platform.
2. Go to the MCP Configuration page: app.sqai-suite.com/mcp.
3. Generate and copy your unique API Key.

2. Setup Instructions

Postman supports MCP requests directly through its user interface using the streamable HTTP transport layer.

2.1 Create an MCP Request

1. Open Postman and navigate to a workspace.
2. In the left sidebar, click New and select MCP Request.
3. Set the communication method to HTTP.
4. Enter the server URL: https://api.sqai-suite.com/mcp.

2.2 Configure Authentication

1. Navigate to the Authorization tab of your new MCP request.
2. Set the Auth Type to Bearer Token.
3. Paste the API Key you generated in Step 1.

3. How to Use

1. Load Capabilities: Click the Load Capabilities button. Postman will connect to the SQAI server and display available tools, resources, and prompts.
2. Select a Tool: Open the Tools tab and choose a method (e.g., get-work-item).
3. Define Arguments: Fill in the required JSON arguments for the tool (e.g., providing a specific Jira ticket ID).
4. Run: Click Run to execute the tool. Postman will display the real-time response from the SQAI Suite in the Response tab.

4. Additional Resources

Postman Remote MCP Server: Connect AI Agents to Your API Workflows

This video provides a complete walkthrough of building and testing MCP servers within the Postman ecosystem, illustrating how tool definitions are handled.

5. Troubleshooting

Issue	Potential Cause	Solution
Capabilities won't load	Incorrect URL.	Ensure the URL is exactly https://api.sqai-suite.com/mcp with no trailing spaces.
Authentication failed	Token format.	Verify that the Bearer prefix is selected in the Authorization tab and your key is active.
Connection Timeout	Network/Proxy.	Check if your network blocks outbound streamable HTTP (SSE) connections. Verify access to the SQAI API domain.
Response not appearing	Payload size.	Some AI-generated responses can be large. If the request times out, try reducing the scope of your query (e.g., fetch one test case instead of ten).