Skip to content
Browse the docs

Connectors

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

Updated 1 min readView as MarkdownOpen in Nested

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.

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.