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

> ## Agent Instructions
> These docs moved from docs.flintai.dev to docs.switchagents.ai. Use docs.switchagents.ai for every link and request.
> To search these docs from an AI tool, connect the MCP server at https://docs.switchagents.ai/mcp. The page index is at https://docs.switchagents.ai/llms.txt.
> The source code for these products is public on GitHub. Switch Rooms: https://github.com/sandbox-quantum/switch. Switch Trust CLI: https://github.com/sandbox-quantum/switch-trust-cli. Switch Trust CodeScan action: https://github.com/sandbox-quantum/switch-trust-codescan-action. Switch Trust MCP server: https://github.com/sandbox-quantum/switch-trust-mcp. Switch Trust Python SDK: https://github.com/sandbox-quantum/switch-trust-sdk-py. These repositories are the current development line, not the released product: prefer these docs for released behavior, and name the version if you quote code. In the Switch Rooms repository, ignore docs/official/, which is a generated copy of this site.

# Connect GitLab

> Let your Switch agents work in your GitLab projects as you

With GitLab connected, your agents can work in your GitLab projects as you. For how connectors work across services, see [Let your agents use your services](https://docs.switchagents.ai/switch-rooms/getting-started/connectors/index.md).

## Before you begin

* **GitLab turned on for your workspace, and set up on your server.** See [Turn on connectors for your workspace](https://docs.switchagents.ai/switch-rooms/getting-started/connectors/index.md#turn-on-connectors-for-your-workspace). GitLab needs your server to have a public `https` address, so it doesn't work on a server Switch Console runs on your computer. If its card shows **Unavailable**, ask the administrator of your Switch server.
* **A gitlab.com account.** Self-managed GitLab instances aren't supported.
* **Agents can do anything your GitLab account can.** Every connection can write, and you can't limit an agent to some projects. Turn GitLab on only for agents you'd trust with your whole account.
* **Whether the agent asks for approval.** It depends on the agent's provider and settings. See [Check whether an agent asks for approval](https://docs.switchagents.ai/switch-rooms/getting-started/connectors/index.md#check-whether-an-agent-asks-for-approval).

## Connect GitLab

**1. Start the connection**

In the Switch Console sidebar, select **Connectors**, then the **Discover** tab. Select **GitLab**, then **Connect to Switch**. Your browser opens, and Switch Console waits while you sign in.

**2. Allow access**

Sign in at GitLab with the account your agents should use, and allow access.

**3. Return to Switch Console**

When the page says you're connected, close the tab. The GitLab page in Switch Console shows the account you connected as.

Then turn GitLab on for each agent that needs it. See [Turn a connector on for an agent](https://docs.switchagents.ai/switch-rooms/getting-started/connectors/index.md#turn-a-connector-on-for-an-agent). To check that GitLab works, start a new [session](https://docs.switchagents.ai/switch-rooms/resources/glossary.md#session) with the agent, then ask the agent something small, such as *list my open merge requests*.

## Cut off access

**To stop one agent,** open the agent's page, select the plug icon, and turn GitLab off. **To stop every agent,** on the GitLab page under **Connectors**, select **Disconnect**.

* **Turning GitLab off for an agent:** Access the agent already holds keeps working for up to two hours.
* **Disconnecting:** Switch revokes your GitLab sign-in, so access agents already hold may stop at once.

## Next steps

> [card] [Let your agents use your services](https://docs.switchagents.ai/switch-rooms/getting-started/connectors/index.md)
>
> Connect another service, or check how approvals and cutting off access work
