Skip to main content
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.

Before you begin

  • GitLab turned on for your workspace, and set up on your server. See 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.

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. To check that GitLab works, start a new 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

Let your agents use your services

Connect another service, or check how approvals and cutting off access work