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

# Setup a connector

> [!NOTE]
>
> Only owners can set up new connectors. If you're a member and need a connector that isn't available, ask an owner to add it.

An owner adds each connector once for the workspace. Members then [connect their own accounts](https://docs.sourcebot.dev/docs/features/connectors/connect-your-account.md). When an agent uses the connector, it acts with the member's own credentials, so it can only access what that member can. Sourcebot stores these credentials encrypted.

## Add a connector

1. Go to **Settings → Workspace → Connectors** and click **Add connector**.
2. Pick a [supported connector](https://docs.sourcebot.dev/docs/features/connectors/overview#supported-connectors), or add a [custom connector](#custom-connectors).
3. If the connector needs a pre-registered OAuth app, enter its client credentials. See [Connectors that need an OAuth app](#connectors-that-need-an-oauth-app).
4. Review the connector's settings, then click **Add**.

![Add a connector dialog listing supported connectors](https://mintcdn.com/sourcebot/4jRqIKFzMtH-0zb0/images/connectors_add_picker.png?fit=max\&auto=format\&n=4jRqIKFzMtH-0zb0\&q=85\&s=85ae3cfaea5ce3971f565c71d0ea97ee)

## Custom connectors

A custom connector lets you connect any remote MCP server, not just the [supported connectors](https://docs.sourcebot.dev/docs/features/connectors/overview#supported-connectors). Use one for an internal MCP server your team runs, or for a third-party server that Sourcebot doesn't include yet. Members connect to it and use its tools the same way as any other connector.

To add one, click **Custom connector** in the **Add connector** dialog and enter:

* **Name**: the name members see. It needs at least 3 letters or numbers and must differ from your other connectors' names.
* **Connector URL**: the server's HTTPS URL, for example `https://mcp.example.com/mcp`.

![Add a custom connector dialog with the name and connector URL filled in](https://mintcdn.com/sourcebot/4jRqIKFzMtH-0zb0/images/connectors_add_custom.png?fit=max\&auto=format\&n=4jRqIKFzMtH-0zb0\&q=85\&s=479ba2cdc3e3a63fda4d820e3e07cecf)

The server must:

* Use the MCP [Streamable HTTP](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports#streamable-http) transport.
* Support OAuth, since each member signs in with their own account. If it doesn't support dynamic client registration, you also need an [OAuth app](#connectors-that-need-an-oauth-app).

You can add each URL once.

## Connectors that need an OAuth app

Most connectors support dynamic client registration, so Sourcebot registers with them automatically. Some, such as Slack, need an OAuth app that you create in the service first:

1. Create an OAuth app in the service. Set its redirect URL to the **Redirect URL** Sourcebot shows.
2. Enter the app's **Client ID** and **Client Secret**, then click **Continue**.

Sourcebot stores the credentials encrypted.

![Client credentials step for Slack, with the redirect URL, client ID, and client secret](https://mintcdn.com/sourcebot/4jRqIKFzMtH-0zb0/images/connectors_static_registration.png?fit=max\&auto=format\&n=4jRqIKFzMtH-0zb0\&q=85\&s=ec57589ab8ba86af750a6a39e8a6645a)

## OAuth scopes

OAuth scopes control what members authorize when they connect. Sourcebot lists the scopes the connector advertises and selects the ones it asks for by default. You can change the selection or add custom scopes.

Most services grant only the scopes you request, so include the scopes the connector's tools need.

To change scopes later, open the connector's menu in **Settings → Workspace → Connectors** and select **Edit OAuth scopes**.

![Connector menu with Edit OAuth scopes highlighted](https://mintcdn.com/sourcebot/4jRqIKFzMtH-0zb0/images/connectors_edit_scopes.png?fit=max\&auto=format\&n=4jRqIKFzMtH-0zb0\&q=85\&s=8d9c4bacee6acb77de7a218629aa2015)

## Next steps

> [card] [Tool permissions](https://docs.sourcebot.dev/docs/features/connectors/tool-permissions.md)
>
> Choose which of the connector's tools agents can use.

> [card] [Connect a connector](https://docs.sourcebot.dev/docs/features/connectors/connect-your-account.md)
>
> Share with members how they connect their own accounts.

> [card] [Ask Sourcebot](https://docs.sourcebot.dev/docs/features/ask/connectors.md)
>
> Use connectors in your chats.

> [card] [MCP clients](https://docs.sourcebot.dev/docs/mcp/gateway.md)
>
> Use connectors from Claude Code, Cursor, and other MCP clients.


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