Confluence MCP: сервер Atlassian и локальные серверы для Claude и Codex

atlassian/atlassian-mcp-server· Проверено 12.11.2026· 1,2 тыс.на GitHub

Подключает агента к базе знаний Confluence: поиск страниц по CQL, чтение и пересказ, создание страниц и комментариев. Есть удалённый сервер Atlassian с входом через OAuth и локальные серверы по API-токену.

3 реализации:

Удалённый сервер Atlassian: вход через OAuth 2.1, рядом с Confluence подключает Jira, Bitbucket, Compass и Loom; только Atlassian Cloud.

Как подключить

Что сделать до подключения

Сайт Atlassian Cloud с Confluence

Браузер для входа через OAuth 2.1 или API-токен для входа без браузера

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http confluence https://mcp.atlassian.com/v2/mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.confluence]
url = "https://mcp.atlassian.com/v2/mcp"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "confluence": {
      "url": "https://mcp.atlassian.com/v2/mcp"
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "confluence": {
      "type": "http",
      "url": "https://mcp.atlassian.com/v2/mcp"
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "confluence": {
      "httpUrl": "https://mcp.atlassian.com/v2/mcp"
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "confluence": {
      "httpUrl": "https://mcp.atlassian.com/v2/mcp"
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "confluence": {
        "type": "remote",
        "url": "https://mcp.atlassian.com/v2/mcp"
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

Customize → Connectors → добавить свой коннектор.
Адрес сервера: https://mcp.atlassian.com/v2/mcp

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "confluence": {
      "url": "https://mcp.atlassian.com/v2/mcp"
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Локальный сервер на Node.js с 5 общими инструментами: агент обращается к любому методу REST API Confluence и фильтрует ответ через JMESPath; только Confluence Cloud.

Как подключить

Что сделать до подключения

Node.js с командой npx

API-токен Atlassian

ATLASSIAN_API_TOKEN

id.atlassian.com/manage-profile/security/api-tokens → Create API token, токен показывается один раз

ATLASSIAN_SITE_NAME

первая часть адреса: для mycompany.atlassian.net это mycompany

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'ATLASSIAN_SITE_NAME=<ваша-компания>' --env 'ATLASSIAN_USER_EMAIL=<email>' --env 'ATLASSIAN_API_TOKEN=<API-токен>' --transport stdio mcp-server-atlassian-confluence \
  -- npx -y @aashari/mcp-server-atlassian-confluence

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mcp-server-atlassian-confluence]
command = "npx"
args = ["-y", "@aashari/mcp-server-atlassian-confluence"]

[mcp_servers.mcp-server-atlassian-confluence.env]
ATLASSIAN_SITE_NAME = "<ваша-компания>"
ATLASSIAN_USER_EMAIL = "<email>"
ATLASSIAN_API_TOKEN = "<API-токен>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mcp-server-atlassian-confluence": {
      "command": "npx",
      "args": ["-y", "@aashari/mcp-server-atlassian-confluence"],
      "env": {
        "ATLASSIAN_SITE_NAME": "<ваша-компания>",
        "ATLASSIAN_USER_EMAIL": "<email>",
        "ATLASSIAN_API_TOKEN": "<API-токен>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mcp-server-atlassian-confluence": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@aashari/mcp-server-atlassian-confluence"],
      "env": {
        "ATLASSIAN_SITE_NAME": "<ваша-компания>",
        "ATLASSIAN_USER_EMAIL": "<email>",
        "ATLASSIAN_API_TOKEN": "<API-токен>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mcp-server-atlassian-confluence": {
      "command": "npx",
      "args": ["-y", "@aashari/mcp-server-atlassian-confluence"],
      "env": {
        "ATLASSIAN_SITE_NAME": "<ваша-компания>",
        "ATLASSIAN_USER_EMAIL": "<email>",
        "ATLASSIAN_API_TOKEN": "<API-токен>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mcp-server-atlassian-confluence": {
      "command": "npx",
      "args": ["-y", "@aashari/mcp-server-atlassian-confluence"],
      "env": {
        "ATLASSIAN_SITE_NAME": "<ваша-компания>",
        "ATLASSIAN_USER_EMAIL": "<email>",
        "ATLASSIAN_API_TOKEN": "<API-токен>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mcp-server-atlassian-confluence": {
        "type": "local",
        "command": ["npx", "-y", "@aashari/mcp-server-atlassian-confluence"],
        "environment": {
          "ATLASSIAN_SITE_NAME": "<ваша-компания>",
          "ATLASSIAN_USER_EMAIL": "<email>",
          "ATLASSIAN_API_TOKEN": "<API-токен>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-server-atlassian-confluence": {
      "command": "npx",
      "args": ["-y", "@aashari/mcp-server-atlassian-confluence"],
      "env": {
        "ATLASSIAN_SITE_NAME": "<ваша-компания>",
        "ATLASSIAN_USER_EMAIL": "<email>",
        "ATLASSIAN_API_TOKEN": "<API-токен>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mcp-server-atlassian-confluence": {
      "command": "npx",
      "args": ["-y", "@aashari/mcp-server-atlassian-confluence"],
      "env": {
        "ATLASSIAN_SITE_NAME": "<ваша-компания>",
        "ATLASSIAN_USER_EMAIL": "<email>",
        "ATLASSIAN_API_TOKEN": "<API-токен>"
      }
    }
  }
}

Инструменты сервера

conf_getчитает данные по пути API

conf_postсоздаёт страницы и комментарии

conf_putзаменяет ресурс целиком

conf_patchправит ресурс частично

conf_deleteудаляет ресурс

Локальный сервер с готовыми инструментами для Confluence и Jira; работает и с Server/Data Center через CONFLUENCE_IS_CLOUD=false.

Как подключить

Что сделать до подключения

Node.js с командой npx

API-токен Atlassian

CONFLUENCE_API_KEY

id.atlassian.com/manage-profile/security/api-tokens → создать токен

CONFLUENCE_IS_CLOUD

true для Cloud, false для Server/Data Center

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'CONFLUENCE_URL=https://<ваша-компания>.atlassian.net' --env 'JIRA_URL=https://<ваша-компания>.atlassian.net' --env 'CONFLUENCE_API_MAIL=<email>' --env 'CONFLUENCE_API_KEY=<API-токен>' --env CONFLUENCE_IS_CLOUD=true --transport stdio confluence-mcp \
  -- npx -y @zereight/mcp-confluence

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.confluence-mcp]
command = "npx"
args = ["-y", "@zereight/mcp-confluence"]

[mcp_servers.confluence-mcp.env]
CONFLUENCE_URL = "https://<ваша-компания>.atlassian.net"
JIRA_URL = "https://<ваша-компания>.atlassian.net"
CONFLUENCE_API_MAIL = "<email>"
CONFLUENCE_API_KEY = "<API-токен>"
CONFLUENCE_IS_CLOUD = "true"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "confluence-mcp": {
      "command": "npx",
      "args": ["-y", "@zereight/mcp-confluence"],
      "env": {
        "CONFLUENCE_URL": "https://<ваша-компания>.atlassian.net",
        "JIRA_URL": "https://<ваша-компания>.atlassian.net",
        "CONFLUENCE_API_MAIL": "<email>",
        "CONFLUENCE_API_KEY": "<API-токен>",
        "CONFLUENCE_IS_CLOUD": "true"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "confluence-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@zereight/mcp-confluence"],
      "env": {
        "CONFLUENCE_URL": "https://<ваша-компания>.atlassian.net",
        "JIRA_URL": "https://<ваша-компания>.atlassian.net",
        "CONFLUENCE_API_MAIL": "<email>",
        "CONFLUENCE_API_KEY": "<API-токен>",
        "CONFLUENCE_IS_CLOUD": "true"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "confluence-mcp": {
      "command": "npx",
      "args": ["-y", "@zereight/mcp-confluence"],
      "env": {
        "CONFLUENCE_URL": "https://<ваша-компания>.atlassian.net",
        "JIRA_URL": "https://<ваша-компания>.atlassian.net",
        "CONFLUENCE_API_MAIL": "<email>",
        "CONFLUENCE_API_KEY": "<API-токен>",
        "CONFLUENCE_IS_CLOUD": "true"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "confluence-mcp": {
      "command": "npx",
      "args": ["-y", "@zereight/mcp-confluence"],
      "env": {
        "CONFLUENCE_URL": "https://<ваша-компания>.atlassian.net",
        "JIRA_URL": "https://<ваша-компания>.atlassian.net",
        "CONFLUENCE_API_MAIL": "<email>",
        "CONFLUENCE_API_KEY": "<API-токен>",
        "CONFLUENCE_IS_CLOUD": "true"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "confluence-mcp": {
        "type": "local",
        "command": ["npx", "-y", "@zereight/mcp-confluence"],
        "environment": {
          "CONFLUENCE_URL": "https://<ваша-компания>.atlassian.net",
          "JIRA_URL": "https://<ваша-компания>.atlassian.net",
          "CONFLUENCE_API_MAIL": "<email>",
          "CONFLUENCE_API_KEY": "<API-токен>",
          "CONFLUENCE_IS_CLOUD": "true"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "confluence-mcp": {
      "command": "npx",
      "args": ["-y", "@zereight/mcp-confluence"],
      "env": {
        "CONFLUENCE_URL": "https://<ваша-компания>.atlassian.net",
        "JIRA_URL": "https://<ваша-компания>.atlassian.net",
        "CONFLUENCE_API_MAIL": "<email>",
        "CONFLUENCE_API_KEY": "<API-токен>",
        "CONFLUENCE_IS_CLOUD": "true"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "confluence-mcp": {
      "command": "npx",
      "args": ["-y", "@zereight/mcp-confluence"],
      "env": {
        "CONFLUENCE_URL": "https://<ваша-компания>.atlassian.net",
        "JIRA_URL": "https://<ваша-компания>.atlassian.net",
        "CONFLUENCE_API_MAIL": "<email>",
        "CONFLUENCE_API_KEY": "<API-токен>",
        "CONFLUENCE_IS_CLOUD": "true"
      }
    }
  }
}

Инструменты сервера

execute_cql_searchищет страницы по CQL

get_page_contentчитает страницу по ID

create_pageсоздаёт страницу в пространстве

update_pageменяет текст страницы

execute_jql_searchищет задачи Jira по JQL

create_jira_issueсоздаёт задачу Jira

update_jira_issueменяет поля задачи

transition_jira_issueменяет статус задачи

get_current_sprintпоказывает активный спринт

get_epic_issuesсобирает задачи эпика

Показано 10 из 13.

Что попросить агента

«Перескажи страницу <название страницы>»Агент найдёт страницу через execute_cql_search и прочитает её get_page_content; в сервере aashari то же делает conf_get по пути /wiki/api/v2/pages/{id}/body

«Найди во всех пространствах страницы про <тема>»Агент вызовет conf_get по пути /wiki/rest/api/search с запросом CQL или execute_cql_search

«Создай в пространстве <ключ пространства> страницу <заголовок> с этим текстом: <текст>»Агент вызовет create_page или conf_post по пути /wiki/api/v2/pages

«Добавь к странице <название страницы> комментарий: <текст>»Агент найдёт ID страницы и вызовет conf_post по пути /wiki/api/v2/pages/{id}/footer-comments

«Какие пространства Confluence мне доступны?»Агент вызовет conf_get по пути /wiki/api/v2/spaces и покажет список

Для каких задач

Пересказать страницу Confluence, например план на квартал

Найти страницы по теме во всех пространствах через CQL

Создать страницу в нужном пространстве

Добавить комментарий к странице

Показать пространства, к которым у вас есть доступ

Связать задачи Jira со страницей Confluence

Ограничения

Удалённый сервер Atlassian и сервер aashari работают только с Confluence Cloud; для Server/Data Center подходит сервер zereight с CONFLUENCE_IS_CLOUD=false

У сервера aashari 62 звезды и последнее обновление в феврале 2026 года; ответы длиннее примерно 40 000 знаков он обрезает, поэтому агенту нужно сужать запросы

У сервера zereight 30 звёзд и 13 инструментов, комментариев и списка пространств среди них нет

Агент действует с вашими правами, а страницы могут содержать внедрённые инструкции: удаление и другие опасные действия подтверждайте вручную

Если не работает

Authentication failed или 403 Forbidden в сервере aashari

Проверьте, что токен на id.atlassian.com/manage-profile/security/api-tokens активен, а в ATLASSIAN_SITE_NAME стоит только имя сайта, например mycompany.

Resource not found или 404 на запросе к странице

Пути API чувствительны к регистру, а пространства и страницы задаются числовыми ID вместо ключей. Убедитесь, что страница открывается у вас в браузере.

Удалённый сервер пишет You don't have permission to connect from this IP address

В организации включён список разрешённых IP. Облачные клиенты ходят с адресов своего провайдера, поэтому попросите администратора добавить эти диапазоны.

Вход через OAuth прошёл, а вызовы инструментов возвращают 403

Причиной бывают ограничения по IP, нехватка прав токена или политика доступа. Выясните причину отказа у администратора до правки списка IP.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Atlassian MCP Serverразработчик сервиса	Atlassian	1,2 тыс.	HTTP	вход	—	7 ноября 2026
Atlassian Confluence MCP	aashari	62	локально	токен	5	22 февраля 2026
Better Confluence Communication Server	zereight	30	локально	токен	13	11 августа 2026

Частые вопросы

Какой вариант выбрать?

Если клиент умеет OAuth, подключите https://mcp.atlassian.com/v2/mcp: вход в браузере, токен не нужен. Сервер aashari подходит, когда агенту нужен любой метод REST API Confluence, сервер zereight — когда рядом нужна Jira.

Где взять API-токен Confluence?

Откройте id.atlassian.com/manage-profile/security/api-tokens, нажмите Create API token и сразу скопируйте токен: второй раз его не покажут. В ATLASSIAN_SITE_NAME у aashari пишется только имя сайта, для mycompany.atlassian.net это mycompany.

Как не забивать контекст длинными ответами?

В сервере aashari передавайте параметр jq с выражением JMESPath и limit в queryParams: ответ длиннее примерно 40 000 знаков обрезается, полный текст сохраняется в /tmp/mcp/. Для удалённого сервера Atlassian можно прописать в AGENTS.md пространство и limit: 10 для поиска по CQL.

Почему удалённый сервер показывает мало инструментов?

Atlassian MCP Server сразу отдаёт клиенту самые нужные инструменты, остальные агент находит по запросу. Если нужен весь список сразу, подключайтесь по адресу https://mcp.atlassian.com/v2/mcp?tools=all.

Есть ли у Atlassian свой Confluence MCP server?

Да, Atlassian MCP Server работает в облаке по адресу https://mcp.atlassian.com/v2/mcp. Он подключает Confluence вместе с Jira, Bitbucket, Compass и Loom, но только на сайтах Atlassian Cloud.

Как подключить Confluence MCP server к Claude Code?

Выполните claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp, затем в сессии запустите /mcp и войдите через браузер. В Codex команда такая: codex mcp add atlassian --url https://mcp.atlassian.com/v2/mcp.

Есть ли Confluence MCP server для Confluence Server или Data Center?

Сервер zereight работает с ними, если задать CONFLUENCE_IS_CLOUD=false. Локальный mcp-atlassian со страницы про Jira поддерживает Confluence Server/Data Center с версии 6.0.

Работает ли сервер из России?

Серверы aashari и zereight запускаются на вашем компьютере и ходят в ваш Confluence по API-токену; удалённому серверу Atlassian нужен сайт Atlassian Cloud.

Confluence MCP: сервер Atlassian и локальные серверы для Claude и Codex

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы