How to integrate Bitbucket MCP with DeepSeek Harness

Connect DeepSeek Harness to Bitbucket MCP. Create a new branch off main, open a pull request for your feature, and more using natural language, with authentication handled for you.

Get started for free Get a demo

Bitbucket

Oauth2

Bitbucket is a Git-based code hosting and collaboration platform for teams. It enables secure repository management and streamlined code reviews.

105 Tools

Managed auth

Connect Bitbucket without auth hassles

We manage OAuth, API keys, token refresh, and scopes — you just build.

Book a call

Explore the MCP Gateway

Introduction

DeepSeek Harness (dsh) is an open-source agent runtime from DeepSeek AI, and every part of it is a plugin, so you can swap out the model adapter, the tool registry, or the agent loop. It runs on the Cordis framework and comes with a local Web UI, a headless CLI runner, and a Python SDK. You can point it at DeepSeek V4-Pro and V4-Flash, or at Anthropic, OpenAI, and other OpenAI-compatible providers. It is MIT licensed and still in developer preview.

This guide shows how to connect your Bitbucket account to DeepSeek Harness, and you can do it with either the Composio Connect CLI or the Composio Connect MCP. The dsh-base bundle gives shell execution as a first-class tool, so the CLI is the easiest path for personal use. It is quick to set up and needs no server config, and the MCP path works well too, since the harness comes with a built-in MCP client.

What is Composio Connect?

Composio Connect lets anyone plug 1,000+ applications directly into their agent harness, including DeepSeek Harness, through a single hosted MCP endpoint. Each task runs as a session, a scoped runtime that ties together the user, the available toolkits, authentication, and execution state. It can:

Discover and load tools on-demand. A small set of meta tools lets the agent search for the right tool at runtime, so you never load hundreds of tool definitions into context.
Chain tools in a sandboxed remote workbench. Multi-step workflows run server-side, passing outputs between tools and working with files in the session's sandbox, so long chains finish without a lot of back-and-forth with the LLM.
Manage authentication end-to-end. Managed OAuth, per-user connected accounts, and account isolation are all handled for you, so you never wire up auth yourself.

Connect Bitbucket to DeepSeek Harness with Composio

Prerequisites: Install DeepSeek Harness

DeepSeek Harness needs Node.js (20 or 22) and pnpm. Build it from source. This is also what the MCP path in Option 2 requires, since the built-in MCP client resolves its dependencies from the checkout:

bash

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

The Web UI listens on http://127.0.0.1:3080 by default. Open that address to confirm it is up.

Then configure your model route. In the Web UI, open Settings → Models: the built-in DeepSeek card accepts a DeepSeek API key, and the same page supports Anthropic, OpenAI, and custom OpenAI-compatible endpoints. Full first-run details are in the DeepSeek Harness docs.

Option 1: Composio CLI (recommended)

DeepSeek Harness runs shell commands as a first-class tool through its dsh-base bundle, so the Composio Universal CLI fits well. There is no MCP server to configure, and multi-step tool chaining is reliable. Install and authenticate:

bash

# Install the Composio CLI
curl -fsSL https://composio.dev/install | bash

# Log in to Composio
composio login

Connect to Bitbucket

Ask DeepSeek Harness to connect to Bitbucket, or just request any Bitbucket-related task. Under the hood the agent calls Composio commands like any other shell tool:

bash

composio search "what can I do with Bitbucket?"
composio link bitbucket

On the first Bitbucket call, composio link bitbucket opens an OAuth prompt so you can authorize access. After that, every Bitbucket command works with your stored credentials automatically, so you just talk to the agent and it will search, execute, and chain Bitbucket tools as needed.

Option 2: Composio MCP

DeepSeek Harness bridges MCP through its built-in @deepseek-ai/dsh-mcp-client plugin. You register one server as a plugin row, and its tools appear under server-qualified names (mcp__<serverName>__<rawName>), the same shape Claude Code and Codex use.

MCP requires the source build. The built-in client depends on the harness's own internal packages (cordis, dsh-llm, dsh-tools, dsh-invariants, dsh-subprocess), which resolve from the git checkout you built in the prerequisites. Run everything below from that checkout with pnpm dsh. For a route that avoids editing config files, see the community plugin at the end of this section.

Auth note: The built-in client passes static headers only and has no OAuth flow, so authenticate to Composio Connect with the x-consumer-api-key header. For Composio's OAuth flow, use the community plugin below.

1. Register the Composio server

