> ## Documentation Index
> Fetch the complete documentation index at: https://felan.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Bitbucket Server

> Connect Bitbucket Server or Data Center repositories to your Felan team.

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

<Steps>
  <Step title="Open Integrations">
    Select the Felan team that should use Bitbucket, then open **Integrations** from the main navigation.
  </Step>

  <Step title="Configure Bitbucket Server">
    Find **Bitbucket Server**, click **Configure**, and enter the instance base URL and personal access token.
  </Step>

  <Step title="Choose connectivity">
    Enable **Private Connectivity** when the instance is behind your firewall, then save the configuration.
  </Step>
</Steps>

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.