МКП Atlassian

Сервер Model Context Protocol (MCP) для продуктов Atlassian (Confluence и Jira). Эта интеграция поддерживает как Confluence & Jira Cloud, так и развертывания Server/Data Center.

Пример использования

Попросите вашего помощника на основе искусственного интеллекта:

📝 Автоматические обновления Jira — «Обновляйте Jira из наших заметок о встречах»
🔍 Поиск Confluence на базе искусственного интеллекта — «Найдите наше руководство по OKR в Confluence и обобщите его»
🐛 Фильтрация проблем Smart Jira — «Покажи мне срочные ошибки в проекте PROJ за прошлую неделю»
📄 Создание и управление контентом — «Создание технического дизайн-документа для функции XYZ»

Демонстрация функций

https://github.com/user-attachments/assets/35303504-14c6-4ae4-913b-7c25ea511c3e

https://github.com/user-attachments/assets/7fe9c488-ad0c-4876-9b54-120b666bb785

Совместимость

Продукт	Тип развертывания	Статус поддержки
Слияние	Облако	✅ Полностью поддерживается
Слияние	Сервер/Центр обработки данных	✅ Поддерживается (версия 6.0+)
Джира	Облако	✅ Полностью поддерживается
Джира	Сервер/Центр обработки данных	✅ Поддерживается (версия 8.14+)

Краткое руководство пользователя

1. Настройка аутентификации

MCP Atlassian поддерживает три метода аутентификации:

A. Аутентификация с помощью API-токена (облако)

Перейдите по ссылке https://id.atlassian.com/manage-profile/security/api-tokens
Нажмите «Создать токен API» , дайте ему имя.
Немедленно скопируйте токен

B. Персональный токен доступа (сервер/центр обработки данных)

Перейдите в свой профиль (аватар) → Профиль → Персональные токены доступа
Нажмите «Создать токен» , дайте ему имя и установите срок действия.
Немедленно скопируйте токен

C. Аутентификация OAuth 2.0 (только облако)

Создайте интеграцию OAuth 2.0 в Atlassian:
- Перейдите по ссылке https://developer.atlassian.com/console/myapps/
- Нажмите «Создать» и выберите «Интеграция OAuth 2.0».
- Следуйте указаниям мастера, чтобы создать свое приложение.
- При необходимости настройте разрешения для Jira и Confluence.
- Добавьте URL-адрес обратного вызова (например, http://localhost:8080/callback )
Запустите помощник авторизации OAuth:
uvx mcp-atlassian@latest --oauth-setup
Это проведет вас через процесс настройки, запросив необходимые значения (идентификатор клиента, секретный код клиента и т. д.).Кроме того, вы можете клонировать репозиторий и запустить скрипт напрямую:
# Clone the repository if you haven't already git clone https://github.com/sooperset/mcp-atlassian.git cd mcp-atlassian # Run the OAuth authorization script python scripts/oauth_authorize.py \ --client-id YOUR_CLIENT_ID \ --client-secret YOUR_CLIENT_SECRET \ --redirect-uri "http://localhost:8080/callback" \ --scope "read:jira-work write:jira-work read:confluence-space.summary write:confluence-content"
Следуйте подсказкам браузера для авторизации приложения.
После успешной авторизации добавьте отображаемые переменные среды в ваш файл .env

2. Установка

MCP Atlassian распространяется как образ Docker. Это рекомендуемый способ запуска сервера, особенно для интеграции IDE. Убедитесь, что у вас установлен Docker.

# Pull Pre-built Image
docker pull ghcr.io/sooperset/mcp-atlassian:latest

Интеграция с IDE

MCP Atlassian предназначен для использования с помощниками на базе искусственного интеллекта посредством интеграции с IDE.

[!СОВЕТ] Для Claude Desktop : найдите и отредактируйте файл конфигурации напрямую:
Windows : %APPDATA%\Claude\claude_desktop_config.json
macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Linux : ~/.config/Claude/claude_desktop_config.json
Для курсора : Откройте Настройки → MCP → + Добавить новый глобальный сервер MCP

Методы конфигурации

Существует два основных подхода к настройке контейнера Docker:

Прямая передача переменных (показано в примерах ниже)
Использование файла среды с флагом --env-file (показано в сворачиваемых разделах)

[!ПРИМЕЧАНИЕ] К общим переменным среды относятся:
CONFLUENCE_SPACES_FILTER : Фильтр по пробельным клавишам (например, «DEV,TEAM,DOC»)
JIRA_PROJECTS_FILTER : Фильтр по ключам проекта (например, «PROJ,DEV,SUPPORT»)
READ_ONLY_MODE : установите значение «true», чтобы отключить операции записи.
MCP_VERBOSE : установите значение «true» для более подробного протоколирования.
ENABLED_TOOLS : разделенный запятыми список названий инструментов, которые необходимо включить (например, «confluence_search,jira_get_issue»).
Все доступные параметры см. в файле .env.example .

Примеры конфигурации

Метод 1 (передача переменных напрямую):

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "CONFLUENCE_URL",
        "-e", "CONFLUENCE_USERNAME",
        "-e", "CONFLUENCE_API_TOKEN",
        "-e", "JIRA_URL",
        "-e", "JIRA_USERNAME",
        "-e", "JIRA_API_TOKEN",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_confluence_api_token",
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_jira_api_token"
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env-file",
        "/path/to/your/mcp-atlassian.env",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ]
    }
  }
}

