Skip to main content

Postman (MCP)

Learn how to connect SQAI Suite to Postman using the Model Context Protocol (MCP). This guide explains how to use Postman as an MCP client to test, evaluate, and experiment with SQAI tools and resources.

Updated this week

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

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).

Did this answer your question?