Skip to content

Manage connections

See every account available to you, keep them healthy, and change ownership without re-authorizing.

Where to find it: Connections in the sidebar

A connection is one authorized account for a product. Credentials stay in the vault; this page is where you manage ownership, status, and lifecycle.

What the list shows

Column What you’ll see
Connector Product name (and your connection name when set)
Scope Personal, a team name, or Organization
Status Active, Pending, Needs re-auth, or disconnected
Created by Who created the connection
Created When it was added

Toolbar actions: Refresh connections and Add connection (if you have connection:create or connection:create_shared).

You see your own connections, team connections for teams you belong to, and organization connections. With connection:manage you see every connection in the organization.

Row actions

Open the ⋮ menu on a row you can manage (you own it, or you have connection:manage):

Action When it’s available What it does
Reconnect Always in the menu when you can manage the row; also inline when status is Needs re-auth Re-runs the authorization window and rebinds the same connection
Transfer Only for Personal (user) connections you can manage Moves ownership to the organization, a team, or another member — credentials stay put
Delete When you can manage the row Removes the connection and its vault account

There is no separate “tools” action on the row. To browse what the product exposes:

  1. Open Connectors, find the same product, and open its detail page → Tools, or
  2. Open Toolboxes → My toolboxes and open the automatic Connection toolbox for that account.

Transfer ownership

Use Transfer when a personal connection should become shared infrastructure (or move to a colleague) without signing in again.

  1. Choose Transfer on a personal connection.
  2. Pick Transfer to:
    • Entire organization — everyone in the org can use it
    • A team — pick the team
    • Another member — pick the person (not the current owner)
  3. Confirm Transfer.

Toolboxes that already use the connection keep working. For the full offboarding path when removing a member, see Transfer and offboard.

Delete implications

Deleting is permanent. The confirm dialog warns that deleting the connection immediately breaks toolboxes and MCP servers that use it.

What goes away with the connection:

  • The vault account for that product
  • Bindings that pointed toolboxes at this connection
  • MCP servers on the automatic per-connection toolbox (their tokens are revoked)

Prefer Transfer (or resolving connections during member removal) when someone leaves and shared toolboxes still need the account.

Warning

Delete only after you’ve checked what’s using the connection. Prefer transfer for personal accounts that shared toolboxes depend on.

Keep connections healthy

  1. Open Connections and scan Status.
  2. Reconnect anything marked Needs re-auth.
  3. Transfer personal connections that should outlive one person.
  4. Delete only unused or replaced connections.

You'll know it worked when: Connections you rely on show Active, with the right scope badge.

If something goes wrong

  • Connection stays unhealthy after reconnect? Sign in again with the product and approve any new permissions it requests.
  • Can’t create Team or Organization scope? You need connection:create_shared, or ask an admin to create the shared connection.
  • Can’t see a teammate’s personal connection? Personal connections aren’t org-wide until transferred (or you have connection:manage).