> For the complete documentation index, see [llms.txt](https://docs.patchmypc.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.patchmypc.com/patch-my-pc-cloud/manage/settings/connections/add-connection.md).

# Add a Connection in Patch My PC Cloud

*Applies to: Patch My PC Cloud and Publisher*

From the **Connections** page of the Patch My PC (PMPC) Cloud Portal, you can add the following connections:

* [Connection to Intune](#add-an-intune-connection)
* [Connection to Publisher](#add-a-publisher-connection)

## Add an Intune Connection

To add an Intune connection:

1. Navigate to **Settings | Connections**

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FHwiCfMmetCJsNNL55sOo%2Fimage.png?alt=media&amp;token=e694702a-31ca-46c8-aac5-867e16163f6f" alt="Navigating to &#x27;Settings | Connections&#x27;" width="563"><figcaption></figcaption></figure>

The **Connections** page is displayed showing any existing connections

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FIzPkZffDSU4ccSYVl8FW%2Fimage.png?alt=media&amp;token=68117f96-ba63-4eaf-be98-77ef957ffab8" alt="&#x27;Connections&#x27; page showing any existing connections" width="563"><figcaption></figcaption></figure>

2. Click **Connect Intune**

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FYTGOiDi4pKXROoCmIMF1%2Fimage.png?alt=media&amp;token=8508efa2-2763-451b-bfde-be7d567b104a" alt="Clicking &#x27;Connect Intune&#x27;" width="563"><figcaption></figcaption></figure>

3. Enter the Entra ID you used to onboard to PMPC Cloud or click to select the relevant account from the list of already signed-in accounts. Then click **Next**.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FdOqC9Jz4IoOvgnD08wD9%2Fimage.png?alt=media&amp;token=392a81fb-f26f-48f7-be19-f2dd8a769f3e" alt="&#x27;Sign in&#x27; prompt" width="329"><figcaption></figcaption></figure>

4. Enter the password and click **Sign in**.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FGPAV16qRhNOIrzQWxRD6%2Fimage.png?alt=media&amp;token=e16a59fa-c1e2-4889-8865-16af3f575c9e" alt="Entering the password" width="329"><figcaption></figcaption></figure>

5. On the **Permissions requested** screen, click **Accept**.

{% hint style="info" %}
**Note**

To connect with Intune, the signed-in user must have the **Cloud Application Administrator** or the **Application Administrator** role to allow creation of the Enterprise app, and the **Privileged Role Administrator** role to approve the Graph API permissions we require. A **Global Administrator** can also perform both steps.

See [Permissions required for the Intune Apps](https://docs.patchmypc.com/patch-my-pc-cloud/cloud-reference/cloud-permissions-reference/permissions-required-for-intune-apps) for more details.
{% endhint %}

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2F15oFnIRwK7zzBf6puIih%2Fimage.png?alt=media&amp;token=94f185fe-e688-4484-955b-ec0e5d38a2eb" alt="Clicking &#x27;Accept&#x27; on the &#x27;Permissions requested&#x27; screen" width="330"><figcaption></figcaption></figure>

{% hint style="success" %}
**Tip**

You can click the down arrow beside each permission to get more information.
{% endhint %}

The **Connections** page is redisplayed, showing the newly added Intune connection.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FkfxceVVtO9qNqZYHqxxw%2Fimage.png?alt=media&amp;token=71b675a4-e1c9-4cd2-979c-0f8200c85e08" alt="New Intune connection" width="563"><figcaption></figcaption></figure>

## Add a Publisher Connection

Adding a connection between our on-premises Publisher and PMPC Cloud is done from Publisher.

If you click **Connect Publisher** on the **Connections** page of the Cloud Portal, you will see the **Publisher connection** screen, which outlines the process explained in detail below.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FiOzXkLEehjVSeE8p6H5b%2Fimage.png?alt=media&amp;token=1ca65fd4-4061-4d16-9306-6b4bdb49c9a0" alt="&#x27;Publisher connection&#x27; screen" width="291"><figcaption></figcaption></figure>

To connect our on-premises Publisher to PMPC Cloud, you need to:

1. Load the **Patch My PC Publishing Service** (Publisher) and verify you are running at least version 2.1.20.0. If you are not, upgrade to the latest version.
2. Click the **Cloud** tab.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2F8hwtI93hEt0O2I08A1ZV%2Fimage.png?alt=media&amp;token=e2cb654f-edf3-40b7-b693-59a4e79efc11" alt="Clicking the &#x27;Cloud&#x27; tab" width="563"><figcaption></figcaption></figure>

3. On the **Cloud** tab, check the **Enable cloud connection** checkbox.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FF38RhBzRhRULt8wNpcOZ%2Fimage.png?alt=media&amp;token=adf05f37-0db0-4381-8463-8ef321d21b7d" alt="Checking the &#x27;Enable cloud connection&#x27; checkbox" width="563"><figcaption></figcaption></figure>

4. In the **Connection Name** field, enter a unique name for the connection. For example, **Patch My PC Publisher Intune Connector**, then click **Connect**.

{% hint style="info" %}
**Note**

The name you enter here determines how this connection shows on the **Connections** page of the Cloud Portal.
{% endhint %}

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FhQkswm0o5UkBcZm377HT%2Fimage.png?alt=media&amp;token=95b6b6e5-49ef-4228-bb29-fe798c280e8b" alt="Entering a &#x27;Connection name&#x27; and clicking &#x27;Connect&#x27;" width="563"><figcaption></figcaption></figure>

4. In your browser, enter the Entra ID you used to onboard to PMPC Cloud or click to select the relevant account from the list of already signed-in accounts. Then click **Next**.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FmvYKWKKWBYxIKPEJeo49%2Fimage.png?alt=media&amp;token=67101864-bf1a-4265-9ebe-eb63b5e226c9" alt="&#x27;Microsoft Sign in&#x27; screen" width="329"><figcaption></figcaption></figure>

5. Enter the password and click **Sign in**.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2Freq9xpiNLOUwGRHSDb73%2Fimage.png?alt=media&amp;token=dab608ce-c23d-47e1-82c5-c2889d2c6a83" alt="&#x27;Enter password&#x27; screen" width="329"><figcaption></figcaption></figure>

If the connection is successful, a new browser tab opens with the following message:

**Authentication complete. You can return to the application. Feel free to close this browser tab.**

You can close this tab at this point.

6. If the **Select a customer for cloud connection** screen is not displayed, proceed to Step 8.
7. If the **Select a customer for cloud connection** screen is displayed, click to select the customer you want to connect to, then click **OK**.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FjKLcz46WFxnn5K1b974N%2Fimage.png?alt=media&amp;token=b563ee99-4d24-42a6-956a-24322215bab0" alt="&#x27;Select a customer for cloud connection&#x27; dialog" width="375"><figcaption></figcaption></figure>

8. In Publisher, verify the **Connection Status** shows as **Connected**

{% hint style="info" %}
**Note**

You don't need to click **Apply** or **Save and Close** in Publisher at this point, as the connection process automatically saves the details in Publisher.
{% endhint %}

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2F2aiN1FzVlcJEL5kpciID%2Fimage.png?alt=media&amp;token=bfee2d77-0f5f-4b2a-a7de-b0622e959cd9" alt="Verifying the &#x27;Connection Status&#x27; shows as &#x27;Connected&#x27;" width="563"><figcaption></figcaption></figure>

The new Publisher connection will be shown on the **Connections** page of the Cloud Portal.

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2Faq6LC0hFUF1aX9RqR5PE%2Fimage.png?alt=media&amp;token=b930d16b-e18e-4c30-9865-e55e03d35d4a" alt="New Publisher connection" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
**Note**

You can also use the [View Connections](/patch-my-pc-cloud/manage/settings/connections/view-connections.md) process to verify that your Publisher is connected to the portal.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.patchmypc.com/patch-my-pc-cloud/manage/settings/connections/add-connection.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
