> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adside.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Workspaces and permissions

> What a workspace is, how to choose one, and what each role can do from outside the app.

A **workspace** is one brand or account your team works on: its ad accounts, assets, reports and knowledge. An **organization** holds your workspaces, members and billing.

## Choose a workspace

> [tab] MCP
>
> When you connect, you sign in and, if you belong to several organizations, pick one. Your assistant can then reach every workspace you can open in it.
>
> Ask it to name the workspace, or let it call `list_workspaces`. With a single active workspace, Adside picks that one.

> [tab] CLI
>
> `adside login` asks which workspace commands use by default. In order, a command uses:
>
> 1. the `--workspace-id` flag
> 2. the `ADSIDE_WORKSPACE_ID` environment variable
> 3. the workspace you chose with `adside use`
>
> ```bash theme={null}
> adside use          # list your workspaces
> adside use "Acme"   # choose one, by name or ID
> ```

## What each role can do

Your assistant and the CLI act as you. Adside checks your role on each call, so a change to your role applies to connections you already made.

| Role | Workspaces | Reports, creatives, landing pages, research | Ad platforms | Asset library and audit history | Workspace settings and members |
| - | - | - | - | - | - |
| Owner, Admin | All | Yes | Read and change | Yes | Yes |
| Member | All | Yes | Read and change | Yes | No |
| Guest with Manager access | Those they are invited to | Yes | Read and change | Yes | Yes |
| Guest with Collaborator access | Those they are invited to | Yes | Read and change | Pick and add assets; no audit history | No |

Owners and Admins also manage the organization: members, billing and shared settings.

## One ad account per platform

Each workspace connects to one account on each ad platform, and Adside runs every platform call on that account. You rarely need to pass an account ID. An ID from another account is refused, even if the person who connected the platform can reach it elsewhere.

You connect platforms in the Adside app, under **Integrations**. Adside keeps the platform credentials, so your assistant and the CLI never see them.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.