> ## 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.

# GitLab

> Scan a GitLab repository for agents and add them to your inventory

GitLab is a code-repository data source. Switch Trust scans the source code in your repository for AI
agents and reports the models, tools, and MCP servers behind them, along with any security
issues it finds. The scan runs as a GitLab CI/CD component inside your own pipeline, so there
is no credential to store in Switch Trust. You authenticate the component with a Switch Trust API key.

GitLab is a separate data source from GitHub so that results found on each are recorded and
shown apart. Agents discovered on GitLab trace back to their GitLab repository.

To open this page, go to **Settings**, then **Data sources**, select **GitLab**, and open the
**Setup** tab.

## Connect a repository

**1. Get your credentials**

You need two values: your Switch Trust instance URL and a Switch Trust API token.

* **Instance URL.** The **Setup** tab shows the exact URL to use. Copy it from there.
* **API token.** Use an existing token, or create one now if you don't have one. Tokens are
  managed under **Settings**, then **API keys**, and the **Setup** tab has a
  **Create one now** shortcut.

**2. Install the GitLab CI/CD component**

Install [`switch-trust-codescan-workflow`](https://gitlab.com/explore/catalog/sandboxaq/switch-trust-codescan-workflow)
from the GitLab CI/CD Catalog and include it in the `.gitlab-ci.yml` for your project:

```yaml theme={null}
include:
  - component: $CI_SERVER_FQDN/sandboxaq/switch-trust-codescan-workflow/inventory-scan@2.0.1
    inputs:
      switch_trust_instance: https://app.switchagents.ai   # use the URL from your Setup tab
      switch_trust_token: $SWITCH_TRUST_TOKEN
      llm_model: anthropic:claude-opus-4-8
      llm_api_key: $ANTHROPIC_API_KEY   # the variable you create in step 4
```

> [!TIP]
>
> Unlike GitHub Actions, a GitLab CI/CD component cannot read your CI/CD variables by itself.
> Pass `$VARIABLE` references explicitly in your `.gitlab-ci.yml` so GitLab expands them at
> runtime. Only the token needs to be masked. Your instance URL is not sensitive, so pass it
> to the component's `switch_trust_instance` input as a plain value.

**3. Store your token as a GitLab CI/CD variable**

In your project or group settings, go to **Settings**, then **CI/CD**, then **Variables**,
and add a variable named `SWITCH_TRUST_TOKEN` with the token from the first step. Enable the
**Mask variable** toggle to keep it out of job logs.

Scanning more than one repository? Define this variable at the group level so it is shared
across projects.

**4. Enable LLM-based scanning**

The scanner calls an LLM from the pipeline to analyze your code, so this step is required.

* Add your LLM provider's API key as a masked CI/CD variable. Name it for your provider,
  one of `OPENAI_API_KEY`, `GOOGLE_API_KEY`, or `ANTHROPIC_API_KEY`, then reference that same
  variable through the `llm_api_key` input. The example above uses
  `llm_api_key: $ANTHROPIC_API_KEY` to match its `anthropic` model.
* Choose the model with the `llm_model` input, in `provider:model` form.

Supported providers are OpenAI, Google (Gemini), and Anthropic.

Once the pipeline runs and reports its first scan, the **GitLab** card reads **Connected**.

### Restrict to the default branch (optional)

Use the `rules` input to control when the scan runs, for example only on the default branch:

```yaml theme={null}
    rules:
      - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
```

### Target a specific runner (optional)

The component adds a scan job named `switch-trust-inventory-scan`. If a particular runner supports
`docker:dind`, override that job with the appropriate tags:

```yaml theme={null}
switch-trust-inventory-scan:
  tags:
    - dind
```

## The Scans tab

Open the **Scans** tab to see each connected repository with the time of its most recent
scan. A fresh timestamp means results arrived.

> [!WARNING]
>
> Check the **Scans** tab, not the **Connected** status, to confirm results are landing. The
> card status does not yet reflect a live connection check, so it can read **Connected** before
> your first scan has run.

## Next steps

> [card] [Discover your agents](https://docs.switchagents.ai/switch-trust/getting-started/discover.md)
>
> Set up a repository scan end to end, from workflow file to first results

> [card] [Read your discovery results](https://docs.switchagents.ai/switch-trust/discovery/results.md)
>
> Work out what needs attention first, whether a finding is real, and when it's resolved
