Skip to main content
The Bitbucket Server integration connects a self-hosted Bitbucket Server or Data Center instance with a base URL and personal access token. The connection belongs to the selected Felan team.

​
Requirements

  • A Bitbucket Server or Data Center base URL
  • A personal access token with Repositories: Write permission, which includes read access
  • Private Connectivity configured when the instance is available only through your network

​
Setup

1

Open Integrations

Select the Felan team that should use Bitbucket, then open Integrations from the main navigation.
2

Configure Bitbucket Server

Find Bitbucket Server, click Configure, and enter the instance base URL and personal access token.
3

Choose connectivity

Enable Private Connectivity when the instance is behind your firewall, then save the configuration.
Saving stores the configuration without requiring a live connection check. Felan verifies access when it enumerates repositories.

​
Supported behavior

  • Enumerate and clone repositories authorized by the token
  • Push session branches and open or update pull requests
  • Discover repository-hosted SKILL.md files under .agents/skills/

​
Limitations

  • This connector supports Bitbucket Server and Data Center, with provider ID bitbucket-server.
  • Bitbucket Cloud is not handled by this connector.
  • Inbound Bitbucket Server webhooks are not currently registered by this integration.

​
Troubleshooting

Repository enumeration fails — Confirm the base URL, token, and Repositories: Write permission. A private instance is unreachable — Confirm that Private Connectivity is enabled both for the team and for this integration.