Jira Connector - Prisme.ai

The Jira connector provides full access to Jira issue tracking, supporting both Jira Cloud and Jira Data Center deployments.

Issue Management

Search, create, update, and delete issues with full field support

Workflow Operations

Transition issues through statuses and add comments

Project Access

List and inspect projects accessible to your account

Prerequisites

A Jira Cloud or Jira Data Center instance
For Cloud: an Atlassian account email and API token
For Data Center: a Personal Access Token (PAT)

Get an API token at Atlassian API Tokens

Usage as App
Usage as MCP

Installation

Go to Apps in your workspace
Search for Jira and install it
Configure the app instance with your Jira credentials

Configuration

Jira Cloud

Field	Value
Base URL	`https://yoursite.atlassian.net`
Type	`cloud`
Email	Your Atlassian account email
API Token	Your Atlassian API token

Jira Data Center

Field	Value
Base URL	`https://jira.yourcompany.com`
Type	`datacenter`
Personal Access Token	Your PAT

Available Automations

Issue Operations

Automation	Description
`searchJira`	Search issues using JQL
`getIssue`	Get issue details by key
`createIssue`	Create a new issue
`updateIssue`	Update an existing issue
`deleteIssue`	Delete an issue

Workflow Operations

Automation	Description
`getTransitions`	Get available status transitions
`transitionIssue`	Change issue status
`addComment`	Add a comment to an issue
`addAttachment`	Add an attachment to an issue

Project Operations

Automation	Description
`listProjects`	List accessible projects
`getProject`	Get project details

DSUL Examples

Search Issues

- Jira.searchJira:
    jql: "project = DEV AND status = 'In Progress'"
    maxResults: 10
    output: results

Get Issue Details

- Jira.getIssue:
    issueKey: DEV-123
    output: issue

Create an Issue

- Jira.createIssue:
    projectKey: DEV
    issueType: Task
    summary: Implement new feature
    description: Detailed description here
    priority: High
    output: newIssue

Transition Issue Status

- Jira.transitionIssue:
    issueKey: DEV-123
    transitionId: "31"
    comment: Moving to In Progress
    output: result

Add a Comment

- Jira.addComment:
    issueKey: DEV-123
    body: "This issue has been reviewed."
    output: comment

MCP Setup

In the jira-mcp workspace, go to Settings > Advanced and set the MCP Api Key field to a strong key of your choice
Open your AI Knowledge project
Go to Advanced > Tools
Click Add and select the MCP tab
Enter the MCP endpoint URL
In the Headers field, add your credentials:

Jira Cloud:

{
  "mcp-api-key": "your-mcp-api-key",
  "baseurl": "https://yoursite.atlassian.net",
  "email": "your-email@example.com",
  "apitoken": "your-api-token"
}

Jira Data Center:

{
  "mcp-api-key": "your-mcp-api-key",
  "baseurl": "https://jira.yourcompany.com",
  "personaltoken": "your-personal-access-token"
}

Authentication Methods

The MCP server supports 3 authentication methods (checked in priority order):

1. HTTP Headers (per-request)

Pass Jira credentials directly in HTTP headers alongside mcp-api-key. Useful for MCP clients that manage credentials externally.

2. User Session (per-user)

Call the configureJira tool to store credentials in the user’s platform secrets. Credentials persist across requests for that user.

3. Workspace Config (shared)

Set credentials in workspace secrets. All users share the same Jira connection.

	Jira Cloud	Jira Data Center
Base URL	`https://yoursite.atlassian.net`	`https://jira.yourcompany.com`
Auth type	Basic Auth (email + API token)	Bearer token (PAT)
Headers	`baseurl`, `email`, `apitoken`	`baseurl`, `personaltoken`
Secrets	`jiraBaseUrl`, `jiraType`, `jiraEmail`, `jiraApiToken`	`jiraBaseUrl`, `jiraType`, `jiraPersonalAccessToken`

Available Tools

Issue Operations

Tool	Description
`searchJira`	Search issues using JQL
`getIssue`	Get issue details by key
`createIssue`	Create a new issue
`updateIssue`	Update an existing issue
`deleteIssue`	Delete an issue

Workflow Operations

Tool	Description
`getTransitions`	Get available status transitions
`transitionIssue`	Change issue status
`addComment`	Add a comment to an issue
`addAttachment`	Add an attachment to an issue

Project Operations

Tool	Description
`listProjects`	List accessible projects
`getProject`	Get project details

Configuration

Tool	Description
`configureJira`	Configure Jira credentials per-user

JSON-RPC Examples

Search Issues

{
  "name": "searchJira",
  "arguments": {
    "jql": "project = DEV AND status = \"In Progress\"",
    "maxResults": 10
  }
}

Get Issue Details

{
  "name": "getIssue",
  "arguments": {
    "issueKey": "DEV-123"
  }
}

Create an Issue

{
  "name": "createIssue",
  "arguments": {
    "projectKey": "DEV",
    "issueType": "Task",
    "summary": "Implement new feature",
    "description": "Detailed description here",
    "priority": "High"
  }
}

Transition Issue Status

{
  "name": "transitionIssue",
  "arguments": {
    "issueKey": "DEV-123",
    "transitionId": "31",
    "comment": "Moving to In Progress"
  }
}

Output Formats

All tools support an outputFormat parameter:

verbose (default) - Human-readable text for LLM consumption
structured - Machine-readable JSON in structuredContent
both - Both text and structured content

Error Handling

HTTP Status	Error	Solution
401	Unauthorized	Verify API token or PAT
403	Forbidden	Check Jira project permissions
404	Not Found	Verify issue key or project exists
429	Rate Limited	Wait and retry

External Resources

Jira Cloud REST API

Official API documentation for Jira Cloud

Jira Data Center REST API

Official API documentation for Jira Data Center

Atlassian API Tokens

Generate API tokens for Jira Cloud

MCP Specification

Model Context Protocol specification

Integration Overview

Apps Marketplace

Issue Management

Workflow Operations

Project Access

​Prerequisites

​Installation

​Configuration

​Jira Cloud

​Jira Data Center

​Available Automations

​Issue Operations

​Workflow Operations

​Project Operations

​DSUL Examples

​Search Issues

​Get Issue Details

​Create an Issue

​Transition Issue Status

​Add a Comment

​MCP Setup

​Authentication Methods

​1. HTTP Headers (per-request)

​2. User Session (per-user)

​3. Workspace Config (shared)

​Available Tools

​Issue Operations

​Workflow Operations

​Project Operations

​Configuration

​JSON-RPC Examples

​Search Issues

​Get Issue Details

​Create an Issue

​Transition Issue Status

​Output Formats

​Error Handling

​External Resources

Jira Cloud REST API

Jira Data Center REST API

Atlassian API Tokens

MCP Specification

Prerequisites

Installation

Configuration

Jira Cloud

Jira Data Center

Available Automations

Issue Operations

Workflow Operations

Project Operations

DSUL Examples

Search Issues

Get Issue Details

Create an Issue

Transition Issue Status

Add a Comment

MCP Setup

Authentication Methods

1. HTTP Headers (per-request)

2. User Session (per-user)

3. Workspace Config (shared)

Available Tools

Issue Operations

Workflow Operations

Project Operations

Configuration

JSON-RPC Examples

Search Issues

Get Issue Details

Create an Issue

Transition Issue Status

Output Formats

Error Handling

External Resources