Для развертываний на сервере/в центре обработки данных используйте прямую передачу переменных:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "CONFLUENCE_URL",
        "-e", "CONFLUENCE_PERSONAL_TOKEN",
        "-e", "CONFLUENCE_SSL_VERIFY",
        "-e", "JIRA_URL",
        "-e", "JIRA_PERSONAL_TOKEN",
        "-e", "JIRA_SSL_VERIFY",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "CONFLUENCE_URL": "https://confluence.your-company.com",
        "CONFLUENCE_PERSONAL_TOKEN": "your_confluence_pat",
        "CONFLUENCE_SSL_VERIFY": "false",
        "JIRA_URL": "https://jira.your-company.com",
        "JIRA_PERSONAL_TOKEN": "your_jira_pat",
        "JIRA_SSL_VERIFY": "false"
      }
    }
  }
}

[!ПРИМЕЧАНИЕ] Устанавливайте CONFLUENCE_SSL_VERIFY и JIRA_SSL_VERIFY на «false», только если у вас есть самоподписанные сертификаты.

Для Atlassian Cloud с OAuth 2.0:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "CONFLUENCE_URL",
        "-e", "JIRA_URL",
        "-e", "ATLASSIAN_OAUTH_CLIENT_ID",
        "-e", "ATLASSIAN_OAUTH_CLIENT_SECRET",
        "-e", "ATLASSIAN_OAUTH_REDIRECT_URI",
        "-e", "ATLASSIAN_OAUTH_SCOPE",
        "-e", "ATLASSIAN_OAUTH_CLOUD_ID",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "JIRA_URL": "https://your-company.atlassian.net",
        "ATLASSIAN_OAUTH_CLIENT_ID": "your_client_id",
        "ATLASSIAN_OAUTH_CLIENT_SECRET": "your_client_secret",
        "ATLASSIAN_OAUTH_REDIRECT_URI": "http://localhost:8080/callback",
        "ATLASSIAN_OAUTH_SCOPE": "read:jira-work write:jira-work read:confluence-space.summary write:confluence-content",
        "ATLASSIAN_OAUTH_CLOUD_ID": "your_cloud_id"
      }
    }
  }
}

[!TIP] Запустите скрипт scripts/oauth_authorize.py , чтобы получить токен доступа и идентификатор облака. Аутентификация OAuth 2.0 имеет приоритет над другими методами аутентификации, если настроена.

MCP Atlassian поддерживает маршрутизацию запросов API через стандартные HTTP/HTTPS/SOCKS прокси. Настройте с помощью переменных среды:

Поддерживает стандартные HTTP_PROXY , HTTPS_PROXY , NO_PROXY , SOCKS_PROXY .
Доступны переопределения для конкретных служб (например, JIRA_HTTPS_PROXY , CONFLUENCE_NO_PROXY ).
Специфичные для сервиса переменные переопределяют глобальные переменные для этого сервиса.

Добавьте соответствующие переменные прокси в разделы args (используя -e ) и env вашей конфигурации MCP:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "... existing Confluence/Jira vars",
        "-e", "HTTP_PROXY",
        "-e", "HTTPS_PROXY",
        "-e", "NO_PROXY",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "... existing Confluence/Jira vars": "...",
        "HTTP_PROXY": "http://proxy.internal:8080",
        "HTTPS_PROXY": "http://proxy.internal:8080",
        "NO_PROXY": "localhost,.your-company.com"
      }
    }
  }
}

Учетные данные в URL-адресах прокси маскируются в журналах. Если вы установите NO_PROXY , он будет учитываться для запросов к соответствующим хостам.

Только для Confluence Cloud:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "CONFLUENCE_URL",
        "-e", "CONFLUENCE_USERNAME",
        "-e", "CONFLUENCE_API_TOKEN",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token"
      }
    }
  }
}

Для Confluence Server/DC используйте:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "CONFLUENCE_URL",
        "-e", "CONFLUENCE_PERSONAL_TOKEN",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "CONFLUENCE_URL": "https://confluence.your-company.com",
        "CONFLUENCE_PERSONAL_TOKEN": "your_personal_token"
      }
    }
  }
}

Только для Jira Cloud:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "JIRA_URL",
        "-e", "JIRA_USERNAME",
        "-e", "JIRA_API_TOKEN",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_api_token"
      }
    }
  }
}

