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 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.
- 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
- On Home, tap the button at the top right. It opens the account menu.
- 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.
Add a connector
- Under Your connectors, tap Add connector.
- In Name, enter a name for the connector, such as Linear. It can be up to 60 characters.
- In MCP server URL, enter the address of the service's connector. It must start with https, such as
https://mcp.example.com/mcp. - In the Sign-in section, choose the sign-in type under How Bluedeer signs in to it. The three options are described below.
- 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.
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? 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?.
For help that is not in the app, write to [email protected].