MCP Atlassian — интеграция Confluence и Jira

Сервер для протокола MCP (Model Context Protocol), который предоставляет единый интерфейс для работы с Atlassian Confluence и Jira. Поддерживает облачные версии (Cloud) и серверные инсталляции (Server/Data Center).

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

Установка

Сервер можно установить одним из трёх способов:

Через uv (рекомендуется)

brew install uv
uvx mcp-atlassian

Через pip

pip install mcp-atlassian

Через Docker

git clone https://github.com/sooperset/mcp-atlassian.git
cd mcp-atlassian
docker build -t mcp/atlassian .

Настройка

Перед использованием получите токены аутентификации:

• Для Cloud: перейдите на страницу управления API-токенами — https://id.atlassian.com/manage-profile/security/api-tokens. Нажмите Create API token, дайте имя и скопируйте токен.
• Для Server/Data Center: в своём профиле → Profile → Personal Access Tokens. Создайте токен, задайте срок действия и скопируйте.

Пример запуска из командной строки

Cloud (можно использовать только Confluence, только Jira или оба сервиса):

uvx mcp-atlassian \
  --confluence-url https://your-company.atlassian.net/wiki \
  --confluence-username your.email@company.com \
  --confluence-token your_api_token \
  --jira-url https://your-company.atlassian.net \
  --jira-username your.email@company.com \
  --jira-token your_api_token

Server/Data Center:

uvx mcp-atlassian \
  --confluence-url https://confluence.your-company.com \
  --confluence-personal-token your_token \
  --jira-url https://jira.your-company.com \
  --jira-personal-token your_token

Дополнительные параметры

• --transport — тип транспорта: stdio (по умолчанию) или sse.
• --port — порт для SSE (по умолчанию 8000).
• --[no-]confluence-ssl-verify — отключение проверки SSL для Confluence Server/DC.
• --[no-]jira-ssl-verify — аналогично для Jira Server/DC.
• --confluence-spaces-filter — список ключей разделов Confluence через запятую для фильтрации поиска (например, DEV,TEAM,DOC).
• --jira-projects-filter — список ключей проектов Jira для фильтрации (например, PROJ,DEV,SUPPORT).
• --read-only — режим только для чтения (запрещает все операции записи).
• --verbose / -v / -vv — уровень логирования (INFO / DEBUG).

Все параметры можно задавать через переменные окружения — смотрите файл .env.example в репозитории.

Интеграция со средами разработки

Claude Desktop

Пример конфигурации для Cloud с uvx:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian",
        "--confluence-url=https://your-company.atlassian.net/wiki",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-company.atlassian.net",
        "--jira-username=your.email@company.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

Для Server/Data Center используйте --confluence-personal-token и --jira-personal-token. Аналогичные примеры для pip и Docker — в репозитории.

Cursor IDE

1. Откройте Settings → Features → MCP Servers.
2. Нажмите + Add new global MCP server.
3. В открывшемся файле ~/.cursor/mcp.json добавьте конфигурацию, как для Claude Desktop.

Для транспорта SSE сначала запустите сервер:

uvx mcp-atlassian --transport sse --port 9000

Затем укажите в конфигурации Cursor:

{
  "mcpServers": {
    "mcp-atlassian-sse": {
      "url": "http://localhost:9000/sse",
      "env": {
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token",
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_api_token"
      }
    }
  }
}

Доступные ресурсы

• confluence://{space_key} — доступ к разделам Confluence.
• jira://{project_key} — доступ к проектам Jira.

Сервер показывает только те разделы и проекты, с которыми пользователь активно взаимодействует (на основе вклада и назначений).

Инструменты (инструменты MCP)

Confluence:

• confluence_search — поиск по Confluence с помощью CQL.
• confluence_get_page — получить содержимое страницы.
• confluence_get_page_children — дочерние страницы.
• confluence_get_page_ancestors — родительские страницы.
• confluence_get_comments — комментарии к странице.
• confluence_create_page, confluence_update_page, confluence_delete_page — создание, обновление, удаление страниц.

Jira:

• jira_get_issue — получить задачу.
• jira_search — поиск по JQL.
• jira_get_project_issues — все задачи проекта.
• jira_create_issue, jira_update_issue, jira_delete_issue — CRUD для задач.
• jira_get_transitions — доступные переходы статусов.
• jira_transition_issue — изменить статус задачи.
• jira_add_worklog, jira_get_worklog — работа с логами времени.
• jira_link_to_epic, jira_get_epic_issues — работа с эпиками.

Разработка и отладка

Для локальной разработки (из клонированного репозитория):

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/your/mcp-atlassian",
        "run", "mcp-atlassian",
        "--confluence-url=https://your-domain.atlassian.net/wiki",
        "--confluence-username=your.email@domain.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-domain.atlassian.net",
        "--jira-username=your.email@domain.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

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

Используйте MCP Inspector:

# Для установленного пакета
npx @modelcontextprotocol/inspector uvx mcp-atlassian ...

# Для локальной версии
npx @modelcontextprotocol/inspector uv --directory /path/to/your/mcp-atlassian run mcp-atlassian ...

Просмотр логов Claude:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

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

• Никогда не передавайте API-токены третьим лицам.
• Храните файлы .env в защищённом месте.
• Ознакомьтесь с SECURITY.md.

Лицензия

MIT. Этот проект не является официальным продуктом Atlassian.