MCP Atlassian
MCP-сервер для Jira и Confluence: AI-агент может читать задачи, создавать тикеты, обновлять статусы и искать документацию в Confluence через естественный язык.
Требуется Jira/Confluence API Token (Atlassian → Account Settings → Security → API tokens).
# Claude Desktop — claude_desktop_config.json:
{
"mcpServers": {
"atlassian": {
"command": "uvx",
"args": ["mcp-atlassian"],
"env": {
"JIRA_URL": "https://your-domain.atlassian.net",
"JIRA_USERNAME": "email@example.com",
"JIRA_API_TOKEN": "ВАШ_ТОКЕН"
}
}
}
}
# Claude Code (CLI):
claude mcp add atlassian -e JIRA_URL=https://your-domain.atlassian.net -e JIRA_USERNAME=email@example.com -e JIRA_API_TOKEN=ВАШ_ТОКЕН -- uvx mcp-atlassian
# OpenCode — ~/.config/opencode/opencode.json:
{
"mcp": {
"atlassian": {
"type": "local",
"command": ["uvx", "mcp-atlassian"],
"environment": {
"JIRA_URL": "https://your-domain.atlassian.net",
"JIRA_USERNAME": "email@example.com",
"JIRA_API_TOKEN": "ВАШ_ТОКЕН"
}
}
}
}
MCP Atlassian
Сервер Model Context Protocol (MCP) для продуктов Atlassian (Confluence и Jira). Поддерживает развертывания как в облаке (Cloud), так и на серверах/в центрах обработки данных (Server/Data Center).
https://github.com/user-attachments/assets/35303504-14c6-4ae4-913b-7c25ea511c3e
Демо Confluence
https://github.com/user-attachments/assets/7fe9c488-ad0c-4876-9b54-120b666bb785
Быстрый старт
1. Получите ваш API-токен
Перейдите по адресу https://id.atlassian.com/manage-profile/security/api-tokens и создайте токен.
Для серверных/центров обработки данных используйте вместо этого Персональный токен доступа. См. раздел Аутентификация.
2. Настройте вашу IDE
Добавьте в конфигурацию MCP вашего Claude Desktop или Cursor:
{
"mcpServers": {
"mcp-atlassian": {
"command": "uvx",
"args": ["mcp-atlassian"],
"env": {
"JIRA_URL": "https://your-company.atlassian.net",
"JIRA_USERNAME": "your.email@company.com",
"JIRA_API_TOKEN": "your_api_token",
"CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
"CONFLUENCE_USERNAME": "your.email@company.com",
"CONFLUENCE_API_TOKEN": "your_api_token"
}
}
}
}
Для серверных/центров обработки данных: используйте
JIRA_PERSONAL_TOKENвместоJIRA_USERNAME+JIRA_API_TOKEN. Подробности см. в разделе Аутентификация.
3. Начните использовать
Попросите вашего ИИ-ассистента: - "Найти задачи, назначенные мне в проекте PROJ" - "Поискать в Confluence документы по адаптации сотрудников" - "Создать тикет на баг для проблемы с входом" - "Обновить статус задачи PROJ-123 на 'Готово'"
Документация
Полная документация доступна на сайте mcp-atlassian.soomiles.com.
Документация также доступна в формате llms.txt, который удобен для чтения LLM:
- llms.txt — карта сайта документации
- llms-full.txt — полная документация
| Тема | Описание |
|---|---|
| Установка | uvx, Docker, pip, из исходного кода |
| Аутентификация | API-токены, Персональный токен доступа (PAT), OAuth 2.0 |
| Конфигурация | Настройка IDE, переменные окружения |
| HTTP-транспорт | SSE, streamable-http, поддержка нескольких пользователей |
| Справочник инструментов | Все инструменты для Jira и Confluence |
| Решение проблем | Типичные проблемы и отладка |
Совместимость
| Продукт | Развертывание | Поддержка |
|---|---|---|
| Confluence | Cloud | Полная поддержка |
| Confluence | Server/Data Center | Поддерживается (v6.0+) |
| Jira | Cloud | Полная поддержка |
| Jira | Server/Data Center | Поддерживается (v8.14+) |
Основные инструменты
| Jira | Confluence |
|---|---|
jira_search - Поиск с помощью JQL |
confluence_search - Поиск с помощью CQL |
jira_get_issue - Получить детали задачи |
confluence_get_page - Получить содержимое страницы |
jira_create_issue - Создать задачи |
confluence_create_page - Создать страницы |
jira_update_issue - Обновить задачи |
confluence_update_page - Обновить страницы |
jira_transition_issue - Изменить статус |
confluence_add_comment - Добавить комментарии |
Всего 72 инструмента — Полный список см. в Справочнике инструментов.
Безопасность
Никогда не делитесь API-токенами. Храните файлы .env в безопасности. См. SECURITY.md.
Участие в разработке
См. CONTRIBUTING.md для информации о настройке среды разработки.
Лицензия
MIT - См. LICENSE. Не является официальным продуктом Atlassian.