Documentation
IntegrationsGitLab

GitLab

Connect GitLab so Fabric agents and workflows can create and search issues as runtime actions.

Connect GitLab to Fabric AI so agents and workflows can create and search issues across your GitLab projects — as live runtime actions.

GitLab is a Hybrid provider: it offers both knowledge (search) and write (create) actions.

Fabric uses GitLab's official MCP server ("GitLab (Official)", available on GitLab Premium/Ultimate). On accounts without it, Fabric falls back to GitLab's REST API automatically — no configuration change needed.

Setting Up GitLab

Open GitLab under Integrations

Go to Settings → Integrations and open the GitLab card.

Set Up Actions

Click Set Up Actions and authorize Fabric AI in the GitLab popup (OAuth). Tokens are stored encrypted and refreshed automatically.

Confirm

The provider shows Connected with its available runtime actions.

Available Actions

ActionTypeDescription
Search GitLab IssuesKnowledgeSearch issues in a GitLab project
Create GitLab IssueActionCreate a new issue in a GitLab project

In AI Chat

"Find open issues labeled 'bug' in the web project"

"Create a GitLab issue for the failing pipeline we discussed"

Disconnecting & Reconnecting

To revoke access or switch accounts:

  1. Open Settings → Integrations → GitLab
  2. Click Disconnect
  3. To reconnect, click Set Up Actions again and re-authorize

If a stored GitLab credential stops working (the refresh token expired or was revoked), the provider shows a Reconnect required notice — click Reconnect to restore runtime actions.

Troubleshooting

"Reconnect required"

  • The OAuth token expired or was revoked. Click Reconnect on the GitLab card under Settings → Integrations.

An action returns no results

  • Confirm the connection shows Connected
  • Make sure the authorized account has access to the target project

Use as a project management tool

You can link a project to GitLab and sync its backlog two ways — pushing features as issues and pulling issues back in. In the project's Settings → Execution → Project Management Integration, pick GitLab, choose the GitLab project, and map GitLab labels to statuses so pulled issues land in the right column.

GitLab is a flat issues model — there's no epic/feature/story hierarchy, so nested items flatten to issues on push. PM sync works on the Free tier (REST) as well as Premium/Ultimate (MCP). See Project Management Sync for the full push/pull and conflict-resolution flow.


Next Steps