Для Jira Server/DC используйте:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "JIRA_URL",
        "-e", "JIRA_PERSONAL_TOKEN",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "JIRA_URL": "https://jira.your-company.com",
        "JIRA_PERSONAL_TOKEN": "your_personal_token"
      }
    }
  }
}

Конфигурация транспорта SSE

Запустите сервер вручную в терминале:
docker run --rm -p 9000:9000 \ --env-file /path/to/your/.env \ ghcr.io/sooperset/mcp-atlassian:latest \ --transport sse --port 9000 -vv
Настройте IDE для подключения к работающему серверу через его URL-адрес:
{ "mcpServers": { "mcp-atlassian-sse": { "url": "http://localhost:9000/sse" } } }

Инструменты

Ключевые инструменты

Инструменты слияния

confluence_search : Поиск контента Confluence с использованием CQL
confluence_get_page : Получить содержимое определенной страницы
confluence_create_page : Создать новую страницу
confluence_update_page : Обновить существующую страницу

Инструменты Jira

jira_get_issue : Получить сведения о конкретной проблеме
jira_search : Поиск проблем с использованием JQL
jira_create_issue : Создать новую задачу
jira_update_issue : Обновить существующую задачу
jira_transition_issue : Перевести задачу в новый статус
jira_add_comment : Добавить комментарий к задаче

Инструменты, отмеченные знаком *, доступны только в Jira Cloud.

Инструменты слияния	Инструменты Jira
`confluence_search`	`jira_get_issue`
`confluence_get_page`	`jira_search`
`confluence_get_page_children`	`jira_get_project_issues`
`confluence_get_comments`	`jira_create_issue`
`confluence_create_page`	`jira_batch_create_issues`
`confluence_update_page`	`jira_update_issue`
`confluence_delete_page`	`jira_delete_issue`
`confluence_get_labels`	`jira_get_transitions`
`confluence_add_label`	`jira_transition_issue`
	`jira_add_comment`
	`jira_add_worklog`
	`jira_get_worklog`
	`jira_batch_get_changelogs` *
	`jira_download_attachments`
	`jira_link_to_epic`
	`jira_get_agile_boards`
	`jira_get_board_issues`
	`jira_get_sprints_from_board`
	`jira_get_sprint_issues`
	`jira_create_sprint`
	`jira_update_sprint`
	`jira_get_issue_link_types`
	`jira_create_issue_link`
	`jira_remove_issue_link`

Фильтрация инструментов и контроль доступа

Сервер предоставляет два способа управления доступом к инструментам:

Фильтрация инструментов : используйте флаг --enabled-tools или переменную среды ENABLED_TOOLS , чтобы указать, какие инструменты должны быть доступны:
# Via environment variable ENABLED_TOOLS="confluence_search,jira_get_issue,jira_search" # Or via command line flag docker run ... --enabled-tools "confluence_search,jira_get_issue,jira_search" ...
Управление чтением/записью : инструменты классифицируются как операции чтения или записи. Когда включен READ_ONLY_MODE , доступны только операции чтения независимо от настройки ENABLED_TOOLS .

Устранение неполадок и отладка

Общие проблемы

Ошибки аутентификации :
- Для облака: проверьте свои токены API (не пароль учетной записи)
- Для сервера/центра обработки данных: убедитесь, что ваш персональный токен доступа действителен и не просрочен.
- Для старых серверов Confluence: некоторые старые версии требуют базовой аутентификации с CONFLUENCE_USERNAME и CONFLUENCE_API_TOKEN (где token — ваш пароль)
Проблемы с сертификатом SSL : если вы используете сервер/центр обработки данных и столкнулись с ошибками SSL, установите CONFLUENCE_SSL_VERIFY=false или JIRA_SSL_VERIFY=false
Ошибки прав доступа : убедитесь, что у вашей учетной записи Atlassian достаточно прав для доступа к пространствам/проектам.

Инструменты отладки

# Using MCP Inspector for testing
npx @modelcontextprotocol/inspector uvx mcp-atlassian ...

# For local development version
npx @modelcontextprotocol/inspector uv --directory /path/to/your/mcp-atlassian run mcp-atlassian ...

# View logs
# macOS
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
# Windows
type %APPDATA%\Claude\logs\mcp*.log | more

Безопасность

Никогда не делитесь токенами API
Сохраняйте файлы .env в безопасности и конфиденциальности
Ознакомьтесь с рекомендациями SECURITY.md.

Внося вклад

Мы приветствуем вклад в MCP Atlassian! Если вы хотите внести свой вклад:

Подробные инструкции по настройке разработки см. в нашем руководстве CONTRIBUTING.md .
Внесите изменения и отправьте запрос на извлечение.

Мы используем предварительные проверки качества кода и следуем семантическому версионированию для релизов.

Лицензия

Лицензия MIT - см. файл LICENSE . Это не официальный продукт Atlassian.

MCP Atlassian

Integrations