Connect an integration

How Cyborg7 integrations work — capability vs identity, personal vs shared connections — and where to connect each one.

Integrations let a cybo act in your other tools — read a Gmail thread, post to a Slack channel, move a Jira ticket. Cyborg7 brokers them through Composio, so connecting an account is the same short flow everywhere: pick the toolkit, authorize it, and (optionally) grant a cybo the right to use it.

Two things to understand first

Cyborg7 keeps capability and identity separate:

  • Capability — which toolkits and actions a cybo is allowed to use. This lives on the cybo and is set by a workspace admin. It carries no credentials.
  • Identity — whose account a run acts as:
    • Personal (caller) — the run uses your own connected account. This is the default and the safe choice for personal inboxes/chats.
    • Shared (service) — the run uses a workspace-owned account. Admin-only, and required for unattended runs (scheduled jobs, webhooks) where there is no human to act as.

So "connecting Gmail" can mean connecting your Gmail (personal) or a shared workspace mailbox (service) — the steps are the same, only who owns the connection differs.

Where to connect

  1. Open Settings → Integrations.
  2. Find the toolkit (Gmail, Slack, Jira, …) and choose Connect.
  3. Pick Personal (your account) or, if you're an admin, Shared workspace account.
  4. Complete the provider's OAuth screen in the popup and approve the requested scopes.
  5. Back in Cyborg7 the toolkit shows Connected.

Let a cybo use it

A connection alone doesn't give a cybo access. An admin still grants the toolkit (and specific actions + an approval policy) to the cybo under its settings. A cybo can only ever use toolkits it has been granted, acting as the identity bound for that run.

Per-integration guides