Atlassian MCP

Пользовательский сервер Model Context Protocol, который позволяет ИИ-агентам взаимодействовать с Jira и Confluence в Atlassian Cloud. Он выполняет обычные REST-запросы в фоне с помощью Jira REST API v3 и Confluence REST API v2.

Настройка

1. Установите зависимости и соберите проект:

   npm install
   npm run build

2. Сделайте сервер глобальной командой, чтобы его можно было запускать из любой рабочей области (используется запись bin в package.json):

   npm link

   Это помещает команду atlassian-mcp в ваш PATH. Повторно запускайте npm run build после изменений кода; связанная команда всегда указывает на текущий dist.

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

4. Передайте учётные данные через переменные окружения (см. .env.example):

   Variable	Description
   ATLASSIAN_SITE_URL	Ваш сайт, например https://your-domain.atlassian.net
   ATLASSIAN_EMAIL	Электронная почта вашей учётной записи Atlassian
   ATLASSIAN_API_TOKEN	API-токен, созданный выше

Related MCP server: jira-mcp

Подключение клиента

VS Code (рекомендуется)

В этом репозитории есть стандартный .vscode/mcp.json. Он запускает сервер через login-оболочку и интерактивный zsh (zsh -lic), поэтому наследует учётные данные Atlassian, экспортированные в вашем ~/.zshrc (или ~/.zshenv) — в конфигурации нет секретов — и вызывает глобально связанную команду atlassian-mcp, так что сервер работает независимо от того, какой репозиторий открыт:

{
  "servers": {
    "atlassian": {
      "type": "stdio",
      "command": "zsh",
      "args": ["-lic", "exec atlassian-mcp"]
    }
  }
}

Избегайте ${workspaceFolder} здесь: он указывает на репозиторий, открытый в данный момент, поэтому при использовании сервера из других рабочих областей это не сработает. Имя команды, полученной через npm link, разрешается из PATH вашей оболочки.

Чтобы сервер был доступен в каждой рабочей области, добавьте тот же блок servers в пользовательский MCP-конфиг (Палитра команд → MCP: Open User Configuration).

Альтернатива: запуск node с абсолютным путём

Если вы предпочитаете не использовать npm link, укажите node напрямую на собранный входной файл с помощью абсолютного пути (не ${workspaceFolder}, который меняется в зависимости от рабочей области). Переменная ${userHome} в VS Code обеспечивает переносимость между машинами:

{
  "servers": {
    "atlassian": {
      "type": "stdio",
      "command": "zsh",
      "args": ["-lic", "exec node \"${userHome}/Sites/atlassian-mcp/dist/index.js\""]
    }
  }
}

Скорректируйте путь, если вы склонировали репозиторий в другое место. Обёртка zsh -lic по-прежнему передаёт учётные данные из профиля вашей оболочки.

Экспортируйте переменные в профиле вашей оболочки, а не в файле конфигурации:

export ATLASSIAN_SITE_URL="https://your-domain.atlassian.net"
export ATLASSIAN_EMAIL="you@example.com"
export ATLASSIAN_API_TOKEN="your-api-token"

После изменения профиля оболочки перезагрузите окно VS Code, чтобы новые значения были подхвачены.

Другие клиенты (Claude Desktop, Cline, Cursor)

Клиенты, которые не запускаются через вашу оболочку, могут либо использовать ту же обёртку zsh -lic, либо задать переменные явно:

{
  "mcpServers": {
    "atlassian": {
      "command": "atlassian-mcp",
      "env": {
        "ATLASSIAN_SITE_URL": "https://your-domain.atlassian.net",
        "ATLASSIAN_EMAIL": "you@example.com",
        "ATLASSIAN_API_TOKEN": "your-api-token"
      }
    }
  }
}

Без npm link используйте node с абсолютным путём к собранному входному файлу:

{
  "mcpServers": {
    "atlassian": {
      "command": "node",
      "args": ["/absolute/path/to/atlassian-mcp/dist/index.js"],
      "env": {
        "ATLASSIAN_SITE_URL": "https://your-domain.atlassian.net",
        "ATLASSIAN_EMAIL": "you@example.com",
        "ATLASSIAN_API_TOKEN": "your-api-token"
      }
    }
  }
}

Для локальной разработки вы можете запустить сервер напрямую с помощью npm run dev.

Инструменты

Jira

Confluence

Примечания

• Поля Jira с форматированным текстом (описания, комментарии) принимают обычный текст, который автоматически преобразуется в Atlassian Document Format (ADF).

• Тела страниц и комментариев Confluence используют формат хранения (XHTML), например <p>Hi</p>.

• Ваш API-токен наследует все разрешения вашей учётной записи. Храните его в секрете и никогда не включайте его в коммиты.