将AI连接到您的Bitbucket仓库

通过将Claude、Cursor AI和其他AI助手直接连接到您的仓库、拉取请求和代码中，改变您与Bitbucket的工作方式。获得即时洞察，自动化代码审查，并简化您的开发工作流程。

您可以做什么

✅ 询问AI关于您的代码："我的主仓库最新的提交是什么？"
✅ 获取PR洞察："显示所有需要审核的开放拉取请求"
✅ 搜索您的代码库："查找所有使用身份验证函数的JavaScript文件"
✅ 审查代码更改："比较我的功能分支和主分支之间的差异"
✅ 管理拉取请求："为我的新功能分支创建一个PR"
✅ 自动化工作流："在PR #123 中添加测试结果的评论"

完美适用于

• 开发者：希望在代码审查和仓库管理中获得AI帮助
• 团队负责人：需要快速了解项目状态和拉取请求活动
• DevOps工程师：自动化仓库工作流和分支管理
• 任何人：希望通过自然语言与Bitbucket交互

快速开始

两分钟内启动：

1. 获取您的Bitbucket凭据

⚠️ 重要提示：Bitbucket应用密码正在被弃用，并将于2026年6月移除。我们建议使用范围API令牌进行新的设置。

选项A：范围API令牌（推荐 - 面向未来）

Bitbucket正在弃用应用密码。请改用新的范围API令牌：

1. 前往Atlassian API令牌
2. 点击**“创建具有范围的API令牌”**
3. 选择**“Bitbucket”**作为产品
4. 选择适当的范围：
   • 仅读访问：repository，workspace
   • 全部功能：repository，workspace，pullrequest
5. 复制生成的令牌（以ATATT开头）
6. 使用您的Atlassian电子邮件作为用户名

选项B：应用密码（遗留 - 将被弃用）

生成Bitbucket应用密码（旧方法）：

1. 前往Bitbucket应用密码
2. 点击“创建应用密码”
3. 给它起个名字，如“AI助手”
4. 选择这些权限：
   • 工作区：读取
   • 仓库：读取（如果希望AI创建PR/评论，则选择写入）
   • 拉取请求：读取（如果希望管理PR，则选择写入）

2. 即时尝试

# 设置您的凭据（选择一种方法）

# 方法1：范围API令牌（推荐 - 面向未来）
export ATLASSIAN_USER_EMAIL="your.email@公司.com"
export ATLASSIAN_API_TOKEN="your_scoped_api_token"  # 以ATATT开头的令牌

# 或方法2：遗留应用密码（将于2026年6月弃用）
export ATLASSIAN_BITBUCKET_USERNAME="your_username"
export ATLASSIAN_BITBUCKET_APP_PASSWORD="your_app_password"

# 列出您的工作区
npx -y @aashari/mcp-server-atlassian-bitbucket ls-workspaces

# 列出工作区中的仓库
npx -y @aashari/mcp-server-atlassian-bitbucket ls-repos --workspace-slug your-workspace

# 获取特定仓库的详细信息
npx -y @aashari/mcp-server-atlassian-bitbucket get-repo --workspace-slug your-workspace --repo-slug your-repo

连接到AI助手

对于Claude桌面用户

在您的Claude配置文件（~/.claude/claude_desktop_config.json）中添加以下内容：

选项1：范围API令牌（推荐 - 面向未来）

{
  "mcpServers": {
    "bitbucket": {
      "command": "npx",
      "args": ["-y", "@aashari/mcp-server-atlassian-bitbucket"],
      "env": {
        "ATLASSIAN_USER_EMAIL": "your.email@公司.com",
        "ATLASSIAN_API_TOKEN": "your_scoped_api_token"
      }
    }
  }
}

选项2：遗留应用密码（将于2026年6月弃用）

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

重启Claude桌面，您将在状态栏看到“🔗 bitbucket”。

对于其他AI助手

大多数AI助手支持MCP。全局安装服务器：

npm install -g @aashari/mcp-server-atlassian-bitbucket

然后配置您的AI助手使用STDIO传输的MCP服务器。

可选：配置文件

创建~/.mcp/configs.json用于系统范围配置：

选项1：范围API令牌（推荐 - 面向未来）

{
  "bitbucket": {
    "environments": {
      "ATLASSIAN_USER_EMAIL": "your.email@公司.com",
      "ATLASSIAN_API_TOKEN": "your_scoped_api_token",
      "BITBUCKET_DEFAULT_WORKSPACE": "your_main_workspace"
    }
  }
}

选项2：遗留应用密码（将于2026年6月弃用）

{
  "bitbucket": {
    "environments": {
      "ATLASSIAN_BITBUCKET_USERNAME": "your_username",
      "ATLASSIAN_BITBUCKET_APP_PASSWORD": "your_app_password",
      "BITBUCKET_DEFAULT_WORKSPACE": "your_main_workspace"
    }
  }
}

可选配置键：系统还接受"atlassian-bitbucket"，"@aashari/mcp-server-atlassian-bitbucket"或"mcp-server-atlassian-bitbucket"代替"bitbucket"。

实际示例

🔍 探索您的仓库

询问您的AI助手：

• "列出我主工作区中的所有仓库"
• "显示后端api仓库的详细信息"
• "feature-auth分支的提交历史是什么？"
• "从主分支获取src/config.js的内容"

📋 管理拉取请求

询问您的AI助手：

• "显示所有需要审核的开放拉取请求"
• "获取拉取请求#42的详细信息，包括代码更改"
• "从feature-login到主分支创建一个拉取请求"
• "在PR #15中添加评论说测试已通过"
• "批准拉取请求#33"

🔧 使用分支和代码

询问您的AI助手：

• "比较我的功能分支与主分支"
• "从主分支创建一个名为hotfix-login的新分支"
• "列出user-service仓库中的所有分支"
• "显示提交abc123和def456之间的差异"

🔎 搜索和发现

询问您的AI助手：

• "搜索包含'认证'的JavaScript文件"
• "查找与登录功能相关的所有拉取请求"
• "搜索移动项目中的仓库"
• "显示使用React框架的代码文件"

故障排除

“身份验证失败”或“403禁止”

1. 选择正确的身份验证方法：

   • 标准Atlassian方法：使用您的Atlassian账户电子邮件+API令牌（适用于任何Atlassian服务）
   • Bitbucket特定方法：使用您的Bitbucket用户名+应用密码（仅限Bitbucket）

2. 对于Bitbucket应用密码（如果使用选项2）：

   • 前往Bitbucket应用密码
   • 确保您的应用密码具有正确的权限（工作区：读取，仓库：读取，拉取请求：读取）

3. 对于范围API令牌（推荐）：

   • 前往Atlassian API令牌
   • 确保您的令牌仍然有效并具有正确的范围
   • 更新您的~/.mcp/configs.json文件以使用新的范围API令牌格式：

   {
     "@aashari/mcp-server-atlassian-bitbucket": {
       "environments": {
         "ATLASSIAN_USER_EMAIL": "your.email@公司.com",
         "ATLASSIAN_API_TOKEN": "ATATT3xFfGF0..."
       }
     }
   }
   

4. 验证您的凭据：

   # 测试您的凭据是否有效
   npx -y @aashari/mcp-server-atlassian-bitbucket ls-workspaces
   

“未找到工作区”或“未找到仓库”

1. 检查您的工作区slug：

   # 列出您的工作区以查看正确的slug
   npx -y @aashari/mcp-server-atlassian-bitbucket ls-workspaces
   

2. 使用Bitbucket URL中的确切slug：

   • 如果您的仓库URL是https://bitbucket.org/myteam/my-repo
   • 工作区slug是myteam
   • 仓库slug是my-repo

“未配置默认工作区”

设置默认工作区以避免每次指定：

export BITBUCKET_DEFAULT_WORKSPACE="your-main-workspace-slug"

Claude桌面集成问题

1. 更新配置文件后重启Claude桌面
2. 检查状态栏是否有“🔗 bitbucket”指示器
3. 验证配置文件位置：
   • macOS：~/.claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

获取帮助

如果您仍然遇到问题：

1. 运行一个简单的测试命令以验证一切正常
2. 查看GitHub问题以查找类似的问题
3. 创建一个新的问题，附上错误消息和设置详情

常见问题

我需要哪些权限？

对于范围API令牌（推荐）：

• 您的常规Atlassian账户，具有访问Bitbucket的权限
• 在id.atlassian.com/manage-profile/security/api-tokens创建的范围API令牌
• 所需范围：repository，workspace（如果要管理PR，请添加pullrequest）

对于Bitbucket应用密码（遗留 - 正在被弃用）：

• 对于仅读访问（查看仓库、PR、提交）：
  • 工作区：读取
  • 仓库：读取
  • 拉取请求：读取
• 对于全部功能（创建PR、评论）：
  • 添加“写入”权限给仓库和拉取请求

我能使用这个工具处理私有仓库吗？

可以！此工具适用于公共和私有仓库。您只需通过您的Bitbucket应用密码拥有适当的权限即可。

我需要每次都指定工作区吗？

不需要！在环境或配置文件中设置BITBUCKET_DEFAULT_WORKSPACE，当您不指定时会自动使用。

这个工具支持哪些AI助手？

任何支持模型上下文协议（MCP）的AI助手：

• Claude桌面（最受欢迎）
• Cursor AI
• Continue.dev
• 许多其他

我的数据安全吗？

是的！此工具：

• 完全在您的本地机器上运行
• 使用您自己的Bitbucket凭据
• 从未将您的数据发送给第三方
• 只访问您授予其权限的内容

我能使用这个工具处理多个Bitbucket账户吗？

目前，每个安装只支持一组凭据。对于多个账户，您需要单独的配置。

支持

需要帮助？这里是获取帮助的方式：

1. 查看上面的故障排除部分 - 大多数常见问题都在那里解决
2. 访问我们的GitHub存储库获取文档和示例：github.com/aashari/mcp-server-atlassian-bitbucket
3. 报告问题在GitHub问题
4. 发起讨论针对功能请求或一般问题

---

由❤️为希望将AI引入Bitbucket工作流程的开发者制作。