Manage connectors
This guide shows you how to turn connectors on and off, sign in to them, and add your own.
A connector lets the assistant use another service, such as a ticket system or a documentation site. Connectors are also called MCP servers.
Open the Connectors dialog
Do one of the following:
-
At the bottom of the sidebar, select Settings (the gear icon), then Connectors.
-
Under the message box, select Add context (+), then Connectors / MCP Servers.
A new workspace includes the Atlassian and Microsoft Learn connectors, plus GitHub, Obsidian, and the connector for your past chats. Your administrator may provide more.
The Connectors dialog lists every connector in your workspace, grouped into On · working, Needs your attention, and Off. To narrow the list, select a filter on the left, or type in Search connectors.
Turn a connector on or off
Select the switch on the connector's row. Once it's on, the assistant can use it in your chats.
Turn on only the connectors you need. Each one makes every message larger, so the assistant uses more tokens.
Some connectors need something from you before they work. Their status tells you what:
-
Sign-in needed: sign in with your account for that service.
-
Key needed: add your personal API key.
-
Needs setup: the connector needs an address or a token first.
Sign in to a connector
-
On the connector's row, select Sign in.The Sign in to dialog shows three steps.
-
Select Open sign-in page ↗. The service's sign-in page opens in a new tab.
-
Sign in with the account that has access to the service, and choose Allow.
-
Your browser lands on a page that won't load. This is expected. Copy the whole address from the browser's address bar.
-
Back in Knowledge Worker Agent, paste the address into the box, and select Finish.
When the dialog shows "Signed in to" followed by the connector's name, select Done. The dialog waits for you for 10 minutes.
To sign out later, select Sign out on the connector's row.
Add your API key
-
On the connector's row, select Add key.
-
Paste your key into Paste your key. To check what you pasted, select Show.
-
Select Save key.
Knowledge Worker Agent checks the connection. When it works, you see that the connector is connected. Your key is stored in your workspace, readable only by you, and never shown again.
If the row shows Where do I get my key? ↗, that link explains where to find the key. To change the key later, select Replace key. To delete it, select Remove key.
Set up a connector
A connector that shows Needs setup has instructions on its row.
-
Read the instructions. If there's a How to set this up ↗ link, follow it.
-
Select Set up, and change what the instructions ask for.
-
Select Check address (or Test command), then Save changes.
Add your own connector
-
In the Connectors dialog, select Add connector. You can also select Custom server URL… on the left.
-
Under How it connects, choose one of the following:
-
Over the web: enter the Server address, which starts with
https://. -
On this computer: enter the Command to run, for example
npx -y @upstash/context7-mcp.
-
-
Optional: expand Advanced settings to give a Display name, Headers, Environment variables, or a longer timeout under Give up after.
-
Select Check address or Test command. Knowledge Worker Agent checks that it works and shows what the connector can do.
-
Select Add and turn on.
Only add commands from a source you trust. A command that runs on this computer runs with your permissions.
Change or remove your own connector
On the connector's row:
-
To change it, select Edit, change what you need, check it again, and select Save changes.
-
To remove it, select Remove.
Connectors provided by IT
A connector marked Provided by IT comes from your organization. You choose whether it's on. Its address and settings are managed centrally, so you can't edit or remove it.
When your organization makes a connector or model provider available that you haven't set up, New in your workspace opens the next time Knowledge Worker Agent starts. It lists each one with what it's for:
-
Open connectors or Set up a model takes you to where you set it up, and back.
-
Close marks the list as seen, so it isn't shown again.
-
Remind me later shows it again when Knowledge Worker Agent next starts.
Connectors and model providers you already use aren't listed.
Choose connectors for one chat
The Connectors dialog sets what's available in your workspace. To choose which connectors a single chat uses, use the Toolbox. For more information, see Use skills and connectors in a chat.