---
title: "Jira MCP in Cursor"
description: "Use Model Context Protocol to connect Cursor to Jira when drafting user stories: setup pattern, credentials, security, and troubleshooting."
canonical_url: "https://handbook.propay.co.za/analysis/jira-mcp"
---
# Jira MCP in Cursor

> Use Model Context Protocol to connect Cursor to Jira when drafting user stories: setup pattern, credentials, security, and troubleshooting.

## Purpose

[Model Context Protocol (MCP)](https://modelcontextprotocol.io/) lets an AI assistant in Cursor **read Jira issues and related context** while you work. That helps you align drafts with the [Jira user story skill](https://handbook.propay.co.za/analysis/jira-user-story-skill) and the [User story layout](https://handbook.propay.co.za/analysis/user-story-layout): pull live summaries, acceptance criteria, or links without copy-pasting everything.

The **exact MCP server** (name, package, or binary) depends on how your organization runs Jira and which server you choose. This page describes **how to wire a server safely** in Cursor; it does not pin a single third-party implementation.

## Prerequisites

- Access to **Jira** (Cloud or Data Center) with the permissions you need for the issues you want the agent to see.
- **API credentials** as required by your MCP server: often a **Personal Access Token** (PaaS/Cloud) or **API token** plus site URL; some setups use **OAuth**. Follow the server’s documentation.
- **Cursor** with MCP support enabled (see [Cursor MCP documentation](https://cursor.com/docs/context/mcp)).

## Cursor MCP basics

1. Open **Cursor Settings** and find **MCP** (or **Features → Model Context Protocol**), or edit your MCP config file as described in the [Cursor MCP docs](https://cursor.com/docs/context/mcp).
2. Add a **server** entry. Typical pattern:

  - **Command:** path to `npx`, `node`, or a dedicated binary, depending on the server.
  - **Args:** package name or script path, as documented by the server.
  - **Environment variables:** set `JIRA_*` or names the server documents (site URL, email, token, etc.). Prefer **environment** or Cursor’s secret storage; never commit values to git.

## Server-specific setup

1. Choose an MCP server that **integrates with Jira** and your deployment model (Cloud vs on‑prem). Check [Atlassian’s documentation](https://support.atlassian.com/) and [developer.atlassian.com](https://developer.atlassian.com/) for Jira REST API and authentication options.
2. If your organization provides a **standard MCP server** for Jira, use that and its env vars.
3. If you use a **community or npm package**, read its README for required `env` keys and scopes; rotate tokens if you change servers.

## Security

- Store **tokens and passwords** only in environment variables, Cursor’s secret store, or your OS keychain—not in the repo.
- Do **not** commit `.env`, `mcp.json` fragments with secrets, or screenshots of tokens.
- **Rotate** credentials immediately if they are exposed or leaked.
- Grant **least privilege**: tokens should only access the Jira projects and operations the MCP server needs.

## Troubleshooting

<table>
<thead>
  <tr>
    <th>
      Symptom
    </th>
    
    <th>
      What to check
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      Connection refused / timeout
    </td>
    
    <td>
      Firewall, VPN, correct Jira base URL, and that the MCP process can reach the network.
    </td>
  </tr>
  
  <tr>
    <td>
      401 / 403
    </td>
    
    <td>
      Token expired, wrong user, or missing Jira project/issue permission.
    </td>
  </tr>
  
  <tr>
    <td>
      Empty or partial data
    </td>
    
    <td>
      Issue key, filter, or API scope; some servers only expose certain fields.
    </td>
  </tr>
</tbody>
</table>

## Related

- [Analysis introduction](https://handbook.propay.co.za/analysis/introduction)
- [User story layout](https://handbook.propay.co.za/analysis/user-story-layout)
- [Jira user story skill](https://handbook.propay.co.za/analysis/jira-user-story-skill)
- [Figma MCP in Cursor](https://handbook.propay.co.za/analysis/figma-mcp)


## Sitemap

See the full [sitemap](https://handbook.propay.co.za/sitemap.md) for all pages.
