> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Postman

> Connect StackOne MCP to Postman to test and interact with MCP tools using HTTP requests.

## Overview

[Postman](https://www.postman.com/) is a popular API development and testing tool that allows you to send HTTP requests and receive responses. You can use Postman to interact with StackOne's MCP server by making JSON-RPC 2.0 requests.

<Info>
  Postman is ideal for testing MCP endpoints, debugging requests, and exploring available tools before integrating into your application.
</Info>

## Get the StackOne public Postman collection

The StackOne public Postman collection comes with a pre-configured MCP request:

<Card title="Open in Postman" icon="postman" href="https://god.gw.postman.com/run-collection/68ca4160009b6f9cc908f435?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D68ca4160009b6f9cc908f435%26entityType%3DextensibleCollection%26workspaceId%3Df291b2e0-d0cb-4dc2-93c4-c2d4f581da3f">
  Fork this collection to get started
</Card>

The collection already includes:

* MCP requests in the **StackOne MCP** folder
* Basic Auth configured with `{{apiKey}}` as the username
* `x-account-id` header set to `{{accountID}}`
* URL pre-configured to `https://api.stackone.com/mcp`

## Setup

<Steps>
  <Step title="Create a Postman Environment">
    1. Open Postman
    2. Click the **Environments** icon in the left sidebar
    3. Click **+** to create a new environment
    4. Name it "StackOne MCP" (or your preferred name)
  </Step>

  <Step title="Add Environment Variables">
    Add the following variables to your environment (these match the variable names used in the collection):

    | Variable    | Initial Value     | Current Value     |
    | ----------- | ----------------- | ----------------- |
    | `apiKey`    | `your-api-key`    | `your-api-key`    |
    | `accountID` | `your-account-id` | `your-account-id` |

    <Tip>
      You can generate a new API key in the [StackOne Dashboard](https://app.stackone.com/api_keys). You can find your account ID in the [StackOne Dashboard](https://app.stackone.com) under your linked accounts.
    </Tip>
  </Step>

  <Step title="Select Your Environment">
    In the top-right corner of Postman, select your "StackOne MCP" environment from the dropdown to activate it.
  </Step>
</Steps>

<Frame caption="Example Postman environment configured for StackOne MCP (values shown are placeholders).">
  <img src="https://mintcdn.com/stackone-60/h6ZzpHU4OIbKqjk1/images/mcp/postman_create_environment.png?fit=max&auto=format&n=h6ZzpHU4OIbKqjk1&q=85&s=2e9f945c8059b3a95a8e4d977e0bdd8a" alt="Example Postman environment" width="2134" height="500" data-path="images/mcp/postman_create_environment.png" />
</Frame>

## Using the MCP Request

After forking the collection and setting up your environment variables, you'll find a pre-configured MCP request in the **StackOne MCP** folder. The MCP protocol uses JSON-RPC 2.0 format.

### Send Your First Request

1. Navigate to the **StackOne MCP** folder in your forked collection
2. Select the **Connect to StackOne MCP** request
3. Make sure your environment is selected in the top-right corner
4. Under the **Message** tab, click "Load Capabilities"
5. This will show all the available tools for the account you've connected to
6. Select the tool you want to use, fill in any required fields, and click "Run"

You should receive a JSON response from the API with the results of request.

<Info>
  The next time you load the collection, it should automatically load the capabilities for the account you've connected to.
</Info>

<Frame caption="Example tool call from Postman (request parameters and JSON response).">
  <img src="https://mintcdn.com/stackone-60/h6ZzpHU4OIbKqjk1/images/mcp/postman_call_mcp.png?fit=max&auto=format&n=h6ZzpHU4OIbKqjk1&q=85&s=033eaf305add2a2d3741cb58cbdefb5c" alt="Postman MCP request showing a selected tool, request parameters, and JSON response" width="2130" height="1594" data-path="images/mcp/postman_call_mcp.png" />
</Frame>

## Next Steps

<CardGroup cols={2}>
  <Card title="MCP Quickstart" icon="rocket" href="/mcp/quickstart">
    Learn more about StackOne MCP
  </Card>

  <Card title="Authentication Guide" icon="lock" href="/mcp/auth-security">
    Configure authentication and security
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/mcp/troubleshooting">
    Resolve common issues
  </Card>

  <Card title="Framework Guides" icon="code" href="/mcp/framework-guides/anthropic-sdk">
    Integrate MCP into your application
  </Card>
</CardGroup>