# Add and manage custom connectors on the phone

Add a custom connector in the Bluedeer app, choose how it signs in, test it, turn its tools on or off, edit it, disconnect it or remove it.

A custom connector lets the assistant use another service's tools, such as Linear or Notion, while it answers you. In the app you add, change and remove your own connectors in **Customization**, on the **Connectors** tab. The same rules apply as on the web. Read [Who can add connectors and which plan you need](https://support.bluedeer.ai/connectors/overview/who-can-add-connectors.md) first if you are not sure you can add one.

## Before you start

- Connectors are included on paid plans by default; your plan page shows what your plan includes.
- In a shared workspace, you need a seat in that workspace. The owner and admins decide which connectors the workspace allows, in **Manage workspace**, under **General**, in the **Connectors** section. Connectors the workspace allows are listed for you under **Allowed in this workspace**, in **Customization**, on the **Connectors** tab, each with **Connect**. Only the owner and admins can change what is allowed. To add a connector by its address, see the approval steps below. Full details: [Choose which connectors a workspace allows](https://support.bluedeer.ai/team-and-enterprise/admin-management/workspace-connectors.md).
- Only you can use the connectors you add. Each person adds and connects their own. You can add a limited number of connectors in each workspace.

## Open your connectors

1. On Home, tap the button at the top right. It opens the account menu.
2. Tap **Customization**, then tap the **Connectors** tab. (The page opens on **Skills**.) Your connectors are listed under **Your connectors**. Tap one to open it.

The same tab also has a search box, **Search apps and connectors**, a **Built-in apps** section with **Connect** and **Disconnect**, and a **Popular connectors** section. See [Where to find your connectors](https://support.bluedeer.ai/connectors/overview/find-your-connectors.md).

## Add a connector

1. Under **Your connectors**, tap **Add connector**.
2. In **Name**, enter a name for the connector, such as Linear. It can be up to 60 characters.
3. In **MCP server URL**, enter the address of the service's connector. It must start with https, such as `https://mcp.example.com/mcp`.
4. In the **Sign-in** section, choose the sign-in type under **How Bluedeer signs in to it**. The three options are described below.
5. Tap **Connect**. While it works, the button says **Connecting…**. With **No sign-in** or **API token**, Bluedeer contacts the service, reads its tools and saves the connector. With **Sign in with the provider (OAuth)**, Bluedeer saves the connector turned off, and then asks you to connect your account.

**Connect** stays gray until the name and the address are filled in, and, for **API token**, until the header or field name and the token are filled in. If the connector can't be saved, nothing is saved, and the reason appears above the button, so you can correct the details and tap **Connect** again.

If the workspace doesn't allow the address you entered, the app asks **Send for approval?** instead. Tap it to send a request to the owner and admins. Your sign-in details are not sent with it. The connector shows as **Waiting for approval** until they answer, and you get a notice with their answer. If they accept, the address is allowed and the connector is connected for you, when the service needs no sign-in. If they decline, the notice shows their reason, and you can ask again.

### The sign-in types

- **No sign-in.** Use this when the service needs no credentials. There is nothing else to fill in.
- **API token.** Under **Send the token in**, choose **A request header** (the usual choice) or **The request body**. Then fill in:
  - **Header name**, or **Field name** if you chose the request body.
  - **Text before the token (optional)**, such as `Bearer ` (with a space at the end). Leave it empty if the service doesn't expect any text before the token.
  - **Token**. The token is hidden as you type.

  When you switch where the token goes, the app fills in the usual header or field name for that place, and the text before the token, as long as the name is still the standard one. A name you typed is kept. You can change any of them.

- **Sign in with the provider (OAuth).** After you save, you connect your own account at the service. Only you can use the connector through your sign-in. If you have your own OAuth app for this service, tap **Advanced: use your own OAuth client**, copy the **Redirect URI** into your app at the service, then fill in **Client ID**, **Client secret** and **Scopes, separated by spaces**. Tap **Hide advanced** to close these fields. If you don't have one, leave them empty.

### After you save

- **With no sign-in or an API token,** the page titled **Connector** shows **CONNECTED** and lists the connector's tools, all turned on. Tap **Done**.
- **With sign-in at the provider,** the page shows **ONE MORE STEP** and "Connect your [name] account." Tap **Connect your account**. The service's sign-in opens in your browser. Sign in with your own account, then come back to the app. The page updates when you return and says "Signed in. The connector is ready." If you want to finish later, tap **Later**. The connector stays turned off until you connect your account.

The tools of a connector that needs sign-in are listed after you connect your account.

If you connect the account somewhere else, such as on the web, a sign-in card for that connector in a chat reads "... is connected" with **Continue conversation**. Tap it to carry on with the chat.

## Check and change a connector

Tap a connector under **Your connectors** to open it. The **Status** section shows one of these:

- **Connected as you.** The connector works with your own account.
- **Off.** You turned the connector off.
- **Not allowed here.** The workspace doesn't allow this connector, so the assistant can't use its tools. This is rare: when the owner or an admin stops a connector, or removes it from the workspace's custom connectors, everyone is signed out of it and it leaves your list, and you get a notice.
- **Not connected.** Your account at the service isn't connected yet, or the sign-in has expired. Tap **Connect your account**.
- **Can't connect.** Bluedeer could not reach the connector or read its tools. The last error is shown in red under the status.

The line beside the status shows how many tools are on, such as "3 of 5 tools on", or "No tools".

## How the assistant is offered your connectors

The assistant is offered each of your connectors as one app, the same way it is offered a built-in app, on the phone and on the web. What counts is the number of connectors, not the number of tools in them, and no connector is refused or left out because it has many tools. On the **Connectors** tab, a line shows how many of your connectors the assistant is offered in the workspace. A project that lists its own connectors counts only those. Many connectors make the assistant less accurate at choosing the right one: once you have a lot of them, a note says so when you open your connectors and when you add one. Turn off the connectors you don't use, or give a project its own list of connectors in its settings. If you reach the most connectors you can add in a workspace, the screen says so and you can remove one to add another.

Every tool you turn on stays usable. When a connector has many tools, the assistant sees the ones you use most by name and finds the others when a request needs them, and the connector's **Tools** section says so. Turn off the tools you don't use to choose which ones the assistant sees by name.

In rare cases a connector shows **Not offered**: this happens only when the most connectors you can have in a workspace was lowered below the number you already have. It stays connected, and its page says why. Remove or turn off another connector to bring it back. See [Manage a custom connector's tools](https://support.bluedeer.ai/connectors/custom/manage-custom-connector-tools.md).

Under **Manage** you'll find:

- **Turned on.** Switch it off to stop the assistant from using this connector's tools. The switch is grayed out until your account is connected.
- **Test connection.** Checks that Bluedeer can reach the connector. A working connector shows "Connection works" with the number of tools. If it fails, the reason is shown.
- **Refresh tools.** Reads the tool list again. The result says "Tools are up to date.", or how many tools were added and how many were removed. New tools are turned on and follow your rules.
- **Edit.** Opens **Edit connector**, where you can change the name, the address and the sign-in. Tap **Save** when you are done. Leave the token field empty to keep the saved token. It shows "Saved. Leave empty to keep it."
- **Disconnect.** Only shown for a connector that signs in at the provider, once your account is connected. It removes your sign-in at the service. The connector and its tool settings stay, so you can connect again later.
- **Remove connector.** Asks "Remove [name]?" first. Tap **Remove connector** to confirm, or **Cancel** to keep it. Removing it also removes your sign-in. The assistant stops using its tools straight away, in your chats and scheduled tasks in this workspace.

## Choose which tools the assistant can use

The **Tools** section lists every tool the connector offers, with a short description.

- Use the **On** switch next to a tool to turn it on or off. A tool that is off is never offered to the assistant.
- Tap **Turn all on** or **Turn all off** to change every tool at once.
- Next to each tool that is on, the app shows **Ask first** or **Don't ask**. Tap it, or **Change**, to open **Settings** where you set the rule. A tool that only reads starts at **Don't ask**. The other tools start at **Ask first**. The same rules are in **Settings**, under **Connector permissions**. Read [What are action confirmations and approval cards?](https://support.bluedeer.ai/account-and-security/action-confirmations-and-approvals.md) for more.
- Tap **Ask first settings** to go to those rules.

If the connector doesn't list any tools, tap **Refresh tools**. If the list is still empty, the service may not offer any tools.

If live pages are allowed to use this connector's tools without asking, they are listed under **Pages allowed to use it**. Tap **Remove** next to a page to revoke its permission. It will ask again the next time you open that page.

## If you can't add or connect

- **There is no Add connector button.** Check that your plan includes connectors. In a shared workspace, you need a seat in that workspace before you can add one. The button is also hidden once you have reached the connector limit for the workspace. Remove one to add another.
- **Connect stays gray.** Fill in the name and the address. For an API token, fill in the header or field name and the token too.
- **The connector can't be reached, or the sign-in doesn't finish.** Read [Why won't my connector connect or sign in?](https://support.bluedeer.ai/connectors/custom/troubleshoot-connectors.md).

For help that is not in the app, write to support@bluedeer.ai.
