Bitbucket MCP

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
• Pacote npm
• Referência da API REST do Bitbucket

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

{
  "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