The web profile's user patch layer is $DSH_HOME/profiles/web/cordis.patch.yml ($DSH_HOME defaults to ~/.dsh). This is a patch file, so a new plugin goes under an insert: entry. A bare - id: row instead targets an existing entry and fails to boot with patch: entry "…" not found. Add:

bash

- insert:
    - id: mcp-composio
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: composio
        transport: streamable-http
        url: https://connect.composio.dev/mcp
        headers:
          x-consumer-api-key: !!js process.env.COMPOSIO_API_KEY

2. Set the API key and launch

The header value must resolve to a string at load time. Export your Composio consumer API key (ck_...), which is on the Connect → Settings → Sessions page of the Composio dashboard, in the shell you launch from. If it is unset, process.env.COMPOSIO_API_KEY is undefined and the config fails validation:

bash

export COMPOSIO_API_KEY=ck_your_key
pnpm dsh web

3. Done!

Open http://127.0.0.1:3080 and start a session on Standard or Code mode. (Minimal mode exposes only bash and str_replace_editor, so it hides MCP tools.) Composio's tools register as mcp__composio__*. Ask DeepSeek Harness to connect to Bitbucket or request any Bitbucket-related task, and Composio authorizes Bitbucket on demand on the first call.

The dsh-mcp-client config schema (transport, serverName, url, headers, plus reconnect.* and toolCallTimeoutMs) is the current developer-preview interface and may change between releases.

Alternative: OAuth via the community plugin

To use Composio Connect's OAuth flow instead of a static key, or to skip editing cordis.patch.yml by hand, use the community dsh-mcp-manager plugin. It installs as a self-contained external plugin, ships a bundle patch so it auto-mounts, and adds a Settings → MCP page plus OAuth (authorization code + PKCE, RFC 7591 dynamic client registration, and refresh-token rotation). It needs the web profile and Node.js ^22.19 or >=24, with pnpm on your PATH.

Install it from your source checkout, then restart pnpm dsh web and refresh:

bash

pnpm dsh plugin --profile web add github:hyqhyq3/dsh-mcp-manager

Open Settings → MCP → ＋ Add MCP server, choose HTTP, set the name to composio, the URL to https://connect.composio.dev/mcp, and the auth mode to OAuth. Click Authenticate, and Composio's login and consent screen opens in the browser, then redirects back and registers the tools as mcp__composio__*. The row should read connected (N tools).

The plugin catches the OAuth code on a loopback redirect (http://127.0.0.1:<port>/mcp-manager/callback/<id>), so Composio's OAuth provider must allow that loopback URL. Server configs and tokens persist at ~/.dsh/mcp-manager.json, so treat that file as a secret. Being a community plugin on a preview harness, its commands may change, so check the plugin repo if a step drifts.

What is the Bitbucket MCP server, and what's possible with it?

The Bitbucket MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Bitbucket account. It provides structured and secure access to your repositories, issues, and pull requests, so your agent can create branches, manage issues, review code, and handle repository operations for you.

Branch and repository management: Let your agent create new branches for feature work or initialize fresh repositories within your Bitbucket workspace—no manual setup required.
Automated issue tracking: Have your agent create, comment on, or delete issues to streamline team collaboration and bug tracking directly from your workflows.
Pull request automation: Empower your agent to open new pull requests for code review, ensuring changes are properly tracked and integrated.
File and snippet operations: Ask your agent to fetch specific files from any branch or commit, or to post comments on code snippets for contextual discussions.
User profile and workspace insights: Retrieve your Bitbucket user profile details on demand, making it easy to personalize and audit agent-driven actions.

Way Forward

With Bitbucket connected, DeepSeek Harness can now act on your behalf whenever you ask it to.

From here, you can extend the harness further:

Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup, and each new integration adds to what your agent can do for you.
Build workflows across tools: Once multiple apps are connected, DeepSeek Harness can chain actions together, so it can turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
Use the plugin system: Wrap common Bitbucket flows as dsh plugins or prompt templates so recurring tasks become one-line commands, and bundle your most-used Bitbucket tools into a named profile you can boot on demand.

If you run into trouble or want to share what you've built, join the community or check out the Docs for more configuration options.

TOOLS

Supported Tools

Every Bitbucket action and event your agent gets out of the box.

Approve Pull Request

Tool to approve a pull request as the authenticated user.

Browse repository path

Tool to retrieve content for a file path or browse directory contents at a specified revision in a Bitbucket repository.

Create a branch

Creates a new branch in a Bitbucket repository from a target commit hash; the branch name must be unique, adhere to Bitbucket's naming conventions, and not include the 'refs/heads/' prefix.

Create an issue

Creates a new issue in a Bitbucket repository, setting the authenticated user as reporter; ensures assignee (if provided) has repository access, and that any specified milestone, version, or component IDs exist.

Create an issue comment

Adds a new comment with markdown support to an existing Bitbucket issue.

Create a pull request

Creates a new pull request in a specified Bitbucket repository, ensuring the source branch exists and is distinct from the (optional) destination branch.

Create pull request comment

Creates a new comment on a Bitbucket pull request.

Create commit report annotations

Adds multiple annotations to a commit report in bulk.

List commits from revision (POST)

Tool to list commits from a revision using POST method.

Create repository

Creates a new Bitbucket 'git' repository in a specified workspace, defaulting to the workspace's oldest project if `project_key` is not provided.

Create snippet comment

Posts a new top-level comment or a threaded reply to an existing comment on a specified Bitbucket snippet.

Create team pipeline variable

Creates a team-level pipeline configuration variable in Bitbucket.

Create user pipeline variable

Creates a user-level pipeline variable for Bitbucket pipelines.

Delete commit comment

Permanently deletes a specific comment on a commit.

Delete issue

Permanently deletes a specific issue, identified by its `issue_id`, from the repository specified by `repo_slug` within the given `workspace`.

Delete pull request comment

Permanently deletes a specific pull request comment (top-level, inline, or threaded reply).

Delete commit report annotation

Deletes a single annotation matching the provided ID from a commit report.

Delete repository

Permanently deletes a specified Bitbucket repository; this action is irreversible and does not affect forks.

Delete snippet watch

Stops watching a specific snippet.

Delete user pipeline variable

Permanently deletes a user-level pipeline configuration variable identified by its UUID.

Get branch

Retrieves detailed information about a specific branch in a Bitbucket repository.

Get Commit Build Status

Get a specific build status for a commit in Bitbucket.

Get Commit Changes

Tool to retrieve a page of changes made in a specified commit, showing all changed files with their change statistics (lines added/removed, status).

Get commit comment

Retrieves a specific comment from a commit by its ID.

Get Commit Diff

Tool to retrieve the unified diff between two provided revisions or for a single commit in a Bitbucket repository.

Get current user (v2)

Tool to retrieve complete profile information for the currently authenticated Bitbucket user.

Get deployment environment variables

Retrieves deployment environment level variables for a specific Bitbucket repository environment.

Get file from repository

Retrieves a specific file's content from a Bitbucket repository at a given commit (hash, branch, or tag), failing if the file path is invalid for that commit.

Get hook events

Retrieves a paginated list of all valid webhook events for a specified entity type (repository or workspace).

Get OpenID configuration for OIDC in Pipelines

Retrieves the OpenID Connect discovery configuration for Bitbucket Pipelines OIDC.

Get Pull Request

Get a single pull request by ID with complete details.

Get pull request comment

Tool to retrieve a specific comment from a pull request by its ID.

Get Pull Request Commits

Tool to retrieve commits for a specified pull request.

Get Pull Request Diff

Tool to fetch the unified diff for a Bitbucket pull request (follows 302 redirect to repository diff).

Get Pull Request Diffstat

Tool to get the diffstat for a Bitbucket pull request, showing all changed files with their change statistics (lines added/removed, status).

Get Repository Branching Model

Return the branching model as applied to the repository.

Get Repository Commit

Tool to retrieve detailed information about a specific commit in a Bitbucket repository.

Get commit comments

Retrieves all comments on a specific commit in a Bitbucket repository.

Get commit report

Returns a single report matching the provided ID from a commit.

Get Commit Reports

Tool to get reports linked to a specific commit.

Get commit report annotation

Returns a single annotation matching the provided ID from a commit report.

Get commit statuses

Returns all build statuses (e.

Get effective branching model

Retrieves the effective branching model for a Bitbucket repository, showing which branching model is currently applied (including any inheritance from project-level settings).

Get Repository Environment

Retrieve detailed information about a specific deployment environment in a Bitbucket repository.

Get file commit history

Returns a paginated list of commits that modified the specified file.

Check if user voted for issue

Tool to check whether the authenticated user has voted for a specific issue in a Bitbucket repository.

Get Repositories Merge Base

Get the merge base (best common ancestor) between two commits in a Bitbucket repository.

Get specific pipeline

Retrieve a specified pipeline from a Bitbucket repository.

Get repository pipelines caches

Retrieves the repository pipelines caches.

Get repository pipeline runners

Retrieves the list of self-hosted runners configured for a repository's pipelines.

Get repository pipeline schedules

Retrieves configured pipeline schedules for a Bitbucket repository.

Get repository SSH known hosts

Retrieves repository-level SSH known hosts configured for Bitbucket Pipelines.

Get repository pipeline variables

Retrieves repository-level pipeline variables for a specific Bitbucket repository.

Get pipeline steps

Retrieves all steps for a given pipeline.

Get pull requests activity log

Get paginated activity log for all pull requests in a repository.

Get pull request comments

Retrieves a paginated list of comments on a specific pull request in a Bitbucket repository.

Get pull request statuses

Returns all build statuses (e.

Get repository refs

Returns the branches and tags in the repository.

Get tag

Retrieves detailed information about a specific tag in a Bitbucket repository.

Get repositories src

Lists the contents of the root directory on the repository's main branch without needing to specify a commit or branch.

Get repository watchers

Retrieves a paginated list of all the watchers on the specified repository.

Get repository

Retrieves detailed information about a specific repository in a Bitbucket workspace.

Get Repository Patch

Tool to retrieve the git patch content for a Bitbucket repository at a specified revision or commit range.

Get snippet

Retrieves a specific Bitbucket snippet by its encoded ID from an existing workspace, returning its metadata and file structure.

Get snippet watch status

Checks if the current user is watching a specific snippet.

Get SSH keys for user

Retrieves a paginated list of SSH keys for a specified Bitbucket user.

Get user

Retrieves public profile information for a specific Bitbucket user by username or UUID.

Get user emails

Returns all the authenticated user's email addresses, both confirmed and unconfirmed.

Get user email details

Retrieves details about a specific email address for the authenticated user.

Get user permissions for repositories

Returns an object for each repository the caller has explicit access to, including their permission level.

Get user permissions for workspaces

Retrieves workspace memberships and permission levels for the authenticated user.

Get user workspaces

Tool to retrieve all workspaces accessible to the authenticated user.

Get workspace

Retrieves detailed information about a specific Bitbucket workspace.

Get Workspace Pull Requests by User

Tool to get all workspace pull requests authored by a specified user.

Search code in workspace

Tool to search for code in the repositories of the specified workspace.

List branches

Lists branches in a Bitbucket repository with optional server-side filtering by name pattern (BBQL) and sorting.

List commits

Tool to retrieve a page of commits from a Bitbucket repository.

List commits from revision

Tool to list commits starting from a specific revision in a Bitbucket repository.

List commits on master

Lists commits on the master branch of a Bitbucket repository.

List deployments

Lists deployments for a specified Bitbucket repository.

List issues in a repository

Lists issues in a Bitbucket repository with optional filtering by state, priority, kind, or assignee.

List pipelines

Tool to find pipelines in a Bitbucket repository.

List pull requests

Lists pull requests in a specified, accessible Bitbucket repository, optionally filtering by state (OPEN, MERGED, DECLINED).

List pull request tasks

Lists all tasks associated with a pull request in a Bitbucket repository.

List all public repositories

Retrieves a paginated list of all public repositories on Bitbucket.

List repository environments

List all deployment environments configured for a Bitbucket repository.

List repositories in workspace

Lists repositories in a specified Bitbucket workspace, accessible to the authenticated user, with options to filter by role or query string, and sort results.

List repository paths

Lists file and directory entries under a repository path at a given revision, with optional breadth-first recursion via max_depth for repository traversal and scanning.

List snippets

Returns all snippets accessible to the authenticated user.

List tags

Lists tags in a Bitbucket repository with optional server-side filtering by name pattern or commit hash (BBQL) and sorting.

List versions

Lists versions (milestones) in a Bitbucket repository's issue tracker.

List workspace members

Lists all members of a specified Bitbucket workspace; the workspace must exist.

List workspace projects

Lists projects in a specified Bitbucket workspace.

List workspaces

Lists Bitbucket workspaces accessible to the authenticated user, optionally filtered and sorted.

Merge Pull Request

Tool to merge a Bitbucket Cloud pull request via the REST API.

Request Pull Request Changes

Tool to request changes on a pull request as the authenticated user.

Resolve pull request comment

Tool to resolve or reopen a pull request comment thread.

Search code in user repositories

Tool to search for code in the repositories of a specified user.

Update commit insight report

Create or update an insight report for a commit.

Update an issue

Updates an existing issue in a Bitbucket repository by modifying specified attributes; requires `workspace`, `repo_slug`, `issue_id`, and at least one attribute to update.

Update Pull Request

Tool to update an existing pull request's editable fields (e.

Update commit comment

Updates the contents of a comment on a commit.

Update commit report annotation

Creates or updates an individual annotation for a commit report.

Update team pipeline variable

Updates a team-level pipeline configuration variable in Bitbucket.

Update user pipeline variable

Updates a user-level pipeline variable for Bitbucket pipelines.

FRAMEWORKS

How to build Bitbucket MCP Agent with another framework

ChatGPT Work

Use Bitbucket MCP with ChatGPT Work

Antigravity

Use Bitbucket MCP with Antigravity

OpenAI Agents SDK

Use Bitbucket MCP with OpenAI Agents SDK

Claude Agent SDK

Use Bitbucket MCP with Claude Agent SDK

Claude Code

Use Bitbucket MCP with Claude Code

Claude Cowork

Use Bitbucket MCP with Claude Cowork

Codex

Use Bitbucket MCP with Codex

Kimi Code

Use Bitbucket MCP with Kimi Code

Grok Build

Use Bitbucket MCP with Grok Build

Cursor

Use Bitbucket MCP with Cursor

VS Code

Use Bitbucket MCP with VS Code

OpenCode

Use Bitbucket MCP with OpenCode

OpenClaw

Use Bitbucket MCP with OpenClaw

Hermes

Use Bitbucket MCP with Hermes

Pi

Use Bitbucket MCP with Pi

CLI

Use Bitbucket MCP with CLI

Google ADK

Use Bitbucket MCP with Google ADK

LangChain

Use Bitbucket MCP with LangChain

Vercel AI SDK

Use Bitbucket MCP with Vercel AI SDK

Mastra AI

Use Bitbucket MCP with Mastra AI

LlamaIndex

Use Bitbucket MCP with LlamaIndex

CrewAI

Use Bitbucket MCP with CrewAI

Pydantic AI

Use Bitbucket MCP with Pydantic AI

AutoGen

Use Bitbucket MCP with AutoGen

MORE TOOLKITS

Explore Other Toolkits

Toolkit marketplace

Supabase

Oauth2Api Key

Supabase is an open-source backend platform offering scalable Postgres databases, authentication, storage, and real-time APIs. It lets developers build modern apps without managing infrastructure.

Codeinterpreter

No Auth

Codeinterpreter is a Python-based coding environment with built-in data analysis and visualization. It lets you instantly run scripts, plot results, and prototype solutions inside supported platforms.

GitHub

Oauth2

GitHub is a code hosting platform for version control and collaborative software development. It streamlines project management, code review, and team workflows in one place.

1password

Api Key

1Password is a password manager and digital vault for storing logins, secrets, notes, and secure documents. It helps individuals and teams protect credentials, share access safely, and reduce password risk.

FAQ

Frequently asked questions

With a standalone Bitbucket MCP server, the agents and LLMs can only access a fixed set of Bitbucket tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Bitbucket and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. DeepSeek Harness fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Bitbucket tools.

Yes, absolutely. You can configure which Bitbucket scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Bitbucket data and credentials are handled as safely as possible.

Start with Bitbucket.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Bitbucket tool your agent needs.Free to start.

Start building

How to integrate Bitbucket MCP with DeepSeek Harness

Connect Bitbucket without auth hassles

Introduction

Also integrate Bitbucket with

What is Composio Connect?

Connect Bitbucket to DeepSeek Harness with Composio

Prerequisites: Install DeepSeek Harness

Option 1: Composio CLI (recommended)

Connect to Bitbucket

Option 2: Composio MCP

1. Register the Composio server

2. Set the API key and launch

3. Done!

Alternative: OAuth via the community plugin

What is the Bitbucket MCP server, and what's possible with it?

Way Forward

Supported Tools

How to build Bitbucket MCP Agent with another framework

ChatGPT Work

Antigravity

OpenAI Agents SDK

Claude Agent SDK

Claude Code

Claude Cowork

Codex

Kimi Code

Grok Build

Cursor

VS Code

OpenCode

OpenClaw

Hermes

Pi

CLI

Google ADK

LangChain

Vercel AI SDK

Mastra AI

LlamaIndex

CrewAI

Pydantic AI

AutoGen

Explore Other Toolkits

Supabase

Codeinterpreter

GitHub

1password

Frequently asked questions

What are the differences in Tool Router MCP and Bitbucket MCP?+

Can I use Tool Router MCP with DeepSeek Harness?+

Can I manage the permissions and scopes for Bitbucket while using Tool Router?+

How safe is my data with Composio Tool Router?+

Start with Bitbucket.It takes 30 seconds.