Connect Bitbucket to Windsurf
To use Bitbucket in Windsurf, connect your Bitbucket account in Manyplug and add Manyplug to Windsurf once. Windsurf then gets 9 Bitbucket tools, for example: “Repositories”, “Pull requests”, and “Get a pull request”. It takes about 4 minutes and works on the free plan.
Connect Bitbucket Free plan, no card
1. Connect Bitbucket in Manyplug
Click “Connect Bitbucket” and paste the key or app password into Manyplug’s form:
Your workspace, Atlassian email and an API token with Bitbucket scopes. Takes about two minutes.
- Open your Atlassian account settings → Security → API tokens and click Create API token with scopes.Open Atlassian API tokens
- Pick the Bitbucket app and the scopes read:repository, read:pullrequest, write:pullrequest and read:pipeline.
- Create the token and copy it.
- In the form, enter the workspace (acme for bitbucket.org/acme/), your Atlassian email and the token.
- Bitbucket app passwords are no longer issued: use an Atlassian API token.
- The AI merges only after you confirm.
2. Add Manyplug to Windsurf
Windsurf Editor.
- Add the server to ~/.codeium/windsurf/mcp_config.json.
{ "mcpServers": { "manyplug": { "serverUrl": "https://manyplug.com/mcp" } } } - Refresh the MCP servers and sign in.
3. Ask Windsurf
- Which pull requests are open in the api repository on Bitbucket?
- Summarize PR #42 and its comments.
- Why did the last pipeline on main fail?
- Approve PR #42 and comment “LGTM”.
What Windsurf can do in Bitbucket
Each action can be turned off per account, and changes can wait for your OK.
| Action | Access |
|---|---|
| Repositories Repositories of the workspace. | Reads |
| Pull requests Pull requests by state. | Reads |
| Get a pull request Description, reviewers, approvals. | Reads |
| Comments Comments of a PR, inline ones included. | Reads |
| Comment A comment on a PR. | Makes changes |
| Comment on a line A comment on a line of a changed file. | Makes changes |
| Approve Approves a PR as you. | Makes changes |
| Merge Merges a PR into its destination. | Risky |
| Pipelines Pipeline runs and their results. | Reads |
Questions
Can I connect two Bitbucket accounts to Windsurf?
Yes. Connect each one in Manyplug under its own name, for example Work and Personal. Windsurf can use one of them or all at once.
Will Windsurf change anything in Bitbucket without asking?
By default these actions wait for your approval before they run: “Merge”. Other changes follow your rules, which you can make stricter per account.
Do I need an official Bitbucket MCP server for this?
No. Manyplug connects to Bitbucket itself with a key or app password you paste into its form, and gives Windsurf the tools through one MCP address, together with your other services.
Is it free to connect Windsurf to Manyplug?
Yes. New workspaces get 14 days of Pro free, then the free plan keeps going with 150 actions a month and up to 3 connected accounts. No card needed. Paid plans start at $5 a month.
Does Windsurf see my passwords or API keys?
No. Keys are entered on Manyplug’s own pages, stored encrypted with a separate key per account, and the AI only receives tool results.