Skip to main content
A connector lets your agents work with your access in a service your team already uses, such as Jira or Google Drive. It brings together the following:
  • The service: The tool where the work happens. An agent can open only what your account there can.
  • Your connection: You connect the service to Switch once, signed in as yourself. See Connect a service.
  • Each agent’s access: You turn the connector on for each agent that needs it. That agent then acts as you in the service, with everything your connection allows, except where the connector lets you limit it. On GitHub, it acts as the GitHub App instead, within the repositories you choose. See Turn a connector on for an agent.
Anyone who can talk to an agent can ask it to use the service with your access, so check who can talk to your agent before you turn a connector on.

​
Choose a connector

Agent access lasts is how long an agent can keep using the access it was handed after you turn the connector off for it. For GitHub, Switch revokes that access when you turn it off, so it normally ends at once rather than running out the hour. Each connector’s page says what disconnecting does for that service.

​
Connect a service

1

Open the connector

In the Switch Console sidebar, select Connectors, then the Discover tab. Select the connector’s card.
2

Connect it

Select Connect to Switch. For Atlassian, GitHub, or Google Workspace, your browser opens so you can sign in at the service and allow what Switch asks for. For Datadog, enter your keys in Switch Console.
3

Come back to Switch Console

When your browser says you’re connected, close the tab. The connector moves to the Yours tab, and its page shows the account you connected as.

​
Turn a connector on for an agent

An agent uses a connector only once you turn it on for that agent. You can do it from either side:
  • From the connector: On the connector’s page, under Agents, select Add agent, then select Add beside the agent.
  • From the agent: On the agent’s page, select the plug icon to open its Connectors, select the connector, and turn it on.
A connector reaches the agent at its next session. Start a new session before you test: open the running session from the Switch Console sidebar, select Stop, then address the agent. Turning a connector off doesn’t need a new session. An agent’s row can say Others can address it; it would act as you. That means someone other than you and your own agents can talk to that agent. Turn the connector on only if they should be able to use your access through it.

​
Check whether an agent asks for approval

An agent’s agent provider and its Auto mode setting determine whether it asks for approval before using a connector. To find the setting, see Let the agent act without asking. Bypass permissions overrides Auto mode: when it’s on, the agent uses connectors without asking. When an agent asks for approval, approve or decline its request in the room. See Approve or decline a request. These rules apply to connectors you turn on in Switch Console. MCP servers you configure directly in the provider use that provider’s own permission checks.

​
Cut off access

​
Troubleshooting

​
Next steps

Work in a room

Give a connected agent work in a room

Agent settings

Change what your agent can use and who it answers