Bitbucket MCP — MCP-сервер для Claude Code: доступ к Bitbucket Cloud
MCP-сервер на Go даёт агенту доступ к Bitbucket Cloud: репозитории, ветки, pull request'ы. Нужен, если работа с Bitbucket идёт через ИИ-ассистента.
claude mcp add --env BITBUCKET_USERNAME=<BITBUCKET_USERNAME> --env BITBUCKET_TOKEN=<BITBUCKET_TOKEN> --transport stdio bitbucket-mcp -- docker run -i --rm -e BITBUCKET_USERNAME -e BITBUCKET_TOKEN ghcr.io/fabianschurig/bitbucket-mcp:0.20.2Что делает Bitbucket MCP
Bitbucket MCP — часть проекта bitbucket-cli: из одного описания Bitbucket OpenAPI собирают три инструмента — CLI bb-cli, MCP-сервер bb-mcp и Terraform-провайдер. Схема генерируется из живой спецификации, поэтому новые эндпоинты Bitbucket попадают в сервер без ручной обвязки под каждый из них. Ручного кода в рантайме мало: авторизация, диспетчеризация и вывод остаются общими.
Сервер работает по stdio и запускается в Docker. Для подключения нужны две переменные окружения: BITBUCKET_USERNAME и BITBUCKET_TOKEN. Без них авторизация не пройдёт, и сервер не сможет обращаться к API. В командах установки они передаются через --env и -e.
Поддерживаются и внутренние эндпоинты, которых нет в публичной спецификации: схемы в каталоге schema/ можно описать руками, и генераторы обрабатывают их так же, как остальные. Это пригодится, если нужен доступ к возможностям Bitbucket, не описанным в открытом API.
Какие задачи решает
- посмотреть список репозиториев и веток в Bitbucket Cloud
- разобрать pull request и его комментарии из агента
- проверить настройки branch restrictions по проекту
- получить данные о коммитах без переключения в браузер
- подключить Bitbucket к рабочему процессу ИИ-ассистента
Примеры запросов агенту
- Покажи открытые pull request'ы в репозитории
backend-api - Какие ветки есть в репозитории
web-app? - Найди коммиты за последнюю неделю в
infra
Как установить Bitbucket MCP
Командой платформы
claude mcp add --env BITBUCKET_USERNAME=<BITBUCKET_USERNAME> --env BITBUCKET_TOKEN=<BITBUCKET_TOKEN> --transport stdio bitbucket-mcp -- docker run -i --rm -e BITBUCKET_USERNAME -e BITBUCKET_TOKEN ghcr.io/fabianschurig/bitbucket-mcp:0.20.2Вместо <…> подставьте свои значения
Командой платформы
codex mcp add bitbucket-mcp --env BITBUCKET_USERNAME=<BITBUCKET_USERNAME> --env BITBUCKET_TOKEN=<BITBUCKET_TOKEN> -- docker run -i --rm -e BITBUCKET_USERNAME -e BITBUCKET_TOKEN ghcr.io/fabianschurig/bitbucket-mcp:0.20.2Вместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"bitbucket-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"BITBUCKET_USERNAME",
"-e",
"BITBUCKET_TOKEN",
"ghcr.io/fabianschurig/bitbucket-mcp:0.20.2"
],
"env": {
"BITBUCKET_USERNAME": "<BITBUCKET_USERNAME>",
"BITBUCKET_TOKEN": "<BITBUCKET_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"bitbucket-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"BITBUCKET_USERNAME",
"-e",
"BITBUCKET_TOKEN",
"ghcr.io/fabianschurig/bitbucket-mcp:0.20.2"
],
"env": {
"BITBUCKET_USERNAME": "<BITBUCKET_USERNAME>",
"BITBUCKET_TOKEN": "<BITBUCKET_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e BITBUCKET_USERNAME=<BITBUCKET_USERNAME> -e BITBUCKET_TOKEN=<BITBUCKET_TOKEN> bitbucket-mcp docker run -i --rm -e BITBUCKET_USERNAME -e BITBUCKET_TOKEN ghcr.io/fabianschurig/bitbucket-mcp:0.20.2Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Bitbucket MCP
Как установить Bitbucket MCP в Claude Code?
Одной командой: `claude mcp add --env BITBUCKET_USERNAME=<BITBUCKET_USERNAME> --env BITBUCKET_TOKEN=<BITBUCKET_TOKEN> --transport stdio bitbucket-mcp -- docker run -i --rm -e BITBUCKET_USERNAME -e BITBUCKET_TOKEN ghcr.io/fabianschurig/bitbucket-mcp:0.20.2`. Подставьте свои логин и токен Bitbucket.
Что делает Bitbucket MCP?
Даёт ИИ-агенту доступ к Bitbucket Cloud через MCP: репозитории, ветки, pull request'ы и другие эндпоинты из спецификации. Работает по stdio, запускается в Docker.
Что нужно для работы сервера?
Установленный Docker и переменные BITBUCKET_USERNAME и BITBUCKET_TOKEN с данными вашей учётной записи Bitbucket.
