# atlassian-dc-mcp-bitbucket

Connect Claude Code to Bitbucket Data Center to work with repositories and code. You’ll need a Bitbucket host and an API token.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 105
- Author: b1ff
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/b1ff/atlassian-dc-mcp
- Updated: 2026-10-12
- HTML: https://affpapa.org/en/nevibecode/mcp/atlassian-dc-mcp-bitbucket

## What it does

This MCP server connects Claude Code to Bitbucket Data Center. You can ask an agent to work with repositories and code there. It runs through the `@atlassian-dc-mcp/bitbucket` package using `npx`.

Provide `BITBUCKET_API_TOKEN` to authenticate; set the server address and API path with `BITBUCKET_HOST` and `BITBUCKET_API_BASE_PATH`. You can also run `npx @atlassian-dc-mcp/bitbucket setup` to enter the connection details and test them. Add the server to Claude Code with `claude mcp add`. A reachable Bitbucket host and a valid token are required for the connection to work.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `ATLASSIAN_DC_MCP_CONFIG_FILE`, `BITBUCKET_HOST`, `BITBUCKET_API_BASE_PATH`, `BITBUCKET_API_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.
- Works with: Atlassian

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env ATLASSIAN_DC_MCP_CONFIG_FILE=<ATLASSIAN_DC_MCP_CONFIG_FILE> --env BITBUCKET_HOST=<BITBUCKET_HOST> --env BITBUCKET_API_BASE_PATH=<BITBUCKET_API_BASE_PATH> --env BITBUCKET_API_TOKEN=<BITBUCKET_API_TOKEN> --transport stdio atlassian-dc-mcp-bitbucket -- npx -y @atlassian-dc-mcp/bitbucket
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add atlassian-dc-mcp-bitbucket --env ATLASSIAN_DC_MCP_CONFIG_FILE=<ATLASSIAN_DC_MCP_CONFIG_FILE> --env BITBUCKET_HOST=<BITBUCKET_HOST> --env BITBUCKET_API_BASE_PATH=<BITBUCKET_API_BASE_PATH> --env BITBUCKET_API_TOKEN=<BITBUCKET_API_TOKEN> -- npx -y @atlassian-dc-mcp/bitbucket
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "atlassian-dc-mcp-bitbucket": {
            "command": "npx",
            "args": [
                "-y",
                "@atlassian-dc-mcp/bitbucket"
            ],
            "env": {
                "ATLASSIAN_DC_MCP_CONFIG_FILE": "<ATLASSIAN_DC_MCP_CONFIG_FILE>",
                "BITBUCKET_HOST": "<BITBUCKET_HOST>",
                "BITBUCKET_API_BASE_PATH": "<BITBUCKET_API_BASE_PATH>",
                "BITBUCKET_API_TOKEN": "<BITBUCKET_API_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "atlassian-dc-mcp-bitbucket": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@atlassian-dc-mcp/bitbucket"
            ],
            "env": {
                "ATLASSIAN_DC_MCP_CONFIG_FILE": "<ATLASSIAN_DC_MCP_CONFIG_FILE>",
                "BITBUCKET_HOST": "<BITBUCKET_HOST>",
                "BITBUCKET_API_BASE_PATH": "<BITBUCKET_API_BASE_PATH>",
                "BITBUCKET_API_TOKEN": "<BITBUCKET_API_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e ATLASSIAN_DC_MCP_CONFIG_FILE=<ATLASSIAN_DC_MCP_CONFIG_FILE> -e BITBUCKET_HOST=<BITBUCKET_HOST> -e BITBUCKET_API_BASE_PATH=<BITBUCKET_API_BASE_PATH> -e BITBUCKET_API_TOKEN=<BITBUCKET_API_TOKEN> atlassian-dc-mcp-bitbucket npx -y @atlassian-dc-mcp/bitbucket
```
Replace <…> with your own values

## When to use it
- connect Claude Code to Bitbucket Data Center
- access Bitbucket repositories through an agent
- ask an agent to inspect code in Bitbucket

## Example prompts
- Inspect the code in this Bitbucket repository and explain how the module works.
- Find the repository code related to authentication in Bitbucket.
- Look through the Bitbucket repository and locate its API integration.

## Similar
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [GitDiagram](https://affpapa.org/en/nevibecode/mcp/gitdiagram.md) — MCP server · ★ 18446
- [Repowise](https://affpapa.org/en/nevibecode/mcp/repowise.md) — MCP server · ★ 7891
- [sem](https://affpapa.org/en/nevibecode/mcp/sem.md) — MCP server · ★ 3422
- [GitLab MCP Server](https://affpapa.org/en/nevibecode/mcp/gitlab-mcp-server.md) — MCP server · ★ 2065
- [Octocode MCP - AI Context Platform](https://affpapa.org/en/nevibecode/mcp/octocode-mcp-ai-context-platform.md) — MCP server · ★ 955

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md