Jira MCP Server (для бесплатного тарифа)

Небольшой MCP-сервер, который позволяет MCP-клиенту (Claude Desktop или любому другому MCP-клиенту) читать, создавать, обновлять, комментировать и переводить по статусам задачи Jira. Создан и протестирован на бесплатном тарифе Jira Cloud — платная подписка Jira не нужна.

Предоставляемые инструменты

1. Получите бесплатный сайт Jira Cloud

1. Перейдите на https://www.atlassian.com/software/jira и зарегистрируйтесь (бесплатно, до 10 пользователей, безлимитные проекты).

2. Создайте проект и запишите его ключ проекта (например, PROJ) — он показан рядом с названием проекта.

3. Создайте API-токен на https://id.atlassian.com/manage-profile/security/api-tokens.

2. Установите зависимости

cd jira-mcp-server
python3 -m venv venv
source venv/bin/activate        # on Windows: venv\Scripts\activate
pip install -r requirements.txt

3. Настройте учётные данные

Скопируйте .env.example в .env и заполните свои значения или просто экспортируйте их в своей оболочке:

export JIRA_BASE_URL=https://yourcompany.atlassian.net
export JIRA_EMAIL=you@example.com
export JIRA_API_TOKEN=your-api-token-here

4. Проверьте напрямую (Claude Desktop не нужен)

Измените PROJECT_KEY / ISSUE_KEY в начале test_client.py, чтобы они соответствовали вашему проекту Jira, затем:

python test_client.py

Этот скрипт запускает jira_server.py как подпроцесс через stdio (так же, как это сделал бы настоящий MCP-клиент), выводит список доступных инструментов и проверяет get_issue, search_issues и create_issue на вашем реальном сайте Jira.

5. Подключите его к Claude Desktop (необязательно)

Добавьте это в конфигурацию MCP вашего Claude Desktop (claude_desktop_config.json — Settings → Developer → Edit Config):

{
  "mcpServers": {
    "jira": {
      "command": "/absolute/path/to/jira-mcp-server/venv/bin/python",
      "args": ["/absolute/path/to/jira-mcp-server/jira_server.py"],
      "env": {
        "JIRA_BASE_URL": "https://yourcompany.atlassian.net",
        "JIRA_EMAIL": "you@example.com",
        "JIRA_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Перезапустите Claude Desktop и спросите его, например: «какой статус у PROJ-1?» — он должен вызвать инструмент get_issue.

Примечания / подводные камни

• Jira API v3 хранит описания и комментарии в Atlassian Document Format (ADF), а не в виде обычного текста. Сервер выполняет преобразование за вас в обе стороны.

• issue_type в create_issue должен точно совпадать с типом, настроенным в этом проекте (обычно Task, Bug, Story, Epic) — проверьте типы задач своего проекта, если получите ошибку «issuetype».

• Бесплатный тариф ограничивает вас 100 запусками автоматизации в месяц и 2 ГБ хранилища — для такого рода ручного/API-тестирования это неважно, но знать стоит.

• Этот сервер использует транспорт stdio, то есть работает только локально и запускается тем MCP-клиентом, который с ним общается, — это не публичный веб-сервис, а самый простой и распространённый способ тестирования MCP.