Connect Jira, GitHub, GitLab, monday.dev, Linear, Azure Boards, and Azure Repos

MergeLoom integrates with your existing delivery tools so tickets can move from Jira, GitHub Issues, GitLab Issues, monday.dev, Linear, or Azure Boards into code review.

Supported current paths include:

• Jira intake
• monday.dev intake
• GitHub Issues intake
• GitLab Issues intake
• Linear intake
• Azure Boards intake
• GitHub PR output
• GitLab MR output
• Azure Repos PR output

This is in the customer controller

Connect work trackers and code hosts from https://controller.mergeloom.ai. The local worker UI is for worker/provider setup; integrations live in the customer controller.

Customer controller: connect Jira, GitHub, GitLab, monday.dev, Linear, Azure Boards, Azure Repos, and code hosts from the integrations page.

Integration model

There are two different integration roles:

Role	Examples	What it does
Work tracker	Jira, GitHub Issues, GitLab Issues, monday.dev, Linear, Azure Boards	Supplies tickets or issues for intake.
Code host	GitHub, GitLab, Azure Repos	Supplies repositories and receives PRs or MRs.

Some tools can be both intake source and code host. For example, GitHub Issues can be intake and GitHub can be PR output.

Jira

Jira uses an Atlassian OAuth app.

Callback URL pattern:

https://controller.mergeloom.ai/api/integrations/jira/callback

Requested scopes:

read:jira-user
read:jira-work
write:jira-work
offline_access

Use Jira when:

• Jira is your source of truth for work
• you want JQL intake
• you want Jira comments and status transitions to reflect MergeLoom progress

monday.dev

monday.dev uses monday.com OAuth.

Callback URL:

https://controller.mergeloom.ai/api/integrations/monday/callback

Default scopes:

me:read account:read workspaces:read boards:read boards:write updates:read updates:write

Use monday.dev when:

• monday.com boards are your source of truth for work
• you want board items to enter the same controlled ticket-to-code workflow
• you want MergeLoom to update item comments and status labels as work moves

GitHub

GitHub uses a GitHub App.

The app is used for:

• GitHub issue intake
• repository clone/fetch/push
• PR creation and updates

Recommended minimum repository permissions:

Permission	Access
Contents	Read and write
Pull requests	Read and write
Issues	Read and write
Metadata	Read-only

Install callback URL:

https://controller.mergeloom.ai/api/integrations/github/callback

Code host: once GitHub is connected, MergeLoom can push review branches and create PRs from approved ticket-to-code jobs.

GitLab

GitLab uses OAuth.

Callback URL:

https://controller.mergeloom.ai/api/integrations/gitlab/callback

Current operator inputs:

JCA_CONTROL_PLANE_GITLAB_CLIENT_ID=
JCA_CONTROL_PLANE_GITLAB_CLIENT_SECRET=
JCA_CONTROL_PLANE_GITLAB_BASE_URL=
JCA_CONTROL_PLANE_GITLAB_API_URL=
JCA_CONTROL_PLANE_GITLAB_SCOPES=

Use GitLab when:

• GitLab Issues are your intake source
• GitLab repositories are your execution target
• Merge requests are your review output

Azure Boards

Azure Boards uses an Entra app.

Redirect URI:

https://controller.mergeloom.ai/api/integrations/azure-boards/callback

Default scope:

499b84ac-1321-427f-aa17-267ca6975798/user_impersonation offline_access openid profile email

The connected account needs enough Azure DevOps access for:

• reading work items
• adding comments
• changing states

Connect in the MergeLoom controller

From https://controller.mergeloom.ai:

1. Open the integrations page.
2. Connect the work tracker.
3. Connect the code host.
4. Confirm the connection shows as ready.
5. Sync the repository catalog if a code host was connected.

Customer controller: after connecting GitHub or GitLab, sync the repository catalog and enable only the repositories MergeLoom should work on.

After connecting

Next, configure:

• global intake source
• code output target
• repository catalog
• repository aliases
• workflow labels and states
• validation commands

Do not run a real job until the target repository is enabled and writable in the repository catalog.