# Connect Environments

AI Assets requires a connected environment before it can begin discovery.\
Once connected, AI Assets will scan, discover, and populate your AI inventory with **Models, AI Workflows, MCP Servers, Guardrails, and custom tools** found in your infrastructure.

## Add Your First Environment

When no environments are connected, the AI Assets dashboard shows an **empty state**.\
Click **Add Environment** to start configuration.

<figure><img src="https://1029475228-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi12bk7lo75SODuwcRCQp%2Fuploads%2F6gXJcHykp3KCu1HV9vkE%2Fprobe.splx.ai_w_778_ai-assets.png?alt=media&#x26;token=27a5d829-a033-4338-8a88-fbe5bf39f384" alt=""><figcaption><p>Figure 1: Adding Your First Environment</p></figcaption></figure>

### Step 1: Select Environment Type

Choose the type of environment you want to connect.\
Currently supported:

* **GitHub**
* **GitLab**

### Step 2: Configure Connection

Depending on the environment type, provide the required connection details:

#### GitHub

1. Select **GitHub**.
2. Enter:
   * **Environment Name** – a descriptive label for the connection.
   * **Description** – optional details for context.
   * **Installation ID** – generated during the GitHub App installation. To get the ID:
     * In the upper-right corner of GitHub, click your profile picture
     * Click on <picture><source srcset="https://1029475228-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi12bk7lo75SODuwcRCQp%2Fuploads%2F25KL8XyisiOgP2JbcX8p%2Fimage.png?alt=media&#x26;token=be5beb89-7a42-4192-b277-64aefdab8862" media="(prefers-color-scheme: dark)"><img src="https://1029475228-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi12bk7lo75SODuwcRCQp%2Fuploads%2FMu3efJ1BpZlpoEoubJUp%2Fimage.png?alt=media&#x26;token=08ddfc4d-7c6a-4840-a3c5-29f7b83166e2" alt=""></picture> **Organizations**.
     * Go to <picture><source srcset="https://1029475228-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi12bk7lo75SODuwcRCQp%2Fuploads%2F5JaV8bGJJxJgmQceSdjd%2Fimage.png?alt=media&#x26;token=cef29081-c5ef-43fe-a118-e881fc6a18d7" media="(prefers-color-scheme: dark)"><img src="https://1029475228-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi12bk7lo75SODuwcRCQp%2Fuploads%2FGtvCgUoocBsH5UMFWaa5%2Fimage.png?alt=media&#x26;token=83299ae3-76f5-430f-904b-11ffcfc53a5f" alt=""></picture> **Applications** under the **Integrations**.
     * Select your GitHub App and click **Configure**.
     * Copy the `<ID>` part from the URL, which looks like this:

       <https://github.com/organizations/\\><Organization-name>/settings/installations/\<ID>
     * The `<ID>` is your **GitHub App Installation ID**.

For more details on installing the GitHub app visit the relevant [GitHub App installation documentation](https://docs.github.com/en/apps/using-github-apps/installing-a-github-app-from-a-third-party).&#x20;

#### GitLab

1. Select **GitLab**.
2. Enter:
   * **Environment Name** – a descriptive label for the connection.
   * **Description** – optional details for context.
   * **Personal Access Token** – a valid GitLab token with appropriate permissions:
     * read\_api &#x20;
     * read\_repository

For more details visit the [GitLab Personal Access Tokens](https://docs.gitlab.com/user/profile/personal_access_tokens/?utm_source=chatgpt.com).

After filling out the details, click **Create** to complete the setup.

## Manage Environments

Once at least one environment is added, the **Environments page** lists all active connections, including:

* **Environment Name** – the given name of the environment.
* **Environment Type** – currently GitHub or GitLab.
* **No. of Discovered Repositories** – repositories scanned in that environment.
* **Created At** – when the environment was first connected.

From here you can manage existing environments or add new ones using **Add Connector**.

<figure><img src="https://1029475228-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi12bk7lo75SODuwcRCQp%2Fuploads%2FlxtN3ys2P5iZIIH29aLq%2Fprobe.splx.ai_w_31_ai-assets_settings_environments.png?alt=media&#x26;token=e6dedd1f-3795-4050-aa97-d4f253960f59" alt=""><figcaption><p>Figure 2: Environments Page</p></figcaption></figure>

## Next Steps

Once your environment is connected, the [scans](https://docs.probe.splx.ai/ai-asset-management/scan-for-ai-assets) can be triggered.
