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

# Control what each teammate's agents can read

> Choose which brands, and which finance and payroll connectors, each teammate's AI agents can read through SourceMedium MCP.

Workspace Admins choose, for each teammate, what that person's AI agents can read through SourceMedium MCP: which brands, and whether they can read finance and payroll data.

> [!NOTE]
>
> These settings control this person's agents in SourceMedium MCP. Their direct BigQuery access, Insights and managed apps use separate permissions.

## Change a teammate's data access

1. Open **Team** in your workspace.
2. On the teammate's row, choose **Data access**.
3. Choose their brands and any finance or payroll connectors, check the summary, then choose **Save**.

Opening the panel and ticking boxes changes nothing until you save. The change applies to the teammate's next request, with no reconnect. If someone else saved a change while you had the panel open, SourceMedium shows the current settings so you can make your changes again.

Only Admins can change data access. Admins always have full access, so their own row shows that and cannot be edited.

## Brands

| Choice | What their agents can use |
| - | - |
| **All brands, including future brands** | Every brand in the workspace, including brands you add later. Custom SQL works as usual. |
| **Selected brands** | Only the stores of the brands you pick. Metrics, the data catalog, and live Shopify and Meta tools work for those stores. Custom SQL is unavailable, because a query someone else writes cannot be limited to some stores. With no brand selected, their agents read no store data. |

## Finance and payroll data

QuickBooks, Wave, Bill.com, Brex, Rippling and Gusto are finance and payroll connectors. Their data is not available to a teammate's agents unless you allow it. The panel lists each one your workspace has connected or has ever chosen to sync as raw data, once, however many connections it has.

Allowing one, for example QuickBooks, allows QuickBooks data across the whole workspace, including historical data and future QuickBooks connections. It also shows that connector's connections in the teammate's connection health. Choosing selected brands still limits the tools that teammate can use.

When your workspace holds finance or payroll data that a teammate is not allowed to read, their agents can still use SourceMedium's own reporting models, such as `obt_orders`, and the raw tables they may read. Custom tables, customer notes on tables and table usage are not available to their agents, because SourceMedium cannot tell which connector that content came from.

## What the summary shows

The summary at the bottom of the panel uses the same rules SourceMedium MCP applies after you save:

| Line | Meaning |
| - | - |
| **Brands** | All brands, or the brands selected. |
| **Custom SQL** | Whether their agents can run their own SQL, and whether it is limited to SourceMedium's models. |
| **Raw connector data** | Standard connectors, plus each finance or payroll connector you allowed. Not available with selected brands. |
| **Custom tables and notes** | Your own tables in the warehouse and customer notes on tables. |

## Agencies

A partner agency's agents never read finance or payroll data. While your workspace holds none, an agency keeps its usual access. Once it holds some, an agency's agents are limited to SourceMedium's reporting models. An agency limited to some stores keeps that limit.

## History

Every saved change appears in your workspace's **Activity log** as **Data access**, with the teammate and what changed: their brand choice, brands added or removed, and finance or payroll connectors allowed or removed. Only Admins see these entries.

## If an agent is refused

| What the agent reports | What it means |
| - | - |
| `QUERY_SCOPE_DENIED` from `run_bigquery_sql` | The teammate has selected brands. Ask the agent to use `query_metrics`, which applies their brands automatically. |
| "Your data access allows only the SourceMedium models search\_data\_catalog lists" (or "models and raw tables") | The query or description named a table outside what this teammate may read. Ask the agent to use a table that `search_data_catalog` lists. |
| A finance or payroll table, or connection, is missing | That connector is not allowed for this teammate. An Admin can allow it under **Data access**. |


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