Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.suki.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Jira MCP Setup Guide for Cursor

This guide helps you add the Atlassian Jira MCP server to Cursor so you can create and manage Jira tickets from the AI assistant.

​
Prerequisites

  • Node.js 18 or higher
  • Jira Cloud account (this MCP supports Jira Cloud only, not self-hosted)
  • Atlassian API token

​
Step 1: Create an Atlassian API Token

  1. Go to Atlassian API Tokens
  2. Click Create API token
  3. Give it a label (e.g., Cursor MCP or Jira AI)
  4. Click Create
  5. Copy the token immediately — you won’t be able to see it again

​
Step 2: Find Your Jira Site Name

Your site name is the first part of your Jira URL:
Jira URLSite Name
https://mycompany.atlassian.netmycompany
https://acme-corp.atlassian.netacme-corp

​
Step 3: Add Jira MCP to Cursor

​
Option A: Edit config file directly

  1. Open your Cursor MCP config:
    • macOS/Linux: ~/.cursor/mcp.json
    • Windows: %USERPROFILE%\.cursor\mcp.json
  2. Add the jira server to the mcpServers object. Your config should look like: 
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-existing-github-token"
      }
    },
    "jira": {
      "command": "npx",
      "args": ["-y", "@aashari/mcp-server-atlassian-jira"],
      "env": {
        "ATLASSIAN_SITE_NAME": "your-company",
        "ATLASSIAN_USER_EMAIL": "your.email@company.com",
        "ATLASSIAN_API_TOKEN": "your_api_token"
      }
    }
  }
}
  1. Replace the placeholders:
    • your-company → Your Jira site name (e.g., suki for suki.atlassian.net)
    • your.email@company.com → Your Atlassian account email
    • your_api_token → The API token from Step 1

​
Option B: Use Cursor Settings UI

  1. Open Cursor Settings (Cmd+, or Ctrl+,)
  2. Go to Tools & Integrations → MCP Servers
  3. Click Add new MCP server
  4. Configure the Jira server with the same values as above

​
Step 4: Restart Cursor

Restart Cursor (or reload the window) for the new MCP to load.

​
What You Can Do

Once configured, you can ask the AI to:
  • Create tickets: “Create a Jira task in project DEV: Fix login bug”
  • Search issues: “Find all high priority issues in the PLATFORM project”
  • Get issue details: “Show me details about PROJ-123”
  • Add comments: “Add a comment to PROJ-456: Code review completed”
  • Update issues: “Update status of PROJ-123 to In Progress”

​
Troubleshooting

​
”Authentication failed” or “403 Forbidden”

  • Verify your API token is active at Atlassian API Tokens
  • Ensure site name is correct (no .atlassian.net, just the subdomain)

​
“Resource not found” or “404”

  • Use project keys (e.g., DEV) not project names
  • Issue keys include the project prefix (e.g., DEV-123)

​
Test your connection

Run this in terminal to verify credentials: 
npx -y @aashari/mcp-server-atlassian-jira get --path "/rest/api/3/myself"

​
Alternative: Full Atlassian MCP (Confluence + Jira)

If you need Confluence as well as Jira, use mcp-atlassian. It requires running a separate server:
  1. Clone and run the server:
git clone https://github.com/samwang0723/mcp-atlassian.git
cd mcp-atlassian
# Create .env with ATLASSIAN_HOST, ATLASSIAN_EMAIL, ATLASSIAN_API_TOKEN
npm install && npm start
  1. Add to config with streamable-http:
"atlassian": {
  "url": "http://localhost:3007/mcp",
  "type": "streamable-http"
}

​
Reference

Last modified on May 25, 2026