> For the complete documentation index, see [llms.txt](https://www.cakewalk.security/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.cakewalk.security/docs/ai-agent-access/how-to-guides/connections/my-connections.md). # My Connections Set up and manage the apps your Agents access on your behalf. My Connections is where you set up and manage your own Connections: the per-user links your Agents use to access third-party apps through the MCP Gateway. You authorize each one by signing in to the app, and you see only your own Connections. *** ### πŸ“– Key concepts * **Connection**: The link between you and one downstream app. You authorize it by signing in to the app; your Agents then use it to access that app on your behalf. * **Connection status**: Active, Error, Paused, Restricted or Not Connected. See [Connection and Agent Statuses](/docs/ai-agent-access/concepts/connection-and-agent-statuses.md). * **Company catalog**: The Connections your Admins have made available. You add the ones you need from it. Your company may limit the catalog to the Connections allowed for your groups. :bulb: *Why this matters*: Your Agents can act in an app only while you hold an Active Connection to it. Adding, connecting and pausing Connections is how you control what your Agents can access on your behalf. *** ### πŸ“‹ Your Connections list **Navigation**: My Connections in the left nav. Your Connections appear as cards, split across four tabs: * **All Connections**: everything in your list. * **Connected**: Connections you have authenticated. * **Paused**: Connections you have paused, plus any that are Restricted. * **Not Connected**: Connections you have added but not yet connected. Each card shows the app icon and name, a short description, a status chip and the main action for that status. Use the search box to filter by name or description. *** ### πŸ”Œ Connect to an app A card shows **Connect** when the Connection is Not Connected or in Error. 1. On the Connection card, select **Connect**. 2. Cakewalk sends you to the app's sign-in and consent screen in a full-page redirect. 3. Approve the access the app asks for. You return to My Connections and the status becomes **Active**. {% hint style="info" %} Connecting opens the app in a full-page redirect, not a popup. If **Connect** is unavailable, your Admin still needs to finish setting up that Connection. {% endhint %} *** ### βž• Add a Connection Some Connections are already in your list from your company's setup: Admins can add you to Connections, and a Google Workspace import maps the apps it discovers to the people who use them. You can add more yourself, but only from the apps your Admins have made available. If your company runs [Connection access](/docs/ai-agent-access/how-to-guides/connection-access.md) on Curated, the panel lists only the Connections allowed for the groups you belong to. Ask your Admin if an app you need is missing. To add one: 1. Select **New** at the top of the page. 2. In the **Add connection** panel, search the available Connections by name. 3. Select one or more, then select **Confirm**. The Connections join your list as **Not Connected**. Connect each one to start using it. *** ### ⏸️ Pause and resume * **Pause** (on an Active Connection): blocks your Agents from using it. Your credential is kept, so you can resume without signing in again. * **Resume access** (on a Paused Connection): restores Agent access right away. *** ### 🚫 Restricted Connections A Connection shows a **Restricted** chip when your company no longer allows it for any group you belong to. Your Agents cannot use it and you cannot resume it yourself. Hover the chip for the reason. Nothing is lost. Your credential stays saved, and the Connection returns to normal on its own once an Admin allows it for one of your groups again, with no need to sign in a second time. The only action on the card is **View details**. Restricted Connections sit under the **Paused** tab alongside the ones you paused yourself. *** ### β‹― More actions Open the 3-dot menu on any Connection card for: * **View details**: open the Connection's detail panel. * **Disconnect** (Active Connections): drops your credential. The Connection stays in your list as **Not Connected**, ready to reconnect. * **Remove** (Connections that are not Active): takes the Connection off your list. *** ### πŸ”— Related pages * [All Connections](/docs/ai-agent-access/how-to-guides/connections/all-connections.md) (Admin view) * [Connection Access](/docs/ai-agent-access/how-to-guides/connection-access.md): why a Connection can be Restricted * [Agent Connections](/docs/ai-agent-access/connections-and-integrations/agent-connections.md): the full app catalog * [Connection and Agent Statuses](/docs/ai-agent-access/concepts/connection-and-agent-statuses.md) * [Policies](/docs/ai-agent-access/how-to-guides/policies.md) * [The MCP Gateway](/docs/ai-agent-access/concepts/the-mcp-gateway.md) --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://www.cakewalk.security/docs/ai-agent-access/how-to-guides/connections/my-connections.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.