Docs

Appearance

Scout Connectors ​

Scout Connectors connect external systems to a specific user account, typically via OAuth. This allows Scout to retrieve context within the user’s permission boundary.

Where in Modulos ​

  • User Settings → Connectors (shown when chat/Scout is enabled for your organization)

If you don’t see the Connectors tab, ask your organization admin.

What Connectors are ​

Connectors are:

  • user-scoped: they belong to one user
  • type-scoped: one Connector per user per Connector type
  • OAuth-based: access and refresh tokens are stored for the user

Connectors are designed for interactive, user-scoped access. If a Connector becomes disconnected or expires, re-authorize it.

Supported Connector types ​

Supported Connector types include:

  • GitHub
  • Bitbucket
  • Google Drive
  • Atlassian

Organization controls

Organization admins can enable or disable specific Connector types organization-wide on the Organization → Source Connectors page. If you don't see an expected Connector type, check with your organization admin.

Connect a service ​

  1. Open User Settings → Connectors.
  2. Choose a Connector type and follow the authorization flow.
  3. Confirm the Connector shows as connected.

After a Connector is connected, Scout can use it to search and retrieve context within the permissions of the connected account.

Google Drive: you pick what Scout can see ​

The Google Drive Connector does not grant access to your whole Drive. Connecting it opens the Google Picker, where you choose the specific files and folders Scout may read. The Connector holds Google's drive.file scope, which is limited to exactly the items you picked.

  • To give Scout more material, open the Picker again from the Scout panel's Connector controls and select additional files.
  • Disconnecting the Connector revokes Scout's access to everything you had picked.

Sources vs Connectors ​

Connectors are not Sources:

  • Sources are service accounts attached to projects. They are shared across a project and are used for Runtime Inspection and other project automation.
  • Connectors are user accounts connected to users. They are personal and reflect individual permissions and accountability.

Important considerations ​

  • Use Connectors when Scout needs your user-level access to docs, code, or tickets.
  • Use Sources when you need stable, shared automation that should not depend on a single person’s account.
  • If your access changes in an external system, Scout’s access changes too.