Как подключить Bitbucket к Gemini через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Bitbucket, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Bitbucket + Gemini

Дайте ИИ работать в Bitbucket Cloud: просматривать репозитории, ветки, коммиты и файлы, проверять пул-реквесты с диффами и комментариями, одобрять, комментировать и сливать их после вашего подтверждения, а также проверять запуски Bitbucket Pipelines, логи шагов и деплои.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

BITBUCKET_API_TOKEN

Шаг 1 — Получите учётные данные

1. Войдите на https://id.atlassian.com/manage-profile/security/api-tokens (Security → API tokens в вашем аккаунте Atlassian) и нажмите Create API token with scopes.
2. Дайте токену имя (например, AnythingMCP), выберите срок действия и приложение Bitbucket.
3. Отметьте скоупы на чтение read:user:bitbucket, read:workspace:bitbucket, read:repository:bitbucket, read:pullrequest:bitbucket и read:pipeline:bitbucket. Добавьте write:pullrequest:bitbucket, чтобы создавать, комментировать, одобрять и сливать пул-реквесты, и write:pipeline:bitbucket, чтобы запускать пайплайны.
4. Скопируйте токен (он начинается с ATATT) и вставьте его в BITBUCKET_API_TOKEN без слова Bearer, затем установите коннектор. Коннектор отправляет его как Bearer-токен, поэтому ваш email в Atlassian не нужен.
5. Проверьте настройку с помощью bitbucket_get_current_user, а затем bitbucket_list_workspaces.

Пароли приложений больше не работают: Bitbucket перестал создавать их 9 сентября 2025 года и отключил оставшиеся 28 июля 2026 года. Используйте API-токен со скоупами, как описано выше. В том же поле работает и access token репозитория, проекта или workspace (Repository settings → Access tokens; токены проекта и workspace требуют плана Premium), но он действует как бот, ограниченный этим репозиторием, проектом или workspace: bitbucket_get_current_user и bitbucket_list_workspaces могут быть отклонены, а всё, что вне его досягаемости, отвечает 403 или 404.

Кто что видит: ИИ действует от имени пользователя, которому принадлежит токен, и видит и меняет ровно то, что разрешают этот пользователь и отмеченные скоупы. Без двух скоупов на запись токен остаётся только для чтения.

Меняет реальные ветки и доходит до вашей команды, поэтому ИИ сначала спрашивает: bitbucket_create_pull_request открывает пул-реквест от вашего имени (исходная ветка уже должна быть запушена). bitbucket_add_pull_request_comment публикует общий комментарий, ответ или комментарий к строке кода, который видят все участники пул-реквеста и о котором они могут получить уведомление. bitbucket_approve_pull_request добавляет ваше одобрение, которое учитывается в merge checks. bitbucket_merge_pull_request меняет целевую ветку для всех, может запустить пайплайны деплоя и с close_source_branch удаляет исходную ветку; перед этим ИИ проверяет статус и одобрения через bitbucket_get_pull_request. bitbucket_run_pipeline расходует минуты сборки и выполняет всё, что делает пайплайн, включая шаги деплоя. Перед каждым таким вызовом ИИ называет репозиторий, ветки, пул-реквест и стратегию слияния или пайплайн и ждёт вашего «да». При установке ничего не отключено, и ни один инструмент не удаляет репозитории, ветки или комментарии, кроме исходной ветки при слиянии с close_source_branch.

Как работать: bitbucket_list_workspaces даёт slug workspace, bitbucket_list_repositories даёт slug репозитория; оба есть в адресе bitbucket.org/<workspace>/<repo>. Код: bitbucket_get_repository (основная ветка), bitbucket_list_branches, bitbucket_list_commits, bitbucket_get_commit и bitbucket_get_file (текст файла или содержимое папки). Ревью: bitbucket_list_pull_requests, bitbucket_get_pull_request, bitbucket_get_pull_request_diffstat для оценки объёма изменений, затем bitbucket_get_pull_request_diff, bitbucket_list_pull_request_commits и bitbucket_list_pull_request_comments. Деплои: bitbucket_list_environments и bitbucket_list_deployments.

Пайплайны: bitbucket_list_pipelines, затем bitbucket_get_pipeline, bitbucket_list_pipeline_steps и bitbucket_get_pipeline_step_log для упавшего шага. UUID пайплайнов и шагов содержат фигурные скобки; ИИ передаёт их ровно в том виде, в каком они пришли. Логи шагов больше 200 КБ обрезаются с сохранением начала, а ошибка обычно в конце, поэтому для длинных логов ИИ читает конец с диапазоном вроде bytes=-150000 (последние 150 КБ). Диффы и файлы тоже обрезаются на 200 КБ.

Списки и фильтры: ответ со списком содержит next, если есть следующая страница; ИИ вызывает инструмент снова с page (число для большинства списков, непрозрачный токен для коммитов), а pagelen задаёт размер страницы. q принимает язык запросов Bitbucket, например name ~ "api" или destination.branch.name = "main".

Без задач и вики: Bitbucket убрал встроенный трекер задач и вики 20 августа 2026 года (API отвечает 410), поэтому у этого коннектора нет инструментов для них. Для задач подключите коннектор Jira.

Частые ошибки: 401: токен неверный, истёк или отозван, либо это старый пароль приложения; создайте API-токен со скоупами. 403: не хватает скоупа (сообщение называет его) или у пользователя нет прав. 404: workspace, репозиторий или объект не существует, либо токен его не видит. 429: достигнут почасовой лимит запросов; подождите и повторите.

Коннектор не охватывает создание и удаление репозиториев и веток, редактирование файлов и пуш коммитов, отклонение пул-реквестов, остановку пайплайнов, переменные и настройки репозиториев, а также администрирование.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Bitbucket.

Доступные инструменты

Примеры запросов

• «Какие пул-реквесты в acme/web-app ещё открыты, кто их создал и у каких пока нет ни одного одобрения?»
• «Сделай ревью пул-реквеста #42 в web-app: кратко опиши изменённые файлы, отметь рискованные изменения и перечисли нерешённые комментарии ревью.»
• «Почему упал последний пайплайн на main? Прочитай лог упавшего шага и покажи мне ошибку.»
• «Слей пул-реквест #42 в main через squash, когда у него будет два одобрения. Сначала покажи ветки и стратегию слияния и спроси меня перед слиянием.»
• «Что последним задеплоили в Production, когда и кто, и какой коммит был выпущен?»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT