Как дать агенту доступ к Jira и Confluence

Требования к фиче редко лежат в коде — они в Confluence (описания, бизнес-правила) и Jira (задачи, тикеты). Чтобы агент видел что должно быть, а не только как написано, ему дают доступ к Atlassian через MCP-сервер.

Зачем агенту Jira и Confluence

• Confluence — описание фичи: какие поля обязательны, бизнес-правила, статусы, переходы между статусами.
• Jira — задачи и требования: что именно нужно сделать, контекст тикета.

В /generate-test первым делом агент идёт в Confluence — найти описание фичи, прежде чем писать тест. Без этого он генерирует «по догадке».

Как дать — два сервера

Выбор зависит от того, где живёт твой Atlassian:

• atlassian-mcp-server — официальный, для облачного Atlassian (*.atlassian.net).
• mcp-atlassian — сообщество, поддерживает в том числе селфхост Jira/Confluence.

Оба подключаются как MCP-серверы и дают агенту инструменты: искать страницы в Confluence, читать их, доставать issues из Jira и т.п. Авторизация — через OAuth или токен; точные шаги — в README выбранного сервера.

Где взять токен и куда вставить

Официальный atlassian-mcp-server (Cloud) логинит через OAuth в браузере — токен руками не нужен. А вот community-серверу mcp-atlassian (и всегда для селфхоста) нужен токен. Откуда его взять — зависит от того, где твой Atlassian.

Cloud — API-токен

1. Открой id.atlassian.com → Security → API tokens.
2. Create API token, дай имя, скопируй — он показывается один раз.
3. Для входа нужны два значения: твой email и этот токен.

Enterprise / Data Center — Personal Access Token

1. Профиль в Jira/Confluence → раздел Personal Access Tokens → создать (точное место в меню зависит от версии).
2. PAT заменяет связку «логин + токен» — нужен только сам токен.
3. Здесь Jira и Confluence — отдельные приложения на своих серверах, поэтому PAT у каждого свой: один для Jira, другой для Confluence.

Куда вставлять

Токен идёт в конфиг MCP-сервера, в блок переменных окружения env. Для mcp-atlassian в .mcp.json это выглядит так (Cloud):

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://компания.atlassian.net",
        "JIRA_USERNAME": "you@company.com",
        "JIRA_API_TOKEN": "<один-и-тот-же-токен-аккаунта>",
        "CONFLUENCE_URL": "https://компания.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "you@company.com",
        "CONFLUENCE_API_TOKEN": "<один-и-тот-же-токен-аккаунта>"
      }
    }
  }
}

Для Enterprise / Data Center вместо *_USERNAME + *_API_TOKEN подставляют PAT:

"env": {
  "JIRA_URL": "https://jira.компания.ru",
  "JIRA_PERSONAL_TOKEN": "<сюда-вставить-PAT>",
  "CONFLUENCE_URL": "https://confluence.компания.ru",
  "CONFLUENCE_PERSONAL_TOKEN": "<сюда-вставить-PAT>"
}

uvx — это запуск Python-пакета через uv (его нужно поставить заранее); есть и Docker-вариант. Точные способы запуска и передачи переменных (env-файл, claude mcp add --env) — в README mcp-atlassian.