# Bitbucket MCP

Servidor Model Context Protocol (MCP) para Bitbucket Cloud e Server que permite que assistentes de IA como Cursor gerenciem repositórios, pull requests, pipelines e mais através de linguagem natural.

Canonical URL: https://a2a-mcp.org/entry/bitbucket-mcp-pt

Language: pt

Category: MCP Servers

Updated: 2026-05-13

## Visão Geral
Bitbucket MCP é um servidor de código aberto do Model Context Protocol (MCP) para integração com as APIs do Bitbucket Cloud e Bitbucket Server/Data Center. Ele permite que assistentes de IA (como o Cursor) interajam de forma segura com seus repositórios, pull requests, pipelines e outros recursos do Bitbucket diretamente por meio de comandos em linguagem natural.

Este servidor implementa o padrão MCP e é publicado no npm como `bitbucket-mcp`.

## Funcionalidades
- Operações de repositório: listar repositórios e obter detalhes
- Ciclo de vida de pull requests: listar, obter, criar, atualizar, mesclar, aprovar, recusar, adicionar/visualizar comentários, diffs e tarefas
- Operações de pipeline: listar execuções, acionar/parar pipelines, visualizar etapas e logs
- Suporte a paginação (`pagelen`, `page`, `all`, `limit`)
- Design seguro por padrão: operações DELETE são desabilitadas, a menos que `BITBUCKET_ENABLE_DANGEROUS=true` seja explicitamente definido

## Operações Suportadas
O servidor expõe ferramentas para fluxos de trabalho comuns do Bitbucket, incluindo navegação em repositórios, gerenciamento de PRs, automação de revisão de código e monitoramento de pipelines. A lista completa de ferramentas e mapeamentos de API estão definidos na fonte (source).

## Segurança e Boas Práticas
- Requer senhas de aplicativo do Bitbucket (ou tokens de acesso) com escopos mínimos (Repositórios: Leitura; Pull requests: Leitura/Escrita; Pipelines: Leitura)
- Nenhuma operação DELETE habilitada por padrão
- Registro de log configurável (baseado em arquivo ou desabilitado)
- Suporta tanto o Bitbucket Cloud (`https://api.bitbucket.org/2.0`) quanto o Bitbucket Server auto-hospedado via `BITBUCKET_URL` configurável

## Compatibilidade
Funciona com qualquer runtime de IA compatível com MCP. Os exemplos de integração principais focam no Cursor, com suporte para Bitbucket Cloud e Server.

## Links
- [Repositório do GitHub](https://github.com/MatanYemini/bitbucket-mcp)
- [Pacote npm](https://www.npmjs.com/package/bitbucket-mcp)
- [Referência da API REST do Bitbucket](https://developer.atlassian.com/cloud/bitbucket/rest/intro/)

## Configuração MCP

### Pré-requisitos

- Node.js necessário (para npx/npm)
- Conta do Bitbucket com senha de aplicativo ou token de acesso

### Requisitos de acesso

- Senha de aplicativo do Bitbucket (Repositórios: Leitura, Pull requests: Leitura/Escrita, Pipelines: Leitura) ou token de acesso necessário via variáveis de ambiente

### Configuração do cliente

#### Cursor

```json
{
  "mcpServers": {
    "bitbucket": {
      "command": "npx",
      "env": {
        "BITBUCKET_URL": "https://api.bitbucket.org/2.0",
        "BITBUCKET_WORKSPACE": "seu-workspace",
        "BITBUCKET_USERNAME": "seu-usuario",
        "BITBUCKET_PASSWORD": "sua-senha-de-app"
      },
      "args": ["-y", "bitbucket-mcp@latest"]
    }
  }
}
```

- Crie ou edite o arquivo `.cursor/mcp.json` na raiz do seu projeto.
- Cole o bloco de configuração acima e substitua os placeholders (`seu-workspace`, `seu-usuario`, `sua-senha-de-app`) pelos seus valores reais.

Autenticação:
- As credenciais são passadas por variáveis de ambiente na configuração do MCP. Não é necessário login no navegador ou etapas adicionais de autorização.

O formato de URL legado (`https://bitbucket.org/seu-workspace`) também é suportado para detecção automática do workspace.
#### Claude Code

Não documentado
#### Claude Desktop

Não documentado
#### VS Code

Não documentado
#### Codex

Não documentado
#### Windsurf

Não documentado
#### Lovable

Não documentado
#### Outros

Execute via `npx -y bitbucket-mcp@latest` com as variáveis de ambiente necessárias (veja envVars). Configure no seu cliente MCP usando transporte stdio/command.

### Variáveis de ambiente

- `BITBUCKET_URL (padrão: https://api.bitbucket.org/2.0)`
- `BITBUCKET_WORKSPACE (opcional, detectado automaticamente a partir da URL no modo legado)`
- `BITBUCKET_USERNAME (seu e-mail/nome de usuário do Bitbucket)`
- `BITBUCKET_PASSWORD (senha de app ou token de API)`
- `BITBUCKET_TOKEN (alternativa ao nome de usuário/senha)`

Documentação de configuração: https://github.com/MatanYemini/bitbucket-mcp

## Tags

- mcp-server
- bitbucket
- nodejs
- pull-requests
- pipelines
- repositorios
- integracao-ia

## Sources

- [Project website](https://github.com/MatanYemini/bitbucket-mcp)