---
app: agent
audience:
  - owner
since: 0.1.6
ui_only: true
agent_actions: []
agent_examples:
  - connect Canva to the designer
  - give the developer a GitHub token
llm_weight: normal
title: Connected tools
description: Canva, Figma, Notion and GitHub for the roles that need them —
  signed in once per agent, on your computer.
editUrl: true
head: []
template: doc
sidebar:
  order: 3
  hidden: false
  attrs: {}
pagefind: true
draft: false
---

import { Steps, Aside } from "@astrojs/starlight/components";
import { AgentAsk, UiOnly } from "@components";

**Who this is for:** an owner with a Design Studio or Engineering room.

Some roles work with outside tools: the designers with **Canva** and **Figma**, the Data Analyst with **Notion**, the engineering roles with **GitHub**. The **Model** tab of such an agent shows a **Connected tools** card (and, for engineering roles, a **GitHub** card).

<UiOnly />

## Steps — Canva, Figma, Notion

<Steps>

1. Click the agent → **Settings** → **Model**. The **Connected tools** card lists the tools its role works with, each with a status: **connected · N tools** or **not signed in**.

2. Press **Connect** next to a tool. Your browser opens that service's sign-in; approve it. The login is stored inside this agent's own profile on this computer.

3. Back in the app the badge turns to connected. If the list is empty after a role change, press **Set up role tools** to apply the role again.

</Steps>

## Steps — GitHub (Developer, QA Engineer, DevOps Engineer)

<Steps>

1. On github.com create a **fine-grained personal access token** limited to the repositories this agent may touch: *Contents* and *Pull requests* read/write, plus *Issues* for a QA agent.

2. Click the agent → **Settings** → **Model** → **GitHub** card, paste the token, press **Save**. The app verifies it against GitHub and shows the account it belongs to.

3. The agent clones and works only inside its own workspace folder in its profile — never in your own folders, and never with your own GitHub login.

</Steps>

<Aside type="note">
  Each connection belongs to one agent. Two designers both need Canva connected; removing an agent removes its logins with it.
</Aside>

## Ask your agent

<AgentAsk />

## Limits & safety

- Tokens and OAuth logins never pass through an agent, the tablet or Bakulai's servers.
- Canva through the connector can create designs and fill templates, but cannot edit text inside existing brand templates — that is a Canva Enterprise feature. Posters therefore try an image model first when a key is set; see [Posters and images](/agent/marketing/posters-and-images/).
- GitHub needs the `gh` command installed on this computer for the agent to use the token.

## Troubleshooting

- **"not signed in" straight after connecting** — the browser finished on a different account than expected; press **Connect** again and sign in with the account you want.
- **The Save button rejects the token** — it is not a fine-grained token, or it has no repository access; create it again with the scopes above.

## Related

[Choosing a role](/agent/roles/choosing-a-role/) · [Choose a model and key](/agent/models/choose-a-model-and-key/)