GitHub and GitHub Enterprise Server

MergeHarbor connects to GitHub through a GitHub App, which grants access only to the repositories you select.

Install the app

1. In the console, open Settings → Code hosts (or the setup checklist) and choose GitHub.
2. Choose the GitHub account or organization and the repositories to grant.
3. GitHub returns you to MergeHarbor, which confirms that your GitHub account can access the installation, attaches it to your organization, and starts indexing.

If your GitHub organization requires an owner to approve app installations, the checklist shows Waiting for approval until an owner approves it on GitHub.

Permissions

Permission	Access	Used for
Contents	Read	Reading code to index and review
Metadata	Read	Listing repositories
Pull requests	Read and write	Posting reviews and comments
Checks	Read and write	The MergeHarbor status check
Issues	Read and write	Replying to @mergeharbor commands in pull-request conversations

Events: pull request, issue comment, push, installation, and installation repositories.

GitHub Enterprise Server

On MergeHarbor Cloud, your GitHub Enterprise Server instance must be reachable from MergeHarbor. For instances on private networks, use a self-hosted deployment, where your operator registers a GitHub App on your instance.

Status checks

Make MergeHarbor a required status check in your branch protection rules to gate merges on review results. Configure when the check fails in Configure reviews.