Atlassian Jira

Connect to Atlassian Jira to perform issue tracking and project management.

Key Features

• Project and issue management
• Issue search using JQL
• Issue creation, updates, and deletion
• Issue status transitions and assignments
• User information queries
• Comment retrieval and addition
• Agile board and sprint management
• Bulk operation support

Basic Information

Authentication Method

Authenticate using OAuth 2.0.

After you approve access on the Atlassian OAuth consent screen with your Jira account, AIP stores the access token and the accessible Atlassian site information.

Input Parameters

• URL (required): Atlassian site URL to connect

Additional Settings

• optimizeTokenUsages (optional): Converts ADF content to Markdown to reduce token usage. ADF-specific formatting that Markdown does not support, such as complex tables, advanced styling, and extensions, may be lost during conversion.

Supported MCP Tools

get_projects

Returns a paginated list of projects visible to the user.

bulk_get_users

Retrieves information for multiple users by account ID.

search_issues

Search for issues using JQL (Jira Query Language) with enhanced options.

bulk_fetch_issues

Retrieves information for multiple issues by ID or key.

bulk_transition_issue_statuses

Transitions multiple issues to a new status.

assign_issue

Assigns an issue to a user or unassigns it.

get_comments

Retrieves comments for an issue.

create_issue

Creates a new issue in Jira.

update_issue

Updates an existing issue.

delete_issue

Deletes an issue.

search_fields

Searches for Jira fields.

add_comment

Adds a comment to an issue.

get_agile_boards

Retrieves a list of agile boards from Jira.

get_board_issues

Retrieves issues from a specific agile board.

get_sprints_from_board

Retrieves a list of sprints from a specific agile board.

get_sprint_issues

Retrieves issues from a specific sprint.

Usage Example

For example,

• When you input “Search for issues in a specific project” as a prompt,
• The LLM calls the search_issues tool through MCP to search for issues using JQL queries.
• Then, it responds in the chat based on the tool call results.

OAuth Connection Method

1. Add the Jira MCP Integration in AIP.
2. Sign in with the Jira account you want to use on the Atlassian OAuth consent screen.
3. Review and approve the requested permissions.
4. Confirm that the Atlassian site URL is correct.

Precautions

• It is recommended to grant only the minimum necessary permissions.
• It is recommended to use HTTPS for the URL.
• When using optimizeTokenUsages, some ADF-specific formatting may be lost during Markdown conversion.
• Follow Jira’s query syntax when writing JQL queries.