> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blackmountain.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Connections

> Connect, reconnect and check the status of an integration

> [!NOTE]
>
> Requires the **Integrations (MCP)** feature to be enabled for your organization. Ask your administrator if you can't see it.

A connection links your own account in a service to 48°. Assistants can only use an integration for you after you connect it. Manage your connections on the **Connections** tab of the **Integrations** page.

## The Connections tab

Integrations are grouped by status:

| Group | What's in it |
| - | - |
| **Needs attention** | Connections that stopped working and need a reconnect. |
| **Connected** | Integrations you have connected and can use. |
| **Available** | Integrations enabled for your organization that you haven't connected yet. Google Workspace and Microsoft 365 appear in their own **Featured** boxes at the top. |
| **Unavailable in this organization** | Connections you still have stored for an integration that is no longer offered here. You can only disconnect them. |

Use **Filter by name...** to search by name or description.

## Connect an integration

1. Open **Integrations** → **Connections**.
2. Click **+** on the integration, or click the card.
3. Read the connect window. It shows that the integration was **Approved by your admin**, what connecting means and how your access is stored.
4. Finish the connection:
   * **Sign-in integrations**: click **Continue to \{name}**, sign in on the service's own page and grant access. You return to 48° and see **Connection established**.
   * **API key integrations**: paste your key and save. The connect window links to **Where do I find my key?** when the catalog has a guide.
5. The integration moves to **Connected**.

Some integrations need no connection at all. They show **No connection required** and work as soon as your organization enables them.

### When an admin needs to finish setup

Some integrations need an app registered for your organization before anyone can connect. They show **Setup required** or **Waiting for admin setup**.

* **Members**: click **Copy link for your admin** and send the link to an Owner or Manager.
* **Owners and Managers**: the connect window shows a short checklist: copy the **Redirect URL**, create an app in the service, then click **Open setup** to enter its client ID and secret. After that, every member can connect with one click.

## Integration details

Click a connected integration to open its detail page. It shows:

* **What this can do**: the actions the integration offers.
* **Details**: **Status**, **Sign-in** method, **Provided by** (**Integration catalog** or **Your organization**) and a **Setup guide**, if one exists.

## Manage a connection

Open the **…** menu on a connected card, or use the buttons on the detail page:

| Action | When to use it |
| - | - |
| **Reconnect** | Sign in again, for example after your session expired. |
| **Update key** | Replace a stored API key. The old key is never shown. |
| **Refresh tools** | Reload the list of actions after the service added or changed tools. |
| **Disconnect** | Remove your stored sign-in. You confirm first. |

When you disconnect, assistants and toolsets stop using the integration for you until you connect again. Nothing changes for other members.

## Connection status

| Status | Meaning | What to do |
| - | - | - |
| **Connected** | Your connection works. | Nothing. |
| **Not connected** | You haven't connected yet. | Click **+**. |
| **Expired** | Your session ran out. The card says "Session expired — reconnect". | Click **Reconnect**. |
| **Error** | The connection stopped working. | Click **Reconnect**. If it keeps failing, disconnect and connect again. |
| **Revoked** | Access was withdrawn, for example in the service itself. | Click **Reconnect**. |
| **Inactive** | The service reports the connection as not usable. | Click **Reconnect**. |

If the card says "The organization changed its OAuth app — reconnect", an admin changed the app your organization uses for this service. Reconnect once to continue.

## Connections and organizations

Connections belong to one organization. If you switch to another organization, you see that organization's integrations and connect there separately.

If you used integrations before connections became per organization, you may see **Connections from before organizations** at the top of the tab. Assign each one to an organization with **Assign**, or delete it with **Remove**. Until then, they aren't used anywhere.

## Related

> [card] [Integration directory](https://docs.blackmountain.io/integrations/directory.md)
>
> See what you can connect.

> [card] [Tools and toolsets](https://docs.blackmountain.io/assistants/tools-and-toolsets.md)
>
> Bundle connected integrations for an assistant.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.