Aashari MCP Server Atlassian Bitbucket

🚀 Atlassian Bitbucket MCP Server Configuration Guide

This guide details how to configure and use the MCP (Machine Learning Platform) server for Atlassian Bitbucket. Through this article, you'll learn how to connect AI assistants like Claude Desktop or Cursor AI and integrate them with Bitbucket.

🚀 Quick Start

✨ Features

This guide provides comprehensive instructions on configuring and using the Atlassian Bitbucket MCP server, including installation methods, environment variable configuration, server configuration examples, and usage guides.

📦 Installation

1. Quick Run with npx

You can directly run the MCP server using npx without installation:

# List all workspaces
npx -y @aashari/mcp-server-atlassian-bitbucket list-workspaces

# Get repository information
npx -y @aashari/mcp-server-atlassian-bitbucket get-repository --workspace my-team --repository my-api

# View open Pull Requests
npx -y @aashari/mcp-server-atlassian-bitbucket list-pull-requests --workspace my-team --repository my-api --state OPEN

2. Global Installation

If you need to use it frequently, you can globally install the MCP tool on your system:

# Installation command
npm install -g @aashari/mcp-server-atlassian-bitbucket

# Verify the installed version
mcp-atlassian-bitbucket --version

3. Environment Variable Configuration

When running MCP commands, you can complete authentication by setting the following environment variables:

Using Bitbucket App Password

# Login information
export ATLASSIAN_BITBUCKET_USERNAME=<YOUR_USERNAME>
export ATLASSIAN_BITBUCKET_APP_PASSWORD=<YOUR_APP_PASSWORD>

# Execute the command
mcp-atlassian-bitbucket list-workspaces

Using Atlassian API Token

# Login information
export ATLASSIAN_SITE_NAME=bitbucket
export ATLASSIAN_USER_EMAIL=<YOUR_EMAIL>
export ATLASSIAN_API_TOKEN=<YOUR_API_TOKEN>

# Execute the command
mcp-atlassian-bitbucket list-workspaces

💻 Usage Examples

Configuration Examples for MCP Server

Configure Claude Desktop

1. Open Settings (gear icon) > Edit Configuration.
2. Add the following content to mcpServers:

{
    "mcpServers": {
        "aashari/mcp-server-atlassian-bitbucket": {
            "command": "npx",
            "args": ["-y", "@aashari/mcp-server-atlassian-bitbucket"]
        }
    }
}

3. Save and restart Claude Desktop.
4. Verification: Click the tool icon (hammer) and confirm that the Bitbucket tool is listed.

Configure Cursor AI

1. Open the command palette (Cmd+Shift+P or Ctrl+Shift+P) > Cursor Settings > MCP.
2. Click + Add New MCP Server.
3. Fill in the following information:
   • Name: aashari/mcp-server-atlassian-bitbucket
   • Type: command
   • Command: npx -y @aashari/mcp-server-atlassian-bitbucket
4. Click Done.

Usage Guide

1. Create a Pull Request

# Create a new Pull Request
mcp-atlassian-bitbucket create-pull-request --from-ref=feature-branch --to-ref=main --title="feat: New feature implementation" --description="Detailed description of adding a new feature"

2. Review Code

# View all Pull Requests in the specified repository
mcp-atlassian-bitbucket list-pull-requests --workspace=my-team --repository=my-api

3. Merge a Pull Request

# Merge the specified Pull Request
mcp-atlassian-bitbucket merge-pull-request --workspace=my-team --repository=my-api --pullRequestId=123

📚 Documentation

For more integration details about Bitbucket and MCP, please refer to the official documentation.

If you have any questions, feel free to contact the support team.