mcp-server-atlassian-bitbucket
MCP-сервер Bitbucket Cloud с шестью общими инструментами: любой путь REST API репозиториев и pull request
- 164 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Токен с правом `pullrequest` и инструменты `bb_post`, `bb_put`, `bb_patch`, `bb_delete` дают агенту создавать, одобрять, сливать и удалять
- API-токен Atlassian хранится в переменной окружения и открывает репозитории рабочих пространств
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-server-atlassian-bitbucketОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Токен с правом `pullrequest` и инструменты `bb_post`, `bb_put`, `bb_patch`, `bb_delete` дают агенту создавать, одобрять, сливать и удалять
- API-токен Atlassian хранится в переменной окружения и открывает репозитории рабочих пространств
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер на Node.js подключает Claude Desktop, Cursor, Cline и другие MCP-клиенты к Bitbucket Cloud. Вместо десятков узких команд у него шесть общих инструментов. `bb_get`, `bb_post`, `bb_put`, `bb_patch` и `bb_delete` вызывают любой путь REST API 2.0, префикс `/2.0` добавляется сам, а `bb_clone` клонирует репозиторий на диск. Агент листает рабочие пространства, читает коммиты и файлы, сравнивает ветки, создает pull `request`, комментирует, одобряет и сливает. Ответы по умолчанию приходят в формате TOON, который по данным автора экономит 30–60% токенов относительно JSON; значение `json` в параметре `outputFormat` возвращает обычный JSON. Параметр `jq` принимает выражение JMESPath и оставляет в ответе нужные поля. Те же вызовы работают из терминала: `npx -y @aashari/mcp-server-atlassian-bitbucket get --path "/workspaces"`.
Для кого. Разработчикам и тимлидам на Bitbucket Cloud, которые хотят отдавать агенту обзор pull `request`, поиск по коду и сравнение веток.
Подходит, если
- Нужен список открытых pull `request` с автором и состоянием, а ответ должен остаться коротким: `jq` оставит три поля
- Агент сравнивает ветку с `main` и пересказывает разницу
- К PR #123 нужно добавить комментарий с итогами тестов прямо из чата
- Файл читают без клонирования по пути `/repositories/{workspace}/{repo}/src/{commit}/{filepath}`
- Статус сборок и выкладок смотрят теми же вызовами по путям `/pipelines` и `/deployments`
Не подходит, если
- Репозитории лежат на Bitbucket Server или Data Center: сервер работает только с Bitbucket Cloud
- Агенту разрешено только читать: режима `read-only` у сервера нет, запрет задают правами токена
- Нужны готовые узкие команды вроде «список веток»: здесь инструменты общие, и путь агент собирает сам
Пример запроса к агенту
Покажи открытые pull `request` в репозитории my-workspace/backend-api с автором и состоянием и сравни ветку `feature-login` с `main`MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
ATLASSIAN_USER_EMAILобязательная- Почта аккаунта Atlassian, логин для скоупного API-токена
ATLASSIAN_API_TOKENобязательная, секрет- Скоупный API-токен Atlassian с правами Bitbucket
BITBUCKET_DEFAULT_WORKSPACE- Рабочее пространство по умолчанию для вызовов без явного указания
Ограничения
- Пароли приложений Bitbucket автор называет устаревшими с отключением в июне 2026, поэтому нужны почта Atlassian и скоупный API-токен, он начинается с `ATATT`.
- Последний коммит репозитория сделан в марте 2026, версия пакета 3.1.0.
- В README нет готовой команды для Claude Code: подключение описано для Claude Desktop и через файл `~/.mcp/configs.json`.
- Без `jq` ответы бывают большими и съедают контекст, автор советует всегда задавать фильтр.
Как отключить. Удалите блок bitbucket из конфигурации MCP-клиента или из файла `~/.mcp/configs.json` и перезапустите клиент. Токен отзывается на странице id.atlassian.com/manage-profile/security/api-tokens. Глобальный пакет удаляет `npm uninstall -g @aashari/mcp-server-atlassian-bitbucket`.
Частые вопросы
Как создать токен для Bitbucket MCP?
Откройте id.atlassian.com/manage-profile/security/api-tokens и выберите «Create API token with scopes», продукт Bitbucket. Для чтения хватит прав `repository` и `workspace`, для pull `request` добавьте `pullrequest`. Логином служит почта Atlassian, токен начинается с `ATATT`.
Как уменьшить расход токенов на ответах Bitbucket?
Передавайте `jq` с выражением JMESPath, например `values[].name`. Формат TOON уже включен по умолчанию. Чтобы увидеть поля ответа, сначала запросите один элемент через `pagelen` со значением `1`, а затем сузьте фильтр.
Какие пути API нужны чаще всего?
Для старта хватает `/workspaces`, `/repositories/{workspace}` и `/repositories/{workspace}/{repo}/pullrequests`. Разницу между ветками возвращает `/repositories/{workspace}/{repo}/diff/{source}..{destination}`, а сам `diff` PR лежит по `/pullrequests/{id}/diff`.
Какие клиенты подходят для Bitbucket MCP?
README называет Claude Desktop (официальная поддержка), Cursor AI, Continue.dev, Cline и любой клиент MCP с транспортом STDIO. Для Claude Desktop в README есть готовый блок настроек, для остальных клиентов нужна команда `npx -y @aashari/mcp-server-atlassian-bitbucket`.
Может ли агент менять и удалять данные в Bitbucket?
Да, если токен это допускает. `bb_post`, `bb_put`, `bb_patch` и `bb_delete` вызывают любые пути записи, например слияние и отклонение pull `request`. Для чтения выдайте токену только права `repository` и `workspace`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP для Jira, Confluence, Bitbucket и Jenkins
Sberworks MCP
Локальный stdio MCP-сервер для корпоративных Jira, Confluence, Bitbucket Server и Jenkins с mTLS и раздельным включением операций записи
Azure DevOps MCP от Tiberriver256
Azure DevOps MCP by Tiberriver256
MCP-сервер сообщества для задач, кода и сборок Azure DevOps; поддерживает вход по PAT в Azure DevOps Server внутри вашей сети
Менеджер MCP-серверов на Node.js: запускает локальные и подключает удаленные серверы и отдает их клиенту одним адресом с REST API для управления
Плагин превращает Jenkins в MCP-сервер: агент смотрит задачи и логи сборок, запускает билды и читает результаты тестов.
Официальный MCP-сервер GitHub: код, issues, пул-реквесты, Actions и алерты безопасности прямо из агента
MCP SSH Manager
mcp-ssh-manager
Управление несколькими SSH-подключениями из Claude Code и Codex: команды, перенос файлов, базы данных и бэкапы. Стабильная ветка в npm, в GitHub бета 4.0
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| mcp-server-atlassian-bitbucket (эта карточка) | нет | API-ключ | 164 | |
| Bitbucket CLI | нет | 257 | CLI с отдельным MCP-режимом чтения для одного закрепленного контекста | |
| Atlassian Rovo MCP Server | да | OAuth | 1 148 | официальный облачный сервер Atlassian для Jira, Confluence и других продуктов |
Коротко о README
README ведет от создания токена к быстрой пробе через npx, затем показывает конфигурацию для Claude Desktop и общий файл настроек. Ниже таблица шести инструментов с параметрами, список частых путей API, объяснение формата TOON и фильтра JMESPath, примеры запросов и советы по экономии токенов.