How to connect Bitbucket to ChatGPT

  • ChatGPT gets 24 Bitbucket tools through one Metorial MCP URL.
  • Setup is 4 steps; teammates then sign in with SSO.
  • You need a ChatGPT plan or workspace that allows custom MCP servers.

What ChatGPT can do with Bitbucket

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Ask ChatGPT to use the manage pull request tool in Bitbucket
  • Ask ChatGPT to use the list workspace members tool in Bitbucket
  • Ask ChatGPT to use the update repository tool in Bitbucket
  • Ask ChatGPT to use the list pull requests tool in Bitbucket
  • Ask ChatGPT to use the manage projects tool in Bitbucket

Add the Bitbucket MCP server to ChatGPT

Run these once. Afterwards, everyone you give access to signs in the same way.

  1. 1. Enable Bitbucket in Metorial

    In your Metorial portal, enable the Bitbucket MCP server and sign in with the account that owns the data. Access stays governed by your team policies.

  2. 2. Add a custom MCP server

    On ChatGPT web, open Plugins, select +, then Add custom MCP server.

  3. 3. Paste your Metorial MCP URL

    Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>), choose OAuth and accept the risk notice.

  4. 4. Create and install the plugin

    Select Create as a plugin, install it and sign in to load Bitbucket tools.

Give your team Bitbucket in ChatGPT

Once Bitbucket is enabled in Metorial, teammates sign in with SSO and get the same connection in ChatGPT, with only the tools their role allows.

One link covers every app you approve. See how the MCP gateway handles access, roles and audit logs for the whole company.

Bitbucket tools available in ChatGPT

Full descriptions and inputs are on the Bitbucket MCP server page.

  • Delete Repository: Permanently delete a repository from the workspace.
  • Browse Source: Browse repository source files at a specific revision (branch, tag, or commit hash).
  • Get Pull Request: Retrieve detailed information about a specific pull request including its description, reviewers, merge details, and comments summary.
  • Fork Repository: Fork an existing repository.
  • Manage Branches: List, create, or delete branches in a repository.
  • Manage Pull Request: Perform actions on a pull request: **approve**, **unapprove**, **merge**, **decline**, **request_changes**, or **remove_change_request**.
  • List Workspace Members: List all members in the configured workspace.
  • Update Repository: Update repository settings (wiki, fork policy, project, privacy, language, name, description).
  • List Pull Requests: List pull requests for a repository.
  • Manage Projects: List, create, update, or delete projects in the workspace.
  • Manage Pipelines: List, get, trigger, or stop Bitbucket Pipelines.
  • Create Pull Request: Create a new pull request to merge changes from a source branch into a destination branch.
  • Search Code: Search for code across repositories in the workspace, optionally scoped to one repository.
  • List Commits: List commits in a repository, optionally filtered by branch.
  • Create Repository: Create a new Git repository in the configured workspace.
  • And 9 more on the Bitbucket MCP server page.

Using Bitbucket tools in ChatGPT

What to expect once Bitbucket is connected.

  • Type @ and pick the plugin. The selection applies to that message only, so @mention it again when a follow-up needs fresh Bitbucket data.
  • For write actions, ChatGPT may ask you to confirm first, depending on the app permissions and the action.
  • Once published for a workspace, ChatGPT keeps a snapshot of the tool list. When your team adds Bitbucket tools in Metorial, an admin refreshes the actions in Workspace settings before they appear.
  • You can use several apps in one prompt, for example read Bitbucket data and then create a ticket in another app.

Troubleshooting ChatGPT

Add custom MCP server is missing
Workspace policy controls it. On Enterprise and Edu, an admin grants the permission to create plugins with MCPs; ask them to enable it for you.
The plugin exists but no tools appear
Creating the plugin is not enough: install it from your plugins, then start a new conversation so ChatGPT loads its tools.
ChatGPT answers without using the tools
Pick the plugin with @ in the composer and name the action you want, for example "use Metorial to look up the latest ticket".

Based on the ChatGPT MCP documentation.

Frequently asked questions

Common questions about connecting Bitbucket to AI agents with Metorial.

  1. Does ChatGPT support the Bitbucket MCP server?
    Yes. ChatGPT connects to the Bitbucket MCP server through its connector settings, pointed at your Metorial URL. You need a ChatGPT plan or workspace that allows custom MCP servers.
  2. No. You sign in to Bitbucket once through Metorial, and ChatGPT uses that connection. No API keys go into ChatGPT's settings.
  3. All 24 Bitbucket tools your team allows, such as Delete Repository, Browse Source, Get Pull Request. Admins can narrow that list per team.
  4. Yes. Role-based access control decides who can use Bitbucket and which of its tools appear in ChatGPT, and every call is logged with the person's identity.
  5. Workspace policy controls it. On Enterprise and Edu, an admin grants the permission to create plugins with MCPs; ask them to enable it for you.

Connect Bitbucket to other AI clients

Connect other apps to ChatGPT