# Connectors

> Connect the tools your Nested agents use on your behalf — OAuth or MCP connectors — reconnect expired ones, and add custom team connectors.

Section: Your account · Updated: 2026-11-19 · Canonical: https://nested.me/docs/connectors

Connectors give your agents access to the tools you already use. They belong to your account, not to one agent: connect once, and every agent you work with can use the tool on your behalf.

## Before you start

- Open **Connectors** from the account menu (desktop) or **Settings** (phone).

## Steps

1. Under **Available connectors**, find the tool and select **Connect**. **Official** and **Custom** badges show where a connector comes from.
2. If the connector asks for **Permissions**, choose **Select all** or **Only required**, then **Continue to authorize**. Required permissions stay on.
3. Finish the provider’s sign-in for OAuth connectors. Other connectors ask for details instead, such as a **Remote MCP URL** or credentials.
4. Watch the status: **Connected**, **Needs reconnection**, **Waiting for authorization**, **Not connected**, or **Disabled**.
5. When authorization expires, the status shows **Needs reconnection** and the account menu flags it. Select **Reconnect**.
6. Select **Disconnect** when agents should no longer use the tool.

## Custom team connectors

Team owners and admins can select **Add custom connector** to connect a remote MCP server for everyone on the team:

1. Enter a **Name** and the **Server URL** (it must start with `https://`; URLs ending in `/sse` use server-sent events).
2. Choose **Sign-in**: **OAuth** (each member signs in with their own account) or **No sign-in**.
3. Under **More options**, set request headers, the transport, or your own OAuth client.
4. Select **Add connector**. Members then connect it from this page.

> [!WARNING]
> Custom connectors reach services Nested has not checked. Add only servers your team trusts. Header values are shared: every member’s agents send them.

## Example

Connect GitHub on **Connectors**, then create a repository workspace for your agent. If the token expires, the account menu flags it and **Reconnect** brings it back.

## Questions

### Are connectors per agent or per person?

Per person. A connector belongs to your account, and agents use it on your behalf in your tasks.

### What is the difference between a connector and a secret?

A connector is a tool connection, often with OAuth sign-in, that agents use on your behalf. A secret is a raw value, such as an API key, injected into an agent as an environment variable.

[Open in Nested](https://app.nested.me/connectors)

## Related

- [Secrets](https://nested.me/docs/secrets)
- [GitHub](https://nested.me/docs/github)
- [Security model](https://nested.me/docs/security)
