Jira MCP Server for Cursor
Сервер Jira MCP для курсора
Сервер MCP на базе TypeScript, который интегрируется с Jira, позволяя Cursor взаимодействовать с тикетами Jira.
Функции
Список тикетов Jira
Получить информацию о билете
Получить комментарии к билету
Создать новые тикеты
Добавить комментарии к тикетам
Обновить статус тикета
Полная поддержка протокола MCP для интеграции курсора
Related MCP server: JIRA MCP Server
Настраивать
Установка через Smithery
Чтобы автоматически установить Jira MCP Server для Cursor for Claude Desktop через Smithery :
npx -y @smithery/cli install @kornbed/jira-mcp-server --client claudeУстановить зависимости:
npm installСоздайте файл
.envна основе.env.exampleи заполните свои учетные данные Jira:
JIRA_HOST=https://your-domain.atlassian.net
JIRA_EMAIL=your-email@example.com
JIRA_API_TOKEN=your-api-token
PORT=3000Чтобы получить токен Jira API:
Авторизуйтесь на https://id.atlassian.com/manage/api-tokens
Нажмите «Создать токен API».
Скопируйте токен и вставьте его в файл
.env
Разработка
Запустите сервер разработки:
npm run devПостроить и запустить
Создайте проект:
npm run buildЗапустите сервер:
npm startИнтеграция курсора
Чтобы использовать этот MCP-сервер с Cursor, у вас есть два варианта:
Вариант 1: Интеграция на основе команд (рекомендуется)
Создайте проект:
npm run buildОткройте настройки курсора:
Нажмите на меню курсора.
Выберите «Настройки» (или используйте сочетание клавиш)
Перейдите в раздел «Расширения» или «Интеграции».
Добавьте конфигурацию MCP:
{
"mcpServers": {
"jira": {
"command": "node",
"args": ["/path/to/jira-mcp-cursor/dist/server.js"]
}
}
}Замените /path/to/jira-mcp-cursor на абсолютный путь к вашему проекту.
Вариант 2: интеграция на основе HTTP (альтернативный)
Запустите сервер MCP (если он еще не запущен):
npm startОткройте настройки курсора:
Нажмите на меню курсора.
Выберите «Настройки» (или используйте сочетание клавиш)
Перейдите в раздел «Расширения» или «Интеграции».
Добавьте конфигурацию MCP:
{
"mcpServers": {
"jira": {
"url": "http://localhost:3000",
"capabilities": [
"list_tickets",
"get_ticket",
"get_comments",
"create_ticket",
"update_status",
"add_comment"
]
}
}
}
}Использование Jira в курсоре
После настройки сервера MCP вы можете использовать команды Jira непосредственно в Cursor:
/jira list— список ваших тикетов/jira view TICKET-123- Просмотреть детали билета/jira comments TICKET-123- Получить комментарии к тикетам/jira create— Создать новый тикет/jira comment TICKET-123— Добавить комментарий/jira status TICKET-123— Обновить статус тикета
Поддержка протокола MCP
Сервер реализует протокол Model-Client-Protocol (MCP), требуемый Cursor:
Stdio-коммуникация для интеграции на основе команд
Регистрация инструмента для операций Jira
Конечные точки API
Список билетов
Извлекает список тикетов Jira, при необходимости отфильтрованный с помощью запроса JQL.
Конечная точка: GET /api/tickets
Параметры запроса:
Параметр | Тип | Необходимый | Описание |
jql | нить | Нет | Строка Jira Query Language (JQL) для фильтрации тикетов |
Пример запроса:
GET /api/tickets?jql=project=TEST+AND+status=OpenПример ответа:
TEST-123: Example ticket (Open)
TEST-124: Another ticket (In Progress)Получить билет
Получает подробную информацию о конкретном тикете.
Конечная точка: GET /api/tickets/:id
Параметры пути:
Параметр | Тип | Необходимый | Описание |
идентификатор | нить | Да | Идентификатор тикета Jira (например, TEST-123) |
Пример запроса:
GET /api/tickets/TEST-123Пример ответа:
Key: TEST-123
Summary: Example ticket
Status: Open
Type: Task
Description:
Detailed ticket descriptionПолучить комментарии по билетам
Извлекает все комментарии для определенного тикета.
Конечная точка: GET /api/tickets/:id/comments
Параметры пути:
Параметр | Тип | Необходимый | Описание |
идентификатор | нить | Да | Идентификатор тикета Jira (например, TEST-123) |
Пример запроса:
GET /api/tickets/TEST-123/commentsПример ответа:
[3/20/2024, 10:00:00 AM] John Doe:
Comment text
---
[3/20/2024, 9:30:00 AM] Jane Smith:
Another comment
---Создать тикет
Создает новый тикет Jira.
Конечная точка: POST /api/tickets
Текст запроса:
Параметр | Тип | Необходимый | Описание |
краткое содержание | нить | Да | Краткое описание билета |
описание | нить | Да | Описание билета |
проектКлюч | нить | Да | Ключ проекта (например, ТЕСТ) |
issueType | нить | Да | Тип проблемы (например, Задача, Ошибка) |
Пример запроса:
POST /api/tickets
Content-Type: application/json
{
"summary": "New feature request",
"description": "Implement new functionality",
"projectKey": "TEST",
"issueType": "Task"
}Пример ответа:
Created ticket: TEST-124Добавить комментарий
Добавляет новый комментарий к существующему тикету.
Конечная точка: POST /api/tickets/:id/comments
Параметры пути:
Параметр | Тип | Необходимый | Описание |
идентификатор | нить | Да | Идентификатор тикета Jira (например, TEST-123) |
Текст запроса:
Параметр | Тип | Необходимый | Описание |
тело | нить | Да | Текст комментария |
Пример запроса:
POST /api/tickets/TEST-123/comments
Content-Type: application/json
{
"body": "This is a new comment"
}Пример ответа:
Added comment to TEST-123Обновить статус
Обновляет статус существующего тикета.
Конечная точка: POST /api/tickets/:id/status
Параметры пути:
Параметр | Тип | Необходимый | Описание |
идентификатор | нить | Да | Идентификатор тикета Jira (например, TEST-123) |
Текст запроса:
Параметр | Тип | Необходимый | Описание |
transitionId | нить | Да | Идентификатор перехода для выполнения |
Пример запроса:
POST /api/tickets/TEST-123/status
Content-Type: application/json
{
"transitionId": "21"
}Пример ответа:
Updated status of TEST-123Поиск билетов
Поиск билетов по указанным проектам с помощью текстового поиска.
Конечная точка: GET /api/tickets/search
Параметры запроса:
Параметр | Тип | Необходимый | Описание |
поискТекст | нить | Да | Текст для поиска в билетах |
проектKeys | нить | Да | Список ключей проекта, разделенных запятыми, для поиска |
maxResults | число | Нет | Максимальное количество возвращаемых результатов (по умолчанию: 50) |
Пример запроса:
GET /api/tickets/search?searchText=login+bug&projectKeys=TEST,PROD&maxResults=10Пример ответа:
Found 2 tickets matching "login bug"
[TEST] TEST-123: Login page bug
Status: Open (Updated: 3/20/2024, 10:00:00 AM)
Description:
Users unable to login using SSO
----------------------------------------
[PROD] PROD-456: Fix login performance
Status: In Progress (Updated: 3/19/2024, 3:30:00 PM)
Description:
Login page taking too long to load
----------------------------------------Available Tools
7 toolsadd_commentC
Add a comment to a Jira ticket
Inputs: ticketId (required), comment (required).
create_ticketC
Create a new Jira ticket
Inputs: ticket (required).
get_commentsB
Get comments for a specific Jira ticket
Inputs: ticketId (required).
get_ticketC
Get details of a specific Jira ticket
Inputs: ticketId (required).
list_ticketsB
List Jira tickets assigned to you
Inputs: jql.
search_ticketsB
Search for tickets in specific projects using text search
Inputs: searchText (required), projectKeys (required), maxResults.
update_statusB
Update the status of a Jira ticket
Inputs: ticketId (required), status (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a clearly distinct purpose targeting specific Jira operations: list_tickets vs. search_tickets differentiate between personal assignment and project-wide text search, while get_ticket vs. get_comments separate ticket details from comment retrieval. No tools appear to overlap in functionality, making misselection unlikely.
All tools follow a consistent verb_noun pattern using snake_case (e.g., add_comment, create_ticket, get_comments). The verbs are appropriately chosen for each action (add, create, get, list, search, update), creating a predictable and readable naming convention throughout the set.
With 7 tools, this server is well-scoped for Jira ticket management. Each tool earns its place by covering essential operations like creating, retrieving, listing, searching, updating status, and managing comments, without being overly sparse or bloated for the domain.
The tool set provides strong coverage for core Jira ticket workflows, including CRUD-like operations (create, get, list, update_status) and comment management. A minor gap exists in the lack of a tool to update ticket details beyond status (e.g., edit description or fields), but agents can work around this by creating new tickets or using comments.
Maintenance
Related MCP Connectors
Hosted Airtable MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Opinionated sprint tracker. Read/update tickets, sprints, velocity from Claude/Cursor/Zed.
Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.
Hosted Notion MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Related MCP Servers
- AlicenseBqualityDmaintenanceA TypeScript-based server that enables interaction with Jira, providing tools to execute JQL queries, manage tickets, list projects and statuses through natural language.1126MIT
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables seamless integration between Cursor IDE and JIRA, allowing users to retrieve issues, execute JQL searches, and log work through natural language interactions.-
- FlicenseNot gradedqualityDmaintenanceModel Context Protocol server that allows AI assistants to interact with Jira, supporting operations like creating tickets and fetching project information directly from the cursor.1-
- FlicenseAqualityDmaintenanceA Model Context Protocol (MCP) server that provides tools for interacting with Jira. Enables Cursor and other MCP clients to fetch tickets, manage linked tickets, and update ticket status.3-