Локальная настройка n8n + Model Context Protocol (MCP) для автоматизации Jira

В этой статье вы пошагово развернёте n8n в контейнере, получите персональный токен Atlassian API и подключите MCP-клиент, чтобы ваши AI-агенты могли безопасно выполнять действия в Jira.

1. Зачем всё это?

MCP — открытый протокол, который даёт крупным языковым моделям стандартизированный способ подключаться к внешним инструментам и данным. Вместо десятков разных интеграций достаточно «одного» MCP-клиента, чтобы агент видел, какие операции доступны, и вызывал их по имени.

Для Jira это удобно тем, что:

• права доступа регулируются самим токеном, а не кодом сценария;
• весь трафик остаётся локально (если сервер MCP развёрнут у вас);
• в одном workflow можно комбинировать Jira, GitHub, Notion и десятки других MCP-серверов — их каталог постоянно пополняется сообществом.

2. Устанавливаем n8n локально

Требования: Docker Desktop (Windows/Mac) или docker-engine + docker-compose (Linux).

1. Склонируйте или скачайте из нашего репозитория файлы Dockerfile и docker-compose.yml в одну папку.
2. Откройте терминал в этой папке и выполните:
   docker-compose down # остановить прежний контейнер, если был
docker-compose build --no-cache
docker-compose up -d
   
3. После запуска откройте http://localhost:5678, создайте аккаунт и введите бесплатный activation key (пришлют на почту).
4. В интерфейсе n8n перейдите Settings → Community Nodes → Install и установите пакет n8n-nodes-mcp.

3. Получаем Jira API Token

1. Зайдите в Atlassian-профиль: https://id.atlassian.com/manage-profile/security/api-tokens.
2. Нажмите Create API token, задайте имя, срок действия и подтвердите.
3. Скопируйте токен (он отобразится только один раз) и сохраните в менеджере паролей.

4. Создаём workflow в n8n

1. Новый Workflow → Add Node → AI Agent.
2. Add Node → Other → MCP Client Tool
   • Кликаем Edit Credentials
   • Command: uvx
   • Arguments: mcp-atlassian —jira-url=JIRA_URL —jira-username=JIRA_EMAIL —jira-token=JIRA_TOKEN
     
   • Пример:
     • JIRA_URL = https://acme.atlassian.net
     • JIRA_EMAIL = alex@acme.com
     • JIRA_TOKEN = ATAtlassianPat1234567890ABCDEFGHIJ
3. Сохраняем креды, называем ноду Atlassian Get Tools, в поле Operation выбираем List Tools, сохраняем.
4. Снова создаем Add Node → Other → MCP Client Tool → называем Atlassian Use Tools → Operation: Execute Tool.
   • Tool Name → Expression:
     • {{ $fromAI(«tool», «the selected tool to use») }}
   • Tool Parameters → Expression:
     • {{ $fromAI(‘Tool_Parameters’, «, ‘json’) }}
5. Добавьте Memory и Model к агенту и соедините узлы

5. Проверяем

Запустите workflow и напишите в чат агента:

Найди задачу PROJ-123 в Jira и покажи её статус и ответственного.

Алгоритм будет таким:

1. Аgent спрашивает Atlassian Get Tools – «какие операции доступны?».
2. Получает список (например getIssue, searchIssues, transitionIssue).
3. Избирает нужный инструмент, передаёт имя и параметры во вторую MCP-ноду.
4. Atlassian Use Tools отправляет REST-запрос через mcp-atlassian, получает JSON с задачей.
5. Ответ возвращается агенту, он формулирует итог для пользователя.

---

6. Что дальше?

• Подключите другие MCP-серверы (см. каталог GitHub) — например GitHub, Notion, Slack.
• Используйте Cron-триггеры, чтобы агент сам проверял новые Jira-тикеты.
• Храните конфиденциальные cred-ы в Vault или в секретах Docker.

Локальная связка n8n + MCP даёт гибкость облачного сервиса без утечки данных: вся логика и ключи остаются у вас, а добавить новый инструмент теперь — пара минут. Продолжайте эксперименты! 